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

• Monitor Integrations

• Monitor Agents

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 the illustration dashboard_page.png

   
   
2. From the View menu, select an option:
   • Select Activity Stream to view the activity stream and message activity of invoked integrations. See View the Activity Stream.
   • Select Design Time Audit to view the design-time audit of all integrations. See View the Design-Time Audit.
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. The activity stream provides status about the payload as it moves through the integration during runtime, including any failures.

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.

• After activation of an integration, there is a several second delay between when the first instance is created and when the message is processed in the activity stream. This is the expected behavior. See Delay in Message Processing of First Instance after Activation.

• The supported total size of the activity stream is restricted to less than 100 MB.

  The maximum size for payloads inside the activity stream is 512 KB, at which time the payloads are truncated.

  See Activity Stream Logs Being Deleted.

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 the illustration activity_stream1.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 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 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

The Monitor Integrations page enables you to view the message processing status of your running integrations, such as how many messages have been received and processed, how many successful messages and errors have occurred, and how many messages have been aborted. Only activated integrations are listed on this page by default. Using the appropriate filter, you can also view data for inactive integrations.

A Total Instance Count summary is displayed at the top of the page. This section is collapsed by default. Data is not immediately fetched. To fetch and view data, expand the Total Instance Count section and click the Refresh button visible within the section.

This summary shows the count of total available messages in various states present in the tracking store. This summary is different from the metrics shown on the Dashboard page. While the Dashboard page metrics consist of historical data collected since the environment was created, the Monitor Integrations page shows only the current set of messages that have not yet been purged.

To monitor integrations:

1. In the navigation pane, click Home > Monitoring > Integrations > Integrations.
   A list of active integrations appears by default, along with processing information about the number of messages received, the number of messages processed, the number of successful messages, the number of failed messages, and the number of aborted messages. For scheduled integrations, navigation links are provided that take you to the Schedule and Future Runs page.
2. From the 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 by clicking 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.
   
   

   
   Description of the illustration monitor_integrations.png

   
   

   The user who last submitted the schedule of an integration is displayed in the Last Scheduled By column. For non-scheduled integrations such as app driven integrations or basic routing integrations, this column remains empty.

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 ), you can perform the following tasks:
   1. Click to submit the integration now. If you are a user with the ServiceAdministrator role, you can change the user with which to submit the schedule.
   2. Click 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 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 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).