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

Monitor Integrations

Use the Oracle Integration dashboard to see how your integrations are performing. The dashboard provides multiple views for you to check your running services.

Topics:

View the Dashboard

You can view information about how your integrations are performing on the Dashboard page. The Dashboard data represents the entire history of the instance, including the number of messages before purging, if it ever occurred.

You can view information about how your integrations are performing. The main page of the integration shows a snapshot of a state of all running integrations.
To view the dashboard:
  1. In the navigation pane, click Home > Monitoring > Integrations > Dashboard.

    The Dashboard page provides the following details:

    • Success rate for messages (the number of messages received and the number of messages with errors since the Oracle Integration instance was provisioned).

    • System health.
    • Agent health (the total number of agents versus the number of agents currently not running).

    • Number of currently active integrations and how they were triggered (for example, by schedules or by events). Click More to access the Monitor Integrations page. See Monitor Integrations.

    • Number of scheduled integrations (running and currently paused).
    • Design-time metrics showing the number of connections, integrations, adapters, and schedules. Click More to access the Design-Time Metrics page. See View the Design-Time Metrics.

    • Graphs showing the hourly and daily history of total, successful, and failed instances. You can place your cursor over the bars in each graph to display the total number of successful messages and failed instances.

    The Dashboard page reflects historical data. The number of all types of instance states (successful, failed, and so on) are collected hourly and displayed on the Dashboard page. Note the following details about the display of failed and recovered instances:
    • Time 1: There are failed instances (shown in the Errors page)
    • Time 2: The instances are then recovered (and are now successful)
    If instance state information is collected between time 1 and 2, the Dashboard page shows some failed instances. The history graphs on the Dashboard page also show the hour/day during which that was the instance state. If the recovery of failed instances occurs before any new data is collected, the Dashboard page shows those instances as successful.

    Description of dashboard_page.png follows
    Description of the illustration dashboard_page.png

  2. From the View menu, select an option:
  3. From the Logs menu, select the type of log to download. This menu is not available if you are using Oracle Integration Generation 2.
    • Diagnostic Logs: If you are having problems with an integration, you can attach the diagnostic logs to a service request for help in debugging the issue.
    • Incident Logs: Click to download the created incident report. See Report Incidents.

View the Activity Stream

You can view the activity stream and message activity of invoked integrations.

Note:

  • During periods of high loads, expect a delay in the display of instance activity data. This is because the data in the log file may not be available. The logging action in orchestrated integrations may take some time to write the data into the log file. The amount of time it takes to write the data to the log file is based on the size of the load.

  • The supported size of the activity stream of an integration is restricted to less than 10 MB. If the activity stream is greater than 10 MB, only 200 records can be viewed.

To view the activity stream:
  1. From the View menu, select Activity Stream.
    The Activity Stream page shows details about the activity stream of invoked integrations.
    Description of activity_stream.png follows
    Description of the illustration activity_stream.png

  2. Click Download to download the activity stream.

View the Design-Time Audit

You can view the design-time audit of all integrations.

To view the design-time audit:
  1. From the View menu, select Design Time Audit.
    The Design Time Audit page shows details about the audit for all invoked integrations.
    Description of design_time_audit.png follows
    Description of the illustration design_time_audit.png

  2. Click Download to download the design-time audit.

View the Design-Time Metrics

You can view the design-time metrics of Oracle Integration, including details about integrations, connections, lookups, packages, agents, and adapters.

To view the design-time metrics of Oracle Integration:
  1. In the navigation pane, click Home > Monitoring > Integrations > Dashboard.
  2. In the Design Time Metrics box, view the number of connections, integrations, adapters, and schedules.
  3. Click the More link.
  4. View details about the following components in Oracle Integration:

    • The state of integrations (draft (under construction), configured, active, and failed).

    • The state of connections (draft, configured, in use, and active).

    • The number of lookups, including in use.

    • The number of packages (developed and prebuilt).

    • The number of connectivity agents.

    • The number of adapters (preinstalled, private, and marketplace).

    • The number of libraries (draft and configured).


    Description of design_time_metrics.png follows
    Description of the illustration design_time_metrics.png

  5. Click the > arrow for Integrations to display details about the number of integrations configured for the following:

    • Application-driven integrations

    • Basic routing integrations

    • Publish to OIC

    • Subscribe to OIC

    • Scheduled orchestrations

  6. Click the > arrow for Integrations again to view how many integrations are using each adapter.
  7. Click the > arrows for Connections and Agents to view more specific details about the configured adapters and configured agents (execution and connectivity).

Monitor Integrations

On the Oracle Integration dashboard, you can see how your running integrations are processing messages, such as how many messages have been received and processed, how many successful messages and errors have occurred, and the overall success rate. Only activated integrations are listed on this page.

To monitor integrations:
  1. In the navigation pane, click Home > Monitoring > Integrations > Integrations.
    A list of running integrations appears, along with processing information about the number of messages received, the number of messages processed, the number of successful messages, and the number of failed messages. Up to 80 activated integrations can be displayed. If the integration you are looking for is not displayed among the 80, use the search facility. For scheduled integrations, navigation links are provided that take you to the Schedule and Future Runs page.
  2. From the Filter icon link, select the time window, integration status, or integration style (pattern) for which to search for integrations.
    You can also specify a custom time range in the Time Window section with which to filter the search for integrations with the From and To buttons at the bottom. This functionality also exists on other monitoring pages such as the Track Instances or Errors page. See Step 3 of Track Business Identifiers in Integrations During Runtime for details.
  3. Click numbers in the Received, Processed, Succeeded, and Aborted columns to access the Track Instances page.
  4. Click numbers in the Errored column to access the Errors page.
  5. For scheduled integrations (identified by Scheduled integration icon), you can perform the following tasks:
    1. Click Submit Now button to submit the integration now.
    2. Click Actions menu to schedule an integration or pause a schedule.

Monitor Agents

You can monitor the agent groups and their associated connectivity agents in Oracle Integration.

To monitor a connectivity agent:

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


    Description of monitor_agents.png follows
    Description of the illustration monitor_agents.png

  2. The Agent Monitoring page shows details such as the time at which the agents were last updated and the connectivity agents associated with the agent groups.

    • If the agent status is green, this indicates that the agent is running and able to process messages.

    • If the agent status is red, you cannot select it in the Select an Agent Group dialog of the Connections page, even though the agent may be up and running. Review the agent-diagnostic0.log file under agenthome/logs for more detailed information about errors.

  3. Expand the agent group name to see the connectivity agent associated with this group.

  4. Click Open Details icon to also show details about the agent group such as creation date and the last startup date of the connectivity agent.

Note:

When you shut down the agent server, several minutes pass before the agent is displayed as down on the Agent Monitoring page (as indicated by a red thunderbolt).