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:

Section 15.1, "Monitoring Oracle Mediator Service Component Instances and Faults"
Section 15.2, "Monitoring Oracle Mediator Service Engine Instances and Faults"

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:

Access the component page through one of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Select Home. Select the Deployed Composites tab. In the Composite section, select a specific SOA composite application.	Expand soa-infra, and then select a specific SOA composite application.

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

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 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.
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 component.
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 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 fault 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.
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 the illustration med_rout_stat2.gif
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 the illustration med_inst_rate.gif

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

15.1.1 About the Sections in the Dashboard Tab

This section describes the instance information sections in the Dashboard tab.

Recent Instances

The Recent Instances section provides the following information about the recent Oracle Mediator component instances:

Instance ID - The unique ID of a specific Oracle Mediator component instance.
State - The state of the specific Oracle Mediator 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 aborted manually through Enterprise Manager, 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, refer to Section 16.2, "Managing Oracle Mediator Faults".
- Running - One or more routing rules of the Oracle Mediator component are still running.
Start Date - The date when the specific Oracle Mediator component instance was started.
Last Modified Date - The date when the specific Oracle Mediator component instance was last modified.
Source - The operation or event that triggered the Oracle Mediator component instance.
Logs - The location of the log file containing the log messages related to the Oracle Mediator component instance.

Recent Faults

The Recent Faults section provides the following information about the recent faults that occurred while the Oracle Mediator 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 component instance level.
Fault Time - The time when the fault occurred in the Oracle Mediator component instance.
Component Instance ID - The unique ID of the Oracle Mediator 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 Faults tab, refer to Section 16.2, "Managing Oracle Mediator Faults".

Routing Statistics

The Routing Statistics 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 table in the Routing Statistics section displays statistics of the target routes for the Oracle Mediator component. This section provides the following information about an Oracle Mediator component instance:

Name - The name of the route target of the Oracle Mediator component.
Error - The number of errors that occurred during routing.
Average Processing Time - The average processing time for the instances of the Oracle Mediator component. This field has two subfields, Success and Failure. The Success subfield shows the average processing time for the instances of the Oracle Mediator component that were processed successfully. The Failure subfield shows the average processing time for the instances of the specific Oracle Mediator component that failed to process successfully.
Average Invocation Time - The average invocation time for the instances of the Oracle Mediator Component.

Instance Rate Per Min Section

The Instance Rate per Min (Realtime Data) 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 last five minutes in tabular form by clicking Table View.

15.1.2 Viewing Oracle Mediator Instance Information

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

To view the instance statistics of an Oracle Mediator component:

Access the component page through one of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Select Home. Select the Deployed Composites tab. In the Composite section, select a specific SOA composite application.	Expand soa-infra, and then select a specific SOA composite application.

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

Description of the illustration med_comphome_inst.gif
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 Recent Instances in "About the Sections in the Dashboard Tab".

15.1.3 Monitoring Oracle Mediator Faults

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

To view the faults for an Oracle Mediator component:

Access the component page through one of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Select Home. Select the Deployed Composites tab. In the Composite section, select a specific SOA composite application.	Expand soa-infra, and then select a specific SOA composite application.

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

Description of the illustration med_comphome_flt1.gif
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 Recent Faults in "About the Sections in the Dashboard Tab".

15.1.4 Monitoring Oracle Mediator Routing Statistics

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

To view the routing statistics of an Oracle Mediator component:

Access the component page through one of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Select Home. Select the Deployed Composites tab. In the Composite section, select a specific SOA composite application.	Expand soa-infra, and then select a specific SOA composite application.

In the Component Metrics section, select the Oracle Mediator service component.
Click Dashboard.
In the Routing Statistics section, select a routing source from the Select Route Source list.

Description of the illustration med_rout_stats.gif
Expand the Route Target table.

Description of the illustration med_rout_stat2.gif
View the routing statistics for all targets in the Route Target table.

For information about the fields displayed in the Routing Statistics section, see Routing Statistics in "About the Sections in the Dashboard Tab".

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 components:

Open the SOA Infrastructure Home page.
From the SOA Infrastructure menu, select Service Engines and then select Mediator.

The Oracle Mediator Service Engine Home page is displayed.
Click the Statistics tab.
View the Request Breakdown statistics.

Description of the illustration med_srveng_stat.gif

15.2.1.1 What You May Need to Know About Request Breakdown Statistics

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 database for parallel routing rules, so that they can be processed 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 - Filter conditions evaluation by the Oracle Mediator Service Engine.
Validation - Message validations by the Oracle Mediator Service Engine.