Click Show only system faults to display only the faults that were caused by a Viewing the Deployed Oracle Mediator Service Components

Monitoring Oracle Mediator Service Components and Engines 15-9

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 monitor the request breakdown statistics of the currently deployed Oracle Mediator service components: 1. Access this page through one of the following options: The Oracle Mediator service engine home page is displayed.

2. Click the Statistics tab.

3. View the 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. ■ 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. 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. Note: Dehydrating of messages means storing the incoming messages in the database for parallel routing rules for processing later by worker threads. 15-10 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite ■ Validation : Message validations by the Oracle Mediator service engine.

15.3 Monitoring Resequenced Messages

You can monitor the resequenced messages from the following pages: ■ Section 15.3.1, Monitoring Resequenced Messages from the Oracle Mediator Service Component Home Page ■ Section 15.3.2, Monitoring Resequenced Messages from the Mediator Instance Dialog

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. Monitoring Oracle Mediator Service Components and Engines 15-11 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. Figure 15–2 Faults Tab 15-12 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite

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 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 ■ Group Is Timed-out ■ Group Is Faulted Due to a System Error 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. Monitoring Oracle Mediator Service Components and Engines 15-13 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 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. 15-14 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite 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: ■ Group ID of the resequenced message ■ Operation performed on the resequenced message Figure 15–7 Figure 15–7 Monitoring Resequenced Messages 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. Monitoring Oracle Mediator Service Components and Engines 15-15 Figure 15–8 Fault Message Details 15-16 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite 16 Managing Oracle Mediator Service Components and Engines 16-1 16 Managing Oracle Mediator Service Components and Engines This chapter describes how to manage Oracle Mediator service components and engines. This chapter includes the following topics: ■ Section 16.1, Viewing the Deployed Oracle Mediator Service Components ■ Section 16.2, Managing Oracle Mediator Faults ■ Section 16.3, Managing Oracle Mediator Policies

16.1 Viewing the Deployed Oracle Mediator Service Components

The Deployed Components page of the Oracle Mediator Service Engine home page lets you search for and view the Oracle Mediator service components of a composite application based on criteria you specify. To manage deployed Oracle Mediator service components: 1. Access this page through one of the following options: The Oracle Mediator service engine home page is displayed.

2. Click Deployed Components.

3. View details about all Oracle Mediator service components currently deployed in

SOA composite applications.

4. Use the Search section to search for and display specific deployed Oracle

Mediator service components. 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. 16-2 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite The Deployed Components page provides the following information about deployed components: ■ Name : The name of the component. You can click the component name to access its home page. ■ Composite : The name of the composite application. You can click the composite name to access its home page. ■ Status : The status of the component, whether it is up or down. ■ Total Instances : The number of total instances. ■ Running Instances : The number of running instances. ■ Recoverable Instances : The number of recoverable instances. ■ Non Recoverable Instances : The number of nonrecoverable instances.

16.2 Managing Oracle Mediator Faults

To manage Oracle Mediator faults:

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

The Oracle Mediator service engine home page is displayed.

2. Click Faults.

3. View details about all faults in Oracle Mediator service components. 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. Managing Oracle Mediator Service Components and Engines 16-3

4. Use the Search section to search for and display specific faults in Oracle Mediator

service components. If you do not specify a search criterion, all faults are displayed in the Faults section. Specify a search criterion and click Search to see the updated results. 5. If a fault is marked as recoverable, you can select it and choose a recovery action from the Recovery Actions list. You can also recover multiple faults as a batch. To select multiple faults, press Shift+Click or Control+Click on the rows in the Faults table. Then, select a recovery action from the Recovery Actions list. Note that in this case, only the common actions applicable to all selected faults are available.

6. Click Error Message and then Recover Now.

16-4 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite The Faults page of the Mediator Instance Details page of the specific Oracle Mediator component instance, where the fault occurred, is displayed. This page can also be displayed by clicking the Recovery column of a fault.

7. Select the fault by clicking the message. The details of the fault are displayed in the

lower pane. Managing Oracle Mediator Service Components and Engines 16-5

8. Click Retry or Abort based on your need.

9. To confirm your action, click Yes on the Confirmation dialog as shown in the

following figure: The following Information dialog displays the status of the recovery action. 16-6 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite The Faults page of the Oracle Mediator service engine home page requires the following information about faults to perform a search: ■ Error Message Contains : A complete or partial error message. ■ Fault ID : The automatically generated fault ID that uniquely identifies a fault. ■ Fault Time from : The date at which to begin the search for faults. ■ Fault Time to : The date at which to end the search for faults. ■ Composite Instance ID : The exact ID of the instance in which the SOA composite application fault occurred. ■ Component Instance ID : The exact ID of the component instance. You can customize the display of searched faults by specifying the following options: ■ Show Only Recoverable Faults: Enables you to view only those faults, on which you can perform recovery actions. ■ Fault Type: Type of the fault. A fault can be of the following types: – Business faults: These faults are application-specific faults that are generated when there is a problem with the information being processed. For example, when a social security number is not found in the database. – System faults: These faults are related to system failure issues, such as a database or network being inaccessible. – Oracle Web Services Manager OWSM policy faults: These faults are generated during failure of an attached policy. The Faults page of the Oracle Mediator Service Engine Home page provides the following information about faults: ■ Fault ID: The ID of the fault. This number is automatically generated and uniquely identifies a fault. This column does not automatically display in this table. To display this column, select Columns, then Fault ID from the View menu. The fault ID is also displayed when you click an error message. ■ Error Message: The error messages of faults occurring in the service engine. You can click an error message to display complete information about the fault. Managing Oracle Mediator Service Components and Engines 16-7 ■ Recovery: Identifies if a specific fault is recoverable. If a fault is marked as recoverable, you can select it and choose a recovery action from the Recovery Actions list. ■ Fault Time: The time at which the fault occurred. ■ Composite: The SOA composite application in which the fault occurred. You can click this link to access the composite home page. ■ Component: The Oracle Mediator service component in which the fault occurred. You can click this link to access the component home page. ■ Component Instance ID: The instance ID of the service component in which the fault occurred. ■ Case: Specifies whether the fault is a business fault, a system fault, or an error. ■ Logs: You can click this link to access log files describing the fault.

16.3 Managing Oracle Mediator Policies

Oracle Fusion Middleware uses a policy-based model to manage web services. Policies apply behavioral requirements to the delivery of messages. To manage Oracle Mediator policies: 1. Access this page through one of the following options:

2. Click Policies.

3. View the policies attached to a Oracle Mediator component.

4. Click AttachDetach to attach or detach a policy.

The AttachDetach Policies page is displayed. All the attached policies are displayed in the upper pane and all the policies available to be attached are displayed in the lower pane. 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. Under soa-infra, select a specific SOA composite application. 16-8 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite

5. Click a policy in the lower pane to select it and click Attach to attach it to the

Oracle Mediator component. Click a policy to in the upper pane to select it and click Detach to detach it from the Oracle Mediator component. The Policies page of the Oracle Mediator Component Home page provides the following information about an Oracle Mediator component instance: ■ Policy Name : The name of the policy. ■ Policy Reference Status : The policy status. It can be either enabled or disabled. Disabling a policy temporarily turns it off without detaching it. ■ Category : The category of the policy. It has the following values: Management, Reliable Messaging, MTOM Attachments, Security, and WS-Addressing. ■ Total Violations : The total number of violations since the SOA Infrastructure was restarted. ■ Security Violation : The number of violations in each category. Category can have the following values: Authentication, Authorization, Confidentiality, and Integrity.