You can manage all faults occurring within Oracle SOA Suite and view aggregated statistics associated with faults data on the Error Hospital page.

The Error Hospital page provides the following benefits:

• A single location for managing and recovering from all aggregated faults occurring within Oracle SOA Suite (including rejected message recovery and BPEL message recovery). Regardless of the service engine or binding component in which the fault occurred, you manage faults from the Error Hospital page at the following levels:

  • At the SOA Infrastructure level, where all system-wide faults data is aggregated for each business flow instance.

  • At the individual SOA folder level, where only faults data for the business flow instances associated with that specific SOA folder is aggregated.

• Error notification rules configuration for triggering an alert when specific fault criteria are met. For example, you define a rule to trigger an alert if more than 10 errors occur in a 48 hour period.

• Fault filtering and searching capabilities, and the ability to aggregate fault statistics by name, code, type, owner, and other grouping criteria.

• Bulk fault recovery and termination capabilities.

• Details of flow instances associated with the aggregated faults for examining fault trends.

To manage faults in the error hospital:

Access this page through one of the following options:

To access faults in all SOA folders:

To access faults in an individual SOA folder:

The Error Hospital page displays the following details:

• A utility for specifying and saving comprehensive fault search criteria and clicking Search.

  Note:

  When you initially access the Error Hospital page, the Fault Statistics table is empty. You must click Search to populate this table with fault details.

• A Fault Statistics table that provides the fault name, total number of faults, faults requiring recovery, unrecoverable faults, recovered faults, and automatic fault retries. Click a number to search for flow instances associated with the aggregated faults (this takes you to the Flow Instances page). To display a different fault attribute in the first column of the table (such as fault name, code, type, owner, and other grouping criteria), select the Group By list. To display additional columns in the table, select View > Columns.

• Bulk Recovery and Bulk Abort buttons above the Fault Statistics table for performing bulk actions (recovery or abort) on a selected group of similar faults in a single operation.

  
  Description of the illustration soa-error-hospital-main-pag.png

  Note:

  • When you click a faults link or similar links elsewhere in Oracle Enterprise Manager Fusion Middleware Control, you are taken to the Error Hospital page with the fault report data already displayed. For example, when you click the Error Hospital button above the Search Results table in which business flow instances are displayed on the Flow Instances page, you see the aggregated fault statistics reported for those flow instances. In addition, when you click a specific fault state in the graph in the Business Transaction Faults section of the Dashboard page, you are taken to the Error Hospital page with the fault report data of the selected state already displayed.

  • Report data is delimited by the time period for which instances and faults are retrieved. The current delimiter is displayed to the right of the Fault Statistics table title. The default value is 24 hours. You can change this value with the Default Query Duration property on the SOA Infrastructure Common Properties page. For information, see Configuring the Audit Trail, Payload Validation, and Default Query Duration.

You can perform the following fault management tasks:

• Specifying and Saving Fault Search Criteria

• Viewing Aggregated Fault Statistics to Examine Fault Trends

• Performing Bulk Fault Recoveries and Terminations in a Single Operation

• Accessing Faults in the Fault Statistics Table to Perform Single Fault Recovery Operations

You can create error notification rules at the SOA Infrastructure or individual SOA folder level that cause an alert message to be triggered when specific fault criteria are met. For example, you can create a rule that sends an alert if more than 10 errors occur in a 48 hour period. You can configure the alert to be sent to the Fault Alerts section of the Dashboard page described in Viewing Error Notification Alerts. and also to a delivery channel such as an email address.

The error notification rules provide the following benefits:

• An aggregated notification of faults occurring in the system.

• A scheduled-based notification system with a configurable reoccurrence interval. For example, send an alert every 24 hours if rule criteria are met.

• Rule-configured faults and notification channel specifications. When a fault policy is triggered, an email is sent.

You can create fault notification rules at the following levels:

• SOA Infrastructure (for system-wide alerts)

• Individual SOA folder level (for alerts specific to that SOA folder)

The following roles are required for creating, updating, and deleting rules:

• folder_nameApplicationOperator: This role is folder-specific. A user in this folder-specific role has the permissions to manage alerts for that SOA folder.

• MiddlewareOperator

• MiddlewareAdministrator

• SOAAdmin

• SOAOperator

For more information, see Securing Access to SOA Folders.

Note the following details about the display of rules in Oracle Enterprise Manager Fusion Middleware Control:

• Rules created at the SOA Infrastructure (system-wide) level are not displayed in the Error Notification Rules page at the individual SOA folder level.

• Rules created at the individual SOA folder level are not displayed in the Error Notification Rules page at the SOA Infrastructure (system-wide) level.

The Fault Alerts section of the SOA Infrastructure Dashboard page shows all system-wide alerts, including all SOA folders.

To create error notification rules:

1. To receive an alert notification when an error occurs, you must specify the address of the user and the delivery channel to use (email, IM, or SMS). Those tasks are performed on different pages in Oracle Enterprise Manager Fusion Middleware Control,

   For This Delivery Channel...	Perform These Tasks...
   Email	Configure the email addresses on the Workflow Notification Properties page. See Configuring Human Workflow Notification Properties. When complete, click Go to the Messaging Driver page on the Workflow Notification Properties page. Configure the email driver on the User Messaging Service page. See Configuring the Email Driver in Administering Oracle User Messaging Service.
   SMS	Configure the Short Message Peer-to-Peer (SMPP) driver on the User Messaging Service page. See Configuring the SMPP Driver in Administering Oracle User Messaging Service.
   IM	Configure the Extensible Messaging and Presence Protocol (XMPP) on the User Messaging Service page. See Configuring the XMPP Driver in Administering Oracle User Messaging Service.

2. Create an alert at the appropriate level:

   To create error notification rules at the SOA Infrastructure level:

   From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
   Select Error Notification Rules.	Expand SOA. Right-click soa-infra (server_name). Select Error Notification Rules.

   To create error notification rules at the individual SOA folder level:

   From the SOA Folder Menu of a Specific Folder...	From the SOA Folder in the Navigator...
   Select Error Notification Rules.	Right-click a specific SOA folder. Select Error Notification Rules.

   The Error Notification Rules page displays the following details:

   • An Error Notification Rules table for viewing existing rules and details about each rule. Select one or more rules to manage.

   • Links for creating a new rule, creating a new rule from an existing rule, editing a rule, deleting a rule, disabling a rule, and searching for a rule. For more information, click the weblogic icon and select Help > Help for This Page on the Error Notification Rules page.

   
   Description of the illustration soa-rules-notification-main.png

3. Create a new rule in either of the following ways:

   1. Click Create to create a new rule.

   or

   1. Click Create Like to create a new rule from a selected rule.

4. Enter the following information.

   Element	Description
   Name	Enter a name for the rule. Once the new rule is saved, the name cannot be changed. This name is also used for alerts that display on the Dashboard page or which are sent to the notification recipients through a channel such email, SMS, or instant messaging (IM).
   Description	Enter a description for the rule. This description is visible only to administrators. An end user receiving fault notification alerts or viewing alerts on the Dashboard page cannot see this description.
   Schedule Names	Select a predefined schedule. This indicates how often to trigger the scheduler (for example, invoke the scheduler every two minutes). When you select a schedule, the page is refreshed to display the Schedule Description and Frequency fields. You define the schedule names in the Create Schedule page of Oracle Enterprise Manager Fusion Middleware Control. In the Navigator, expand Scheduling Services > ESSAPP or right-click soa-infra (server_name) and select Define Schedules. From the Scheduling Service menu, select Job Requests > Define Schedules. The schedules available for selection in the Schedule Names list are displayed. Click Create to create additional schedules and their execution frequency. Note: While defining a schedule name, ensure that you specify the schedule package name of /oracle/apps/ess/custom/soa. Otherwise, the schedule is created, but is not accessible on the Create or Edit Error Notification Rule page. For more information about using the Oracle Enterprise Scheduler in Oracle Enterprise Manager Fusion Middleware Control, see Administering Oracle Enterprise Scheduler.
   Description.	Displays the schedule description configured on the Create Schedule page.
   Frequency	Displays the schedule frequency configured on the Create Schedule page.

5. Use the IF-THEN table to define the fault notification rule, and click Apply.

   Element	Description
   IF	Define the IF part of the rule. At least one rule condition is mandatory, and cannot be removed. At the SOA Infrastructure level, the mandatory parameter is: Fault Occurred in Last 48 Hours At the individual SOA folder level, the mandatory parameters are: Fault Occurred in Last 48 Hours Folder is folder_name You can edit the default value of 48. Additional rule conditions are optional. Each condition can be added only once. Once a condition is added, it is removed from the list of available conditions. Click the + sign to select rule conditions and assign values. For example, define a rule to trigger an alert if more than 3 faults occur in a 48 hour period in the default SOA folder. IF Fault Occurred in Last 48 Hours and Folder is default and Fault Count is over 3
   THEN	Define the THEN part of the rule. Any number of THEN conditions can be specified. At least one condition is required. (Send Alerts to Dashboard is a valid condition.)
   Send Alerts to Dashboard	Select whether to send an alert to the Fault Alerts section of the Dashboard pages at the SOA Infrastructure or SOA folder levels when the specified fault criteria are met. Use this selection with care to prevent the Dashboard page from overflowing with fault alerts. If you do not select this option, the alert is not displayed on the Dashboard pages.
   Send Message To User Via Delivery_Channel	Specify the address of the user to receive the alert notification and the delivery channel to use (email, IM, or SMS). Click the - sign to remove the users. It is your responsibility to ensure that the user contact information you enter is correct. Note: You must also configure the notification email properties on the Workflow Notification Properties page, as described in Configuring Human Workflow Notification Properties. The delivery channels must also be configured in the Oracle UMS Adapter, which is accessible from the Workflow Notification Properties page by clicking the Go to the Messaging Driver page link. The notification message the alert recipients receive provides the following details. The message content cannot be configured. Fault information. For example: 16 faults occurred in the last 48 hours A link to the Error Hospital page for viewing details about the faults in this notification alert. From the Error Hospital page, you can drill down to see the individual flow instances and further details about the faults. For information about configuring delivery channels in Oracle UMS Adapter, see Administering Oracle User Messaging Service.

   When complete, alert notification rule design looks as follows.

   
   Description of the illustration soa-rules-notification-add.png

   By default, the alert is enabled. You can disable the alert by selecting the alert on the Edit Notification Rules page and clicking Disable. This button acts as a toggle for enabling or disabling one or more selected alerts.

   When error notification rule criteria are met, the alert is triggered and displayed in the Fault Alerts section of the Dashboard page at the SOA Infrastructure or SOA folder level.

   
   Description of the illustration soa-infra-dashboard-alerts.png

   1. Click the link that identifies the number of faults.

      The Error Hospital page is displayed.

   2. Click Search.

      The Fault Statistics table shows details about the faults and the Fault Occurred field of the Time filter of the Report Options section is populated with the same time period specified on the Create Error Notification Rules page.

   3. In the Recoverable column, click the values to perform fault recovery. For more information, see Viewing Error Notification Alerts.

6. When you receive an error notification alert (for example, an email), click the link in the email to access the Error Hospital page.

   16 Faults occurred in the last 48 hours
    Click the link for more details http://link_to_Error_Hospital_Page
   

For information about assigning alerts in the fault management framework in Oracle JDeveloper, see https://docs.oracle.com/pls/topic/lookup?ctx=en/middleware/soa-suite/soa/14.1.2/administer&id=SOASE88066 in Developing SOA Applications with Oracle SOA Suite.

For information about roles, see Securing Access to SOA Folders.

<Error> <oracle.soa.scheduler> <BEA-000000> <ESS-01054 Cannot hold request 5.
Current state is Finished.
oracle.as.scheduler.IllegalStateException: ESS-01054 Cannot hold request 5.
Current state is Finished.
at weblogic.rmi.internal.ServerRequest.sendReceive(ServerRequest.java:258)
at
weblogic.rmi.cluster.ClusterableRemoteRef.invoke(ClusterableRemoteRef.java:472
)
at