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.

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.

    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).

      The failed integration instance is displayed.

    2. In the upper right corner, click hamburger menu > View Activity Stream.

      .

Resubmit Failed Messages

You can manually resubmit failed messages. Resubmitting a failed message starts the integration from the beginning.

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 resubmittals 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.



  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.

  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 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.
  3. 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.