Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite
11g Release 1 (11.1.1.4.0)

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

Go to previous page
Previous
Go to next page
Next
View PDF

15 Monitoring Oracle Mediator Service Components and Engines

This chapter describes how to monitor Oracle Mediator service components and engines.

This chapter includes the following topics:

For more information, see the following sections:

15.1 Monitoring Oracle Mediator Service Component Instances and Faults

You can monitor Oracle Mediator service component recent instances and faults. Each service component in a SOA composite application has its own instance ID. These IDs are different from the overall instance ID of the SOA composite application of which each service component is a part.

To monitor Oracle Mediator service component instances and faults:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Home.
    2. Select the Deployed Composites tab.

    3. In the Composite section, select a specific SOA composite application.

    1. Expand soa-infra, and then select a specific SOA composite application.

  2. In the Component Metrics section, select the Oracle Mediator service component.

  3. Click Dashboard.

    Description of med_comp_main.gif follows
    Description of the illustration med_comp_main.gif

    The Dashboard page displays the following information:

    • Recent instances of the Oracle Mediator service component, including the instance ID, the state of the instance (for example, completed successfully or faulted), the start time, the last modification time, the source event or operation that triggered the instance, and logs describing the instance.

    • Recent faults in the Oracle Mediator service component, including the error message, whether you can recover from the fault, the time at which the fault occurred, the instance ID of the service component, the activity in which the fault occurred, and logs describing the fault.

    • Routing statistics for the Oracle Mediator service component, including the number of successfully processed messages, faulted messages, and incoming messages, as well as the average processing times for successful messages and faulted messages.

    • The instance processing rate per minute (or throughput) for the past five minutes, including total throughput, throughput for successful message, and throughput for faulted messages. This appears in graphic format, and you can also view the information as a table.

  4. In the Recent Instances section, perform the following tasks:

    1. In the Instance ID column, click an instance ID to view its instance details, including an audit trail and faults.

    2. In the Logs column, click a log icon to access the Log Messages page with messages specific to that instance.

    3. Click Show Only Running Instances to view only those instances that are in the running state.

    4. Click Show All below the section to access the Instances page of the service component and view all instances of the service component.

  5. In the Recent Faults section, perform the following tasks:

    1. In the Error Message column, click an error message to display complete information about the fault. If the fault is identified as recoverable, click Recover Now to perform fault recovery.

    2. In the Recovery column, click a fault identified as Recoverable to perform fault recovery at the service component instance level.

    3. In the Logs column, click a specific log to access the Log Messages page with filtered messages specific to that instance.

    4. Click Show only system faults to display only the faults that were caused by a system error. System faults are related to system failure issues, such as a database or network being inaccessible.

    5. Click Show All below the section to access the Faults page of the service component and view all component faults.

  6. Expand the Routing Statistics section and select an operation or event in the Select Route Source field.

    View the statistics for the selected operation or event. To view additional information, expand the Route Target section.

    Description of med_rout_stat2.gif follows
    Description of the illustration med_rout_stat2.gif

  7. Expand the Instance Rate per Min (Real-Time Data) section to view a graphical representation of the number of successful, faulted, and incoming (pending) instances of the BPEL process service component over a specific time range.

    Click Table View to display the same information in a tabular format.

    Description of med_inst_rate.gif follows
    Description of the illustration med_inst_rate.gif

For more information, see Section 1.2.3, "Introduction to SOA Composite Application Instances". For information about viewing and searching log files, see Oracle Fusion Middleware Administrator's Guide.

15.1.1 Introductions to the Sections of the Dashboard Page

This section describes the instance information sections of the Dashboard page.

Recent Instances Section

This section provides the following information about the recent Oracle Mediator service component instances:

  • Instance ID: The unique ID of a specific Oracle Mediator service component instance.

  • State: The state of the specific Oracle Mediator service component instance. The possible states are described below.

    • Stale: The composite for which this Oracle Mediator instance was created is undeployed.

    • Terminated by User: The instance was terminated manually through Oracle Enterprise Manager Fusion Middleware Control, or automatically by a fault policy.

    • Faulted: The instance is faulted and cannot be recovered.

    • Completed successfully: Everything is fine with this instance and it ran successfully.

    • Recovery required: The instance is faulted and can be recovered manually through Oracle Enterprise Manager.

      For more information about recovering a fault, see Section 16.2, "Managing Oracle Mediator Faults".

    • Running: One or more routing rules of the Oracle Mediator service component are still running.

  • Start Date: The date when the specific Oracle Mediator service component instance was started.

  • Last Modified Date: The date when the specific Oracle Mediator service component instance was last modified.

  • Source: The operation or event that triggered the Oracle Mediator service component instance.

  • Logs: The location of the log file containing the log messages related to the Oracle Mediator service component instance.

Recent Faults Section

This section provides the following information about the recent faults that occurred while the Oracle Mediator service component was running:

  • Error Message: The detailed error message associated with the faulted instance.

  • Recovery: An indicator of whether the fault is recoverable or not. If a fault is marked as recoverable, you can select it and choose a recovery action from the Recovery Actions list. You can also click Recover for that fault to access more recovery options at the service component instance level.

  • Fault Time: The time when the fault occurred in the Oracle Mediator service component instance.

  • Component Instance ID: The unique ID of the Oracle Mediator service component instance.

  • Case: The routing source case where the fault occurred.

  • Logs: The log file containing the log message related to the fault. Click this link to see more details about the fault and potential causes of the fault.

For more details about the information available on the Faults page, see Section 16.2, "Managing Oracle Mediator Faults".

Routing Statistics Section

This section provides the following information about the routing data of a source operation or subscribed event.

  • Number of Successfully Processed Messages: The number of messages successfully processed for the selected route source.

  • Number of Faulted Messages: The number of messages that threw faults for the selected route source.

  • Number of Incoming Messages: The total number of incoming messages for the selected route source.

  • Average Processing Time for Successful Messages: The average time taken to process each successful message for the selected route source.

  • Average Processing Time for Faulted Massages -The average time taken to process each faulted message.

The Route Target subsection in the Routing Statistics section displays statistics of the target routes for the Oracle Mediator service component. This section provides the following information about an Oracle Mediator service component instance:

  • Name: The name of the route target of the Oracle Mediator service component.

  • Error: The number of errors that occurred during routing.

  • Average Processing Time: The average processing time for the instances of the Oracle Mediator service component. This field has two subfields, Success and Failure. The Success subfield shows the average processing time for the instances of the Oracle Mediator service component that were processed successfully. The Failure subfield shows the average processing time for the instances of the specific Oracle Mediator service component that failed to process successfully.

  • Average Invocation Time: The average invocation time for the instances of the Oracle Mediator service component.

Instance Rate Per Min Section

This section provides information about the execution rate of the Oracle Mediator instances per minute. This section displays a graph that shows real-time data for successful, faulted, and incoming instances in the last five minutes.

You can view the instance rate for the last five minutes in tabular form by clicking Table View.

15.1.2 Monitoring Oracle Mediator Instance Information

The Instances page on the Oracle Mediator service component home page lets you search for an Oracle Mediator service component instance and view information about an Oracle Mediator service component instance based on the criteria specified.

To view the instance statistics of an Oracle Mediator service component:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Home.
    2. Select the Deployed Composites tab.

    3. In the Composite section, select a specific SOA composite application.

    1. Expand soa-infra, and then select a specific SOA composite application.

  2. In the Component Metrics section, select the Oracle Mediator service component.

  3. Click Instances.

    Description of med_comphome_inst.gif follows
    Description of the illustration med_comphome_inst.gif

  4. To perform a search, enter criteria into any of the available fields, and then click Search. For the date and time fields, you can click the calendar icon next to the field to select a date or time.

    For information about the fields displayed on the Instances tab, see the Recent Instances Section in Section 15.1.1, "Introductions to the Sections of the Dashboard Page."

15.1.3 Monitoring Oracle Mediator Faults

The Faults page of the Oracle Mediator service component home page lets you search for faults based on the specified criteria, to view information about faulted instances, and to recover or terminate multiple faults.

To view the faults for an Oracle Mediator service component:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Home.
    2. Select the Deployed Composites tab.

    3. In the Composite section, select a specific SOA composite application.

    1. Expand soa-infra, and then select a specific SOA composite application.

  2. In the Component Metrics section, select the Oracle Mediator service component.

  3. Click Faults.

    Description of med_comphome_flt1.gif follows
    Description of the illustration med_comphome_flt1.gif

  4. To perform a search, enter criteria into any of the available fields, and then click Search. For the date and time fields, you can click the calendar icon next to the field to select a date or time.

    For information about the fields displayed on the Faults tab, see the Recent Faults Section in Section 15.1.1, "Introductions to the Sections of the Dashboard Page."

15.1.4 Monitoring Oracle Mediator Routing Statistics

The Routing Statistics section of the Dashboard tab in the Oracle Mediator service component home page displays the routing data of a source operation or subscribed event.

To view the routing statistics of an Oracle Mediator service component:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Home.
    2. Select the Deployed Composites tab.

    3. In the Composite section, select a specific SOA composite application.

    1. Expand soa-infra, and then select a specific SOA composite application.

  2. In the Component Metrics section, select the Oracle Mediator service component.

  3. Click Dashboard.

  4. In the Routing Statistics section, select a routing source from the Select Route Source list.

    Description of med_rout_stats.gif follows
    Description of the illustration med_rout_stats.gif

  5. Expand the Route Target table.

    Description of med_rout_stat2.gif follows
    Description of the illustration med_rout_stat2.gif

  6. View the routing statistics for all targets in the Route Target table.

    For information about the fields displayed in the Routing Statistics section, see the Routing Statistics Section in Section 15.1.1, "Introductions to the Sections of the Dashboard Page.".

15.2 Monitoring Oracle Mediator Service Engine Instances and Faults

You can assess the efficiency level of the Oracle Mediator service engine by monitoring the request breakdown statistics.

15.2.1 Monitoring Request Breakdown Statistics

To view the request breakdown statistics of the currently deployed Oracle Mediator service components:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Service Engines > Mediator.
    1. Right-click soa-infra.
    2. Select Service Engines > Mediator.


    The Oracle Mediator service engine home page is displayed.

  2. Click the Statistics tab.

  3. View the request breakdown statistics.

    Description of med_srveng_stat.gif follows
    Description of the illustration med_srveng_stat.gif

    The Request Breakdown section provides information about the count and the average time taken for processing the following actions:

    • Invoke One Way: One-way invocations from the Oracle Mediator service engine.

    • Transformation: Transforming messages in the Oracle Mediator service engine.

    • Enqueue: Dehydrating messages for parallel routing rules.

      Note:

      Dehydrating of messages means storing the incoming messages in the database for parallel routing rules for processing later by worker threads.
    • Invoke: Request-response invocations from the Oracle Mediator Service Engine.

    • Publish: Publishing events from the Oracle Mediator service engine.

    • Condition Evaluation: Filtering conditions for evaluation by the Oracle Mediator service engine.

    • Validation: Message validations by the Oracle Mediator service engine.

15.3 Monitoring Resequenced Messages

You can monitor the resequenced messages from the following pages:

15.3.1 Monitoring Resequenced Messages from the Oracle Mediator Service Component Home Page

You can use the following pages of the Oracle Mediator service component home page for monitoring resequenced messages:

15.3.1.1 Dashboard Page

The Dashboard page of the Oracle Mediator Component home page has one additional column, Group, in the Recent Instances and Recent Faults tables. This field contains the group ID of the resequenced messages. If you click the group ID for a row, then a message is displayed with details about the group. For more information about this message, see Section 15.3.1.4, "Mediator Resequencing Group Dialog." For more information about the Dashboard page, see Section 15.1.2, "Monitoring Oracle Mediator Instance Information."

15.3.1.2 Instances Page

The Instances page of the Oracle Mediator service component home page provides an additional field, Resequencing Group, to search for an Oracle Mediator component instance, while specifying a search criterion. Figure 15-1 provides details. The Instances section that displays information about Oracle Mediator service component instances that match the search criteria provides one additional column, Group. This field contains the group ID of the resequenced messages. If you click the group ID for a row, then a message is displayed with details about the group. For more information about this message, see Section 15.3.1.4, "Mediator Resequencing Group Dialog." For more information about the Instances page, see Section 15.1.2, "Monitoring Oracle Mediator Instance Information."

Figure 15-1 Instances Tab

Description of Figure 15-1 follows
Description of "Figure 15-1 Instances Tab"

15.3.1.3 Faults Page

The Faults page of the Oracle Mediator service component home page provides an additional field, Resequencing Group, to search for an Oracle Mediator service component instance, while specifying a search criterion. Figure 15-2 provides details. The Faults section that displays information about Oracle Mediator component instances that match the search criteria provides one additional column, Group. This field contains the group ID of the resequenced messages. If you click the group ID for a row, then a message is displayed with details of the group. For more information about this message, see Section 15.3.1.4, "Mediator Resequencing Group Dialog." For more information about the Faults page, see Section 16.2, "Managing Oracle Mediator Faults."

15.3.1.4 Mediator Resequencing Group Dialog

This section provides information about the Mediator Resequencing Group dialog. If all the messages in a group are processed without any fault or time out interval, then the Mediator Resequencing Group dialog displays a message indicating that the group is working. Figure 15-3 provides details.

Figure 15-3 Mediator Resequencing Group Dialog

Description of Figure 15-3 follows
Description of "Figure 15-3 Mediator Resequencing Group Dialog"

The Mediator Resequencing Group dialog provides the following details about a group:

  • Specifies whether the group is timed-out or faulted

  • Identifies the blocking message in the group

  • Identifies the next message to be processed after the group is unlocked

  • Shows the time after which the processing of the messages in the group stopped

  • Provides the instruction text to unlock the group

When processing of messages in a group is suspended due to a fault or a timeout, the Mediator Resequencing Group dialog provides information about the suspended group. The processing of messages in a group may be suspended for the following reasons:

Group Is Faulted

A group is in the faulted state when one of its messages throws an error while it is processed, as shown in Figure 15-4. The following information is displayed for a faulted group:

  • The sequence ID of the faulted message

  • The sequence ID of the next message to processed, along with its Oracle Mediator Instance ID

Click Recover Now to access the Faults page of the Mediator Instance Details page to perform single-fault recovery.

Figure 15-4 Group Is Faulted

Description of Figure 15-4 follows
Description of "Figure 15-4 Group Is Faulted"

Group Is Timed-out

A group is in the timed-out state when processing of the group stops while waiting for an expected message, as shown in Figure 15-5. The following information is displayed for a timed-out group:

  • The sequence ID of the last processed message

  • The sequence ID of the next message to be processed, along with its Oracle Mediator Instance ID

Click Skip to unlock the group and start processing the next available instances in the group.

Figure 15-5 Group Is Timed-out

Description of Figure 15-5 follows
Description of "Figure 15-5 Group Is Timed-out"

Group Is Faulted Due to a System Error

A group can be in a faulted state when processing of the group is suspended due to a system error, as shown in Figure 15-6. This state is termed as a special case of a Faulted Group. This group is not timed out and there is no faulted message for the group. The groups in this state can be described as Errored Groups. The following information is displayed for an Errored Group:

  • The sequence ID of the last processed message

  • The sequence ID of the next message to be processed, along with its Oracle Mediator Instance ID

Click Retry to unlock the group and start processing the next instances in the group.

Figure 15-6 Group Is Faulted Due to a System Error

Description of Figure 15-6 follows
Description of "Figure 15-6 Group Is Faulted Due to a System Error"

15.3.2 Monitoring Resequenced Messages from the Mediator Instance Dialog

The Faults page of the Mediator Instance Details dialog provides the following resequencer-specific information:

Instance details window
Description of the illustration med_reseq_inst_det.gif

If you click a fault message, the fault message appears with details about the fault. If you click Retry, then the Oracle Mediator service engine again tries to process the message. If you click Abort, then it terminates the faulted message, then unlocks the group, and resumes processing from the next message in the sequence. Figure 15-8 provides details.

Figure 15-8 Fault Message Details

Description of Figure 15-8 follows
Description of "Figure 15-8 Fault Message Details"