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 audit trail, 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 navigation pane, click Integrations, then click the < arrow next to Designer.
  2. Click Monitoring, then click Errors.
  3. Filter the display of errors by integration, connection, or recovery job, as needed.
    List of entries: Track Errors, Errors by Integration, Errors by Connection, and Error Recovery Jobs
  4. From the dropdown list to the right, select the time period or retention period during which to search for integration errors.
    You can also specify a custom time range with which to filter the search for errors with the From and To buttons at the bottom. This functionality also exists on other monitoring pages such as the Track Instances, Track Runs, or Integrations page. See Step 3 of Track Business Identifiers in Integrations During Runtime for details.
  5. View details about a specific error in either of two ways:
    1. Click View Error in the column at the right.
      A summarized version of the error message for easy understanding and resolution is displayed.Description of error_message.png follows
      Description of the illustration error_message.png
    2. If a more detailed description of the error message is required, expand Detail Error Message.
    or
    1. Click the business identifier included in the failed instance.
      Description of error_view_instance.png follows
      Description of the illustration error_view_instance.png
      The failed integration instance is displayed.
      Description of error_instance.png follows
      Description of the illustration error_instance.png
    2. In the upper right corner, click hamburger menu > View Errors.
    3. If a more detailed description of the error message is required, expand Detail Error Message.
      Description of ics_error_by_det_view_err.png follows
      Description of the illustration ics_error_by_det_view_err.png
    4. If you select hamburger menu > View Audit Trail, the error in the context of the audit trail is displayed to assist in identifying where the error occurred in the overall processing.
      Description of error_audit_trail.png follows
      Description of the illustration error_audit_trail.png

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 navigation pane, click Integrations, then click the < arrow next to Designer.

  2. Click Monitoring, then click Errors.

  3. From the dropdown list, select the time period or retention period during which to search for integration errors.


    Description of track_errors.png follows
    Description of the illustration track_errors.png
  4. Resubmit errors in either of two ways:

    1. Click Select All to resubmit all errors or select the check boxes of individual instances to resubmit.

    2. Click Resubmit.

    or

    1. Find the specific integration to resubmit.

    2. Click resubmit icon at the far right.

  5. Click Yes when prompted to confirm.

Discard Errors

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

To discard errors by integration name:
  1. In the navigation pane, click Integrations, then click the < arrow next to Designer.
  2. Click Monitoring, then click Errors.
  3. From the dropdown list to the right, 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 track_errors.png follows
    Description of the illustration track_errors.png
  4. Discard errors in either of two ways:
    1. Click Select All to discard all errors or select the check boxes of individual errors to discard.
    2. Click Discard.
    or
    1. Find the specific error to discard.
    2. Click discard icon at the far right.
  5. Click Yes when prompted to confirm.

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 navigation pane, click Integrations, then click the < arrow next to Designer.

  2. Click Monitoring, then click Errors.

  3. Submit a failed message for recovery.

  4. From the dropdown list at the top left, select Error Recovery Jobs.


    List options are Track Errors, Errors by Integration, Errors by Connection, and Error Recovery Jobs.
  5. In the Search field, enter a partial or complete job ID of the error message recovery process.

  6. View the status of message recovery:
    • Received: Recovery is still in progress.

    • Success: Recovery succeeded.

    • Errors: Recovery failed.

View the Audit Trail of Failed Integration Instances

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

To view the audit trail of a failed integration instance:
  1. In the navigation pane, click Integrations, then click the < arrow next to Designer.
  2. Click Monitoring, then click Errors.
  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 Audit Trail.
    The audit trail 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 navigation pane, click Integrations, then click the < arrow next to Designer.
  2. Click Monitoring, then click Errors.
  3. To search for a specific business identifier, enter the exact business identifier value in the search field, then click Search. For example, if business identifier OrgId has a value of test2, enter test2.
    Any business identifiers with the specified value are displayed.
  4. To view details about the business identifiers included in a failed integration instance, click the business identifier.
    The integration instance is displayed.
  5. Click hamburger icon > Business Identifiers to display all the defined business identifiers and values in the integration.
    Description of error_bus_id.png follows
    Description of the illustration error_bus_id.png

View the Message Payload of a Failed Integration Instance

You can view the message payload of a failed integration instance.

To view the message payload of a failed integration instance:
  1. In the navigation pane, click Integrations, then click the < arrow next to Designer.
  2. Click Monitoring, then click Errors.
  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 Payload.
    The audit trail shows the message payload of the integration instance.
    Description of error_fault_payload.png follows
    Description of the illustration error_fault_payload.png