1. Using Integrations in Oracle Integration 3
  2. Monitor Integrations During Runtime
  3. Manage Errors
  4. View Error Messages and the Message Payload in the Activity Stream of Failed Instances

View Error Messages and the Message Payload in the Activity Stream of Failed Instances

You can view error messages and the message payload in the activity stream of failed integration instances on the Errors page. You can also download the activity stream logs and the payload of the failed section of an integration instance.

  1. In the navigation pane, click Observability, then Errors.
  2. Perform the following tasks:

Filter the Display of Error Message Details

  1. Click Filter Filter icon to filter the display of errors by the following:
    • Last updated or creation time
    • Project (begin entering a name to display a list from which to select)
    • Integration

      Begin typing an integration name. Do not use copy and paste. The filter is refreshed to display fields for the defined secondary business identifiers.

      You can now begin typing the values of the business identifiers to narrow down the search. This input follows the same rules (for example, for exact matches and phrase matches) as described in Search for Primary and Secondary Business Identifier Values.

    • Error type (all, recoverable, or nonrecoverable)
    • Instance ID
    • Error message
      For example:
      • Enter part of an error message, such as unknown, unauthorized, or endpoint.
      • Enter an exact phrase match of an error message in double quotes, such as "Could not activate endpoint for endpointID"
    • Detailed error message
    • Connection name
    • Integration style (all, application, schedule, or event)
    • Integration state (all, retained, or purged)
    When you enter an integration name, the filter is refreshed to display fields for the defined business identifiers. You can enter variable values with special characters or variable values of multiple words with white space in double quotes (for example, &filename or "file tracking").


    This image shows the Sort by, Time Window with Data Range button and Last button, From, To, Project, Integration, Error Type, Instance ID, Error message, Detailed error message, Connection, Integration style, and Display instances fields.

  2. Click Date Range in the Time Window section.
  3. 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 Instances page and Monitor Integrations page.

View Error Message and Payload Details on the Errors Page

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. You can view error messages on the Errors page or by clicking on a business identifier to view the entire integration flow on the Instance Details page. You can also view the payload details in the activity stream of a failed instance.

  1. Hover over the row of the failed instance.
  2. Click View View icon. The Activity Stream panel opens. The activity stream shows details about the movement of the message through the integration, including where any failures occurred. The date and time according to your user preferences are displayed.


    The activity stream shows a nonrecoverable error message link at the top. Below this, the tracing level is set to production. Three icons appear to the far right. Below the tracing level are entries that show the movement of the message payload through the integration. All are green (successfully processed) except for the last one, which is red (failed processing).

  3. Click Download Logs Download icon at the top of the activity stream to download the activity stream logs for the entire instance. The Oracle Cloud identifier (OCID) value of your service instance is also included in the logs.
  4. Scroll through, expand milestones, and click View Payload View icon to view the payload for the part of the integration flow that failed.


    The activity stream shows a nonrecoverable error message link at the top, which is being clicked. Below this, the tracing level is set to production. Three icons appear to the far right. Below the tracing level are entries that show the movement of the message payload through the integration. The last entry is in error and is selected to show entries for Summary, Detail, and three icons. Summary is selected to show the payload.

    An option is provided in the activity stream for quickly showing all error content only. This option can be especially useful for instances in which a logic action such as a for-each loop or while loop with many iterations has failed. This option enables you to jump quickly to the iteration that failed instead of scrolling through each iteration of the loop to access the errors. Show errors in either of two ways:

    1. Click View Errors View errors icon to view only the errors in the activity stream. This persists the selection of errors in the activity stream across multiple instances until you deselect the button. This button enables you to toggle between showing only errors and showing all content in the activity stream.


      The activity stream shows the instance ID at the top. Below is the error message and tracing level. To the right are the view errors icon, expand icon, and download logs icon.

      or

    2. Click the error in the activity stream banner to jump to that specific error.


      The activity stream shows a nonrecoverable error message link at the top, which is being clicked. Below this, the tracing level is set to production. Three icons appear to the far right. Below the tracing level are entries that show the movement of the message payload through the integration. The clicked error at the top has been highlighted below in the activity stream.

  5. Perform tasks within the failed part of the payload.
    Element Description
    Download Payload Download icon Click to download this part of the payload to your desktop.
    Copy Payload Copy to clipboard icon Click to copy this part of the payload for pasting into a document.
    Toggle Line Numbers Toggle line numbers icon Click to show or hide line numbers in the payload.

    or

  1. Hover over the row of the failed instance.
  2. Click Expand Expand icon to view a summarized version of the error message for easy understanding and a detailed version that describes how to resolve the error.


    This image shows the summarized error message and detailed error message.

View the Flow of the Failed Instance and Payload Errors in the Activity Stream on the Instance Details Page

You can view the flow of the failed instance to identify any trigger, actions, or invokes in error on the Instance Details page. You can also drill into those elements to view specific error messages and payload errors.

  1. Click a specific business identifier of an integration instance in the Primary Identifier column.
    The cursor is hovered over a business identifier in the Name column.

    The integration flow of the failed instance and Activity Stream panel are displayed.

  2. Scroll through the flow to find the trigger, action, or invoke in error.
  3. Click the element, then click Actions Actions icon and select View Error.


    This image shows a for each action that includes a map action and an integration action. The Actions menu of the integration action is selected to show the View, View Child Instance, View Error (which is being selected), and Activity Stream options.

    The Activity Stream panel opens to the specific section at which the error occurred. For this example, the error occurred in an integration action (parent integration calling a child integration) of a parallel for-each action. All five of the iterations of the parallel for-each are displayed for viewing in the activity stream.


    The image shows the Activity Stream panel. A download icon appears to the right. Below is the activity stream of milestones in the integration flow. A parallel for each is in error. It has been expanded to show additional details.

  4. Scroll through and view the errors.
  5. Click Activity Stream Activity stream icon to close the activity stream. This link operates as a toggle for closing or opening the activity stream.
  6. Click the failed trigger, action, or invoke again, then click Actions Actions icon and select Activity Stream.

    This also opens the Activity Stream panel to the specific section at which the error occurred.


    The integration flow appears on the left. The integration action in error is shown in red. The Actions menu for the integration element in error has been selected to show the exact section of the activity stream where the error occurred.

  7. Scroll through the payload and expand the sections in error to view specific details.
  8. Click View Payload View icon to view the payload of the section in error.


    The error in the activity stream section is expanded to show the error. The Summary, Detail, download payload, copy payload, and toggle row number buttons are shown above the error.

  9. Perform other tasks within this section.
    Element Description
    Summary Click to view a summary of payload details. This action also highlights the section of the integration flow in error.
    Details Click to view more specific payload details. This action also highlights the section of the integration flow in error.
    Download Payload Download icon Click to download this part of the payload to your desktop.
    Copy Payload Copy to clipboard icon Click to copy this part of the payload for pasting into a document.
    Toggle Line Numbers Toggle line numbers icon Click to show or hide line numbers in the payload.
  10. Click Activity Stream The activity stream icon to close the activity stream.