1. Using Integrations in Oracle Integration Generation 2
  2. Monitor Integrations During Runtime
  3. Manage Errors

Manage Errors

You can manage errors from the Errors pages in Oracle Integration. You can resubmit failed messages, discard errors, view message recovery status, view error messages, and view specific error details, including the activity stream, business identifiers and values, and message payload in failed instances.

Topics:

See About Error Management.

View Specific Error Details

You can view specific error details by integration instance.

Error message details can be displayed in two parts: a summarized error message for easy understanding and resolution and, if necessary, a more specific error message if more detailed troubleshooting is required.
To view specific error details:
  1. In the left navigation pane, click Home > Monitoring > Integrations > Errors.
  2. Click Filter icon to filter the display of errors by time window, integration, error type (all, recoverable, nonrecoverable, or recovery job) and instance ID, as needed.
    Time Window, Integration, Error Type, and Instance Id categories
  3. Click Date Range in the Time Window section to specify a custom time range with which to filter the search for errors with the From and To buttons. This functionality also exists on other monitoring pages such as the Track Instances or Monitor Integrations page. See Step 3 of Track Business Identifiers in Integrations During Runtime for details.
  4. View details about a specific error in either of two ways:
    1. Click View icon in the row of the failed instance.
      A summarized version of the error message activity stream for easy understanding and resolution is displayed.
      Description of error_details.png follows
      Description of the illustration error_details.png

    2. If a more detailed description of the error message is required, click Open Details icon.
      Displays the error message and detailed error message

      .
    or
    1. Click the business identifier ID included in the failed instance (for this example, 65475).
      Description of error_identifier.png follows
      Description of the illustration error_identifier.png

      The failed integration instance is displayed.
      Description of error_flow.png follows
      Description of the illustration error_flow.png

    2. In the upper right corner, click hamburger menu > View Activity Stream.
      Description of view_act_stream.png follows
      Description of the illustration view_act_stream.png

      .

Resubmit Failed Messages

You can manually resubmit failed messages. If a local scope has been defined in the integration, resubmission starts at the local scope level. Otherwise, resubmission starts from the beginning of the integration. Oracle Integration does not automatically resubmit failed messages.

All faulted instances in asynchronous flows in Oracle Integration are recoverable and can be resubmitted. Synchronous flows cannot be resubmitted. You can resubmit errors in the following ways:

  • Single failed message resubmissions

  • Bulk failed message resubmissions

Error instances that are resubmitted and successfully resolved are removed from the error list. If an instance is resubmitted and is in progress, a state of In Progress is displayed in the list. During this state, additional resubmits of this error instance are not permitted.

Note:

Do not discard a message that you want to resubmit. A discarded message cannot be resubmitted.

To resubmit failed messages:

  1. In the left navigation pane, click Home > Monitoring > Integrations > Errors.

  2. From the Filters icon link, select the time period or retention period during which to search for integration errors.


    Description of errors_page.png follows
    Description of the illustration errors_page.png

  3. Resubmit errors in either of two ways:

    1. Select the check boxes of errors to resubmit together.

    2. Click Resubmit in the upper right corner.

    or

    1. Go to the row of the specific error to resubmit.

    2. Click Resubmit icon.

    A message is displayed at the top of the page:
    Instance ID "number" is submitted for processing. Click on the refresh button to see if it still appears on the errors list before another resubmission.

Abort Errors

You can abort errors based on the integration in which they occurred. A aborted error message is removed from the Errors page and can be seen in an aborted state on the Track Instances page. You cannot perform any further operations on a aborted message, including recovery. After a certain time period, the error message is permanently deleted from the server.

To abort errors:
  1. In the left navigation pane, click Home > Monitoring > Integrations > Errors.
  2. From the Filters icon link, select the time period or retention period during which to search for integration errors.
    You can also specify a custom time range for which to search for errors.
    Description of errors_page.png follows
    Description of the illustration errors_page.png

  3. Abort errors in either of two ways:
    1. Select the check boxes of individual errors to abort.
    2. Click Abort in the upper right corner.
    or
    1. Go to the row of the specific error to abort.
    2. Click Abort icon.
A message is displayed at the top of the page:
Instance ID "number" is submitted for abort. Click on the refresh button to see if this instance still appears on the errors list before trying to abort again.

View the Status of Message Recovery

You can search for and view the status of failed messages that have been submitted for recovery on the Errors page.

  1. In the left navigation pane, click Home > Monitoring > Integrations > Errors.

  2. Submit a failed message for recovery.

  3. From the dropdown list at the top right, select Error Recovery Jobs.


    List options are Track Errors, Errors by Integration, Errors by Connection, and Error Recovery Jobs.

  4. The Error Recovery Jobs page is displayed for viewing the status of message recovery.

    • Received: Recovery is still in progress.

    • Succeeded: Recovery succeeded.

    • Errored: Recovery failed.

View Errors By Integration and Connection

You can view errors by integration and connection on the Errors page.

  1. In the left navigation pane, click Home > Monitoring > Integrations > Errors.

  2. To view errors by integration, select Errors by Integration from the dropdown list at the top right.
    List options are Track Errors, Errors by Integration, Errors by Connection, and Error Recovery Jobs.

    1. Click Resubmit icon to resubmit errors.

    2. Click Abort icon to abort errors.
  3. To view errors by connection, select Errors by Connection from the dropdown list at the top right.

    1. Click Resubmit icon to resubmit errors.

    2. Click Abort icon to abort errors.

View the Activity Stream of Failed Integration Instances

You can view the activity stream of a failed integration instance. This enables you to see where an integration error occurred in the message flow.

To view the activity stream of a failed integration instance:
  1. In the left navigation pane, click Home > Monitoring > Integrations > Errors.
  2. Click Details icon at the end of the row of a specific failed instance to view the message flow. The activity stream shows details about the movement of the message through the integration, including where any failures occurred. For orchestrated integrations, the message flow through each action (for example, any defined switch action branches) is also shown. The date and time according to your user preferences are displayed.
    The Errors page shows the activity stream drawer on the right. The instance ID is listed at the top. Ascending is selected from the dropdown list. Below this is the stream. Green indicates success. Red indicates if a failure has occurred.

    The functionality available is similar to that on the Track Instances page. See Track Business Identifiers in Integrations During Runtime.
  3. Click the business identifier included in the instance you want to view.
    The instance integration is displayed. The direction in which the error occurred is indicated by the color red.
  4. In the upper right corner, click hamburger menu > View Activity Stream.
    The activity stream shows details about the movement of the message through the integration, including where the failure occurred.

View Business Identifiers in Failed Integration Instances

You can view the business identifiers included in failed integration instances.

To view business identifiers in failed integration instances:
  1. In the left navigation pane, click Home > Monitoring > Integrations > Errors.
  2. Click the business identifier of the failed integration instance.
    Business Identifier of failed instance

    The integration instance is displayed.
  3. Click hamburger icon and select Business Identifiers to display all the defined business identifiers and values in the integration.
    Business Identifiers dialog with Name and Value columns.

See Assign Business Identifiers and Manage Business Identifiers for Tracking Fields in Messages.