Skip Headers
Oracle® Fusion Middleware Security and Administrator's Guide for Web Services
11g Release 1 (11.1.1.7)

Part Number B32511-08
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

13 Monitoring the Performance of Web Services

This chapter describes how to monitor the performance of a Web service using Fusion Middleware Control. The chapter includes the following sections:

In addition to the monitoring features described in this chapter, see "Analyzing Policy Usage" to analyze how policies are used by one or more Web services.

Overview of Performance Monitoring

Note:

Not all of the monitoring features described in this chapter apply to Java EE Web services.

From the Web Services home page in Fusion Middleware Control, you can do the following:

The Application home page also displays select Web service details if the application includes Web services.

When Are Web Service Statistics Started or Reset?

The statistics described in this chapter are started or reset when any one of the following events occur:

Viewing Web Service Statistics for an Application

In Fusion Middleware Control, the Web Services summary page for an application displays the collective Summary and fault/violation information for all Web services in the application, as shown in Figure 13-1.

The Charts section shows a graphical view of all security faults for a Web service.

To navigate to the Web Service Summary page for a Web service

  1. From the navigator pane, click the plus sign (+) for the Application Deployments folder to expose the applications in the domain, and select the application.

    The Application Deployment home page is displayed.

  2. Using Fusion Middleware Control, click Application Deployment, then click Web Services.

    The Web Services Summary page for this application is displayed.

    The page displays Web service endpoints as well as application-level metrics.

For Oracle Infrastructure Web services, the following Web service-wide statistics are displayed:

Figure 13-1 Web Services Performance Summary and Charts

Description of Figure 13-1 follows
Description of "Figure 13-1 Web Services Performance Summary and Charts"

For WebLogic Java EE Web services, the following Web service-wide statistics are displayed:

Viewing Web Service Statistics for a Server Instance

The server-side Web services page displays statistics for all of the Web services on that server.

To view the Web service statistics for a server

  1. In the navigator pane, expand WebLogic Domain to show the domain for which you want to see the policies and select the domain.

  2. Expand the domain to show the servers in that domain. Select the server for which you want to view the statistics.

  3. Using Fusion Middleware Control, click WebLogic Server, and then Web Services.

  4. The Web services statistics page for the server is displayed, as shown in Figure 13-3.

    Depending on the types of Web services you have deployed, tabs are available for the following Web service types: Java EE, Oracle Infrastructure Web Services, and SOA.

    Figure 13-3 Web Services for a Server

    Description of Figure 13-3 follows
    Description of "Figure 13-3 Web Services for a Server"

Viewing Web Service Statistics for an Individual Web Service

The Web Service Details section of the Web Services Summary page displays statistics on a per-Web service basis, as shown in Figure 13-4. The following statistics are displayed:

Figure 13-4 Web Service-Specific Statistics

Description of Figure 13-4 follows
Description of "Figure 13-4 Web Service-Specific Statistics"

Viewing Operation Statistics for a Web Service Endpoint

To display operation statistics for a particular Web service endpoint:

  1. In the Web Services Details section of the Web Services summary page, select the Web Service Endpoints tab.

  2. Select the endpoint for which you want to display the statistics.

    The Web Service Endpoint page is displayed.

  3. Select the Operations tab if it is not already selected.

    The following statistics are presented for Oracle Infrastructure Web services:

    • Operation Name—Name of the operation.

    • One Way—Flag that specifies whether the operation returns a value to the calling operation.

    • Action—URI of the action.

    • Input Encoding—Encoding style of the input message.

    • Output Encoding—Encoding style of the output message.

    • Invocations Completed—Number of completed requests to this endpoint.

    • Average Invocation Time—Average time for all Web service invocations to be processed.

    • Faults—Total number of faults for this endpoint.

    The following statistics are presented for WebLogic Java EE Web services:

    • Name—Name of the operation.

    • Invocation Count—Number of times that the Web service was invoked.

    • Dispatch Time Average—Average time for all Web service invocations to be processed.

    • Execution Time Average—Average time for all Web service executions.

    • Response Time Average—Average time for all responses generated.

    • Response Count—Total number of responses generated from the Web service invocations.

    • Response Error Count—Total number of errors from responses generated from the Web service invocations.

Viewing Web Service Statistics for Java EE Web Service Clients

To display Web Service statistics for the run-time client instances in a Java EE application:

  1. Navigate to the home page for the Java EE Web service, as described in "Navigating to the Web Services Summary Page for an Application".

  2. Select the Java EE Web Service Clients tab to view the clients in the application.

    Note:

    This tab is available only if the application contains Java EE Web service clients.

  3. Select the Monitoring tab, if it is not already selected to view the statistics for all run-time client instances in the application.

    Note:

    For JAX-WS Web services, the Web services run time creates system-defined client instances within a Web service endpoint that are used to send protocol-specific messages as required by that endpoint. These client instances are named after the Web service endpoint that they serve with the following suffix: -SystemClient. Monitoring information relevant to the system-defined client instances is provided to assist in evaluating the application.

  4. Select the client in the Client column to display Web service statistics for that client.

    The Java EE Web Service Client page is displayed, as shown in Figure 13-5.

    Figure 13-5 Java EE Web Service Client Statistics

    Description of Figure 13-5 follows
    Description of "Figure 13-5 Java EE Web Service Client Statistics"

    The following summary information is presented for the run-time client instance.

    • Application Name—The name of the application with which the client is associated.

    • Module Name—Name of the Java EE module in which the endpoint is running.

    • Web Service Endpoint—Name of the port which the client invokes.

    • Transport Protocol Type—Transport protocol required by the service.

  5. Select the Invocations tab to view the invocation statistics for the client.

    Table 13-1 lists the invocation statistics displayed for the run-time client instance.

    Table 13-1 Invocation Statistics for Java EE Web Service Client

    Element Description

    Errors

     

    Error Count

    Total number of security faults and violations.

    Response Error Count

    Total number of errors from responses generated from invocations of this client instance

    Invocation Statistics

     

    Invocation Count

    Total number of times that operations on service side have been invoked by the client instance in the current measurement period.

    Dispatch Time Average (ms)

    Average dispatch time for the current measurement period.

    Dispatch Time Total (ms)

    Total time for all dispatches of this operation in the current measurement period.

    Execution Time Average (ms)

    Average execution time of this operation.

    Execution Time Total (ms)

    Total time for all executions of this operation

    Response Statistics

     

    Response Count

    Total number of responses generated from invocations of this operation.

    Response Time Average (ms)

    Average response time from the responses generated from invocations of this operation.

    Response Time Total (ms)

    Total time for all responses generated from invocations of this operation.


  6. Select the WebLogic Policy Violations tab to the statistics for policy violations of this client run-time instance.

    lists the policy violations for the client run-time instance.

    Table 13-2 WebLogic Policy Violations for Java EE Web Service Client

    Element Description

    Summary

     

    Total Faults

    Total number of failed requests.

    Policy Faults

    Total number of policy faults.

    Total Security Faults

    Total number of security faults and violations.

    Violations

     

    Authentication Violations

    Total number of authentication violations generated for this port. Only incoming message processing can add to the violation count.

    Confidentiality Violations

    Total number of confidentiality violations generated for this port. Both outgoing and incoming message processing can add to the violation count.

    Integrity Violations

    Total number of integrity violations generated for this port. Both outgoing and incoming message processing can add to the violation count.

    Successes

     

    Authentication Successes

    Total number of authentication successes detected for this port. Only incoming message processing can add to the success count.

    Confidentiality Successes

    Total number of confidentiality successes generated for this port. Both outgoing and incoming message processing can add to the success count.

    Integrity Successes

    Total number of integrity successes generated for this port. Both outgoing and incoming message processing can add to the success count.


Viewing the Security Violations for a Web Service

Follow the procedure below to view security violations for a Web service.

To view the security violations for an Oracle Infrastructure Web service:

  1. Navigate to the Web Services Summary page as described in "Navigating to the Web Services Summary Page for an Application".

  2. In the Charts section of the page, select the Security Violations tab.

    A graphical representation of the authentication, authorization, confidentiality, and integrity faults for all Web services in the application is displayed in the pie chart.

  3. In the Web Service Details section of the page, click on the plus (+) for the Web service to display the Web service endpoints if they are not already displayed.

  4. Click the name of the endpoint to navigate to the Web Service Endpoint page.

  5. Click the Charts tab to see a graphical representation of all faults and all security violations for the endpoint.

  6. Click the OWSM Policies tab.

    Two tables are displayed.

    The Globally Attached Policies table displays the name of the policy and the policy set that references it.

    The Directly Attached Policies table displays the name of the policy and the policy status (whether the policy is enabled or disabled).

    Both tables list the category to which the policy belongs (security, MTOM attachments, reliable messaging, WS-addressing, and management).

    Table 13-3 lists the violation information provided for each type of policy attachment.

    Table 13-3 Policy Violation Information for an Endpoint

    Violation Type Description

    Total Violations

    Total number of faults for this policy.

    Note: Total violations may not be equal to the sum of the security violations shown below (for example, Authentication, Authorization, Confidentiality, and Integrity). Other security violations that do not fall into these major categories and non-security violations are also captured in the total violations count.

    Security Violations

     

    Authentication

    Number of authentication failures since the server was restarted.

    Authorization

    Number of authorization failures since the server was restarted.

    Confidentiality

    Number of message confidentiality failures since the server was restarted.

    Integrity

    Number of message integrity failures since the server was restarted.


To view the security violations for a WebLogic JAX-WS Web service:

  1. Navigate to the Web Services Summary page as described in "Navigating to the Web Services Summary Page for an Application".

  2. In the Web Service Details section of the page, click on the plus (+) for the Web service to display the Web service endpoints if they are not already displayed.

  3. Click the name of the endpoint to navigate to the Web Service Endpoint page.

  4. Do one of the following, depending on the type of policies attached to the endpoint:

    • If Oracle WSM policies are attached to the endpoint, click the OWSM Policies tab.

      A list of the policies that are attached to the endpoint is displayed. For each policy, the table displays the name of the policy, the category of the policy (security, MTOM attachments, reliable messaging, WS-addressing, and management), and the policy status (whether the policy is enabled or disabled). Table 13-3 describes the violation information that is displayed for each Oracle WSM policy attached to the endpoint.

    • If WebLogic policies are attached to the endpoint, click the WebLogic Policy Violations tab.

      This tab shows policy violation details about WebLogic policies attached to a JAX-WS endpoint. Table 13-4 describes the information provided on this page.

      Table 13-4 WebLogic Policy Violation Data

      Element Description

      Summary

       

      Total Faults

      Total number of failed requests.

      Policy Faults

      Number of failed requests because a policy was not successfully executed.

      Total Violations

      Total number of faults for this policy.

      Violations

       

      Authentication Violations

      Number of authentication failures since the server was restarted.

      Confidentiality Violations

      Number of message confidentiality failures since the server was restarted.

      Integrity Violations

      Number of message integrity failures since the server was restarted.

      Successes

       

      Authentication Successes

      Number of authentication successes since the server was restarted.

      Confidentiality Successes

      Number of message confidentiality successes since the server was restarted.

      Integrity Successes

      Number of message integrity successes since the server was restarted.


To view the security violations for a WebLogic JAX-RPC Web service:

  1. Navigate to the Web Services Summary page for the application.

  2. In the Web Service Details section of the page, click on the plus (+) for the Web service to display the Web service endpoints if they are not already displayed.

  3. Click the name of the endpoint to navigate to the Web Service Endpoint page.

  4. Click the WebLogic Policy Violations tab.

    This tab shows policy violation details about WebLogic policies attached to a JAX-RPC endpoint, as shown in Figure 13-6. For a description of the information displayed on this tab, see Table 13-4.

    Figure 13-6 Security Violations for a WebLogic JAX-RPC Web Service Endpoint

    Description of Figure 13-6 follows
    Description of "Figure 13-6 Security Violations for a WebLogic JAX-RPC Web Service Endpoint"