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

• View System Health

• View Design-Time Metrics

• Monitor Integrations

• Monitor Agents

• Monitor Scheduled Integration Runs

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 Integrations, then click the < arrow next to Designer.
2. Click Monitoring, then click Dashboards.

The Dashboard page provides the following details:

• Success rate for messages (acceptable, adverse, or severe). Click the percentage value or wording to access the Errors by Integration page.

• Number of initiated messages in the last three days. Click the value or wording to access the Tracking page.

• Number of failed messages in the last three days. Click the value or wording to access the Error Message Details page.

• Number and percentage of currently used connections. Click the value, percentage, or wording beneath the percentage to access the Errors by Connection page.

• Number and percentage of currently active integrations. Click the value, percentage, or wording beneath the percentage to access the Errors by Integration page.

• Number and percentage of scheduled integrations, including those currently paused. Click the value, percentage, or wording beneath the percentage to access the Integrations page listing all scheduled integrations.

• Activity streams link. Click the link to view the activity stream.

• Download Logs menu. Click the link to show options for downloading the Oracle Integration logs or diagnostics 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.

• Download incidents link. Click to download the created incident report. See Report Incidents.

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

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 ics_monitoring_dashboard1.png

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. On the Dashboard page, click the Activity Stream link.
   The Activity Stream page shows details about the activity stream of invoked integrations.
   
   Description of the illustration ic_activitiy_stream.png
   
2. Click Download to download the activity stream.
3. From the Activity Stream dropdown list, select Integrations to show the message activity (received, processed, successful, and failed) of integrations.

View System Health

You can view information about the system health of Oracle Integration components. As you navigate around Oracle Integration, you receive a system health state that is not older than five minutes. The only exception is the Messaging Service state, which may take longer than five minutes to update.

The state of system health is viewable from the System Health selection of the Integration Health menu on the Dashboards page.

To view system health:

1. In the navigation pane, click Integrations, then click the < arrow next to Designer.
2. Click Monitoring, then click Dashboards.
3. From the Integration Health menu, select System Health.
4. View the current status of system services upon which Oracle Integration relies. A green icon indicates that the service is running as expected. A red icon indicates that errors are occurring that can impact your active integrations. An agent can have three states: available (denoted by a green icon), unavailable (denoted by a red icon), and not configured (denoted by a gray icon). When database space usage reaches the value you specified on the Database Configuration page, the color changes to orange in the RECENT HEALTH CHECKS section.
   
   Description of the illustration dashboard_syst_health.png
5. View the following details about the database:

   • The unquiesced state of the database. This means that users can perform the usual Oracle Integration tasks such as creating and updating integrations, connections, lookups; importing and exporting integrations and packages; activating integrations; and so on. For this example, only 1% of the available database space has been used. When database usage reaches the warning threshold value set on the Database Configuration page, you can receive an email notification if you subscribed to receive system failure notifications. When database space usage reaches the quiesced mode threshold value set on the Database Configuration page, the mode changes to a quiesced state, a red warning sign is displayed, and the color changes to red. When the database enters into a quiesced state, there is a ten minute waiting period after which the runtime does not accept any payloads. You can also receive an email notification if you subscribed to receive system failure notifications when the database enters into a quiesced state. See Send Service Failure Alerts, System Status Reports, and Integration Error Reports by Notification Emails.

     Click anywhere in the DATABASE section to access the Database Configuration page to make changes. See Purge and Retain Data in the Database.

   • The state of the database purge and the data retention period. The current data retention periods for successful and faulted instances are also displayed. Click anywhere in the DATABASE section to access the Database Configuration page to make changes. See Purge and Retain Data in the Database.

   • A link to the purge log in the upper right corner. You can also scroll through a list of the latest purge actions.

   • Process data is also reflected in these database space usage values. You can archive and purge Process data. See Archiving and Purging Data of Using Processes in Oracle Integration.

6. View the maximum mount usage in the file system. The warning threshold is 90%, at which time you can receive an email notification if you have configured a notification email address. The color changes from green to orange. See Send Service Failure Alerts, System Status Reports, and Integration Error Reports by Notification Emails. When usage reaches 95%, the color changes from orange to red and Oracle Integration enters into a read-only state, as indicated by a message at the top of the Integrations page. During this state, you cannot perform tasks such as the following until you have reduced file system usage below 95%:

   • Activating integrations

   • Importing and exporting integrations and packages

   • Creating or updating any resource (for example, lookups, integrations, connections, and so on)

   • Downloading logs

   1. Click the information icon or anywhere in the FILE SYSTEM section to display the domains on the POD instance server, the mount points, and the disk space usage of each mount point. The maximum usage of any one of the mounts is displayed. For example, if ICS_Data is 30% and ICS_Tmp is 70%, 70% is displayed.
      
      Description of the illustration file_system_det_ext.png
      

      These numbers represent the used space of the mount points, and not the folder usage. A mount point (like a drive) has used space and total space. A folder does not normally have free space.

View Design-Time Metrics

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

To view the design-time metrics of Oracle Integration:

1. In the navigation pane, click Integrations, then click the < arrow next to Designer.
2. Click Monitoring, then click Dashboards.
3. From the Integration Health menu, select Design-Time Metrics.
4. View details about the following components in Oracle Integration:

   • The number of developed and prebuilt packages.

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

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

   • The number of lookups.

   • 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 monitoring_designtime.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

   • 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).
8. From the Actions menu, select Download to download the design-time audit trail.

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 Integrations, then click the < arrow next to Designer.
2. Click Monitoring.
3. In the navigation pane, click 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.
4. From the dropdown list, select the time period or retention period during which to search for integrations.
   You can also specify a custom time range 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, Track Runs, or Errors page. See Step 3 of Track Business Identifiers in Integrations During Runtime for details.
   
   
   Description of the illustration monitor_integrations.png
   
5. From the Integrations dropdown list, select the Activity Stream to view the activity stream for the integrations.

Monitor Agents

You can monitor the agent groups and their associated on-premises agents in Oracle Integration.

To monitor an agent:

1. In the navigation pane of Oracle Integration, click < to the left of Designer.

2. Click Monitoring, then click Agents.

3. The Agent Monitoring page shows details such as the time at which the agents were last updated and the on-premises 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.

4. Click the number above AGENTS or click the agent group name to see the on-premises agent associated with this group.

5. At the far right, click the information icon to display details about the agent group such as creation date and the last startup date of the on-premises 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).

Monitor Scheduled Integration Runs

You can monitor scheduled integration runs on the Track Runs page. You can view the total number of messages (records) processed, the number of successfully processed messages, and the number of failed messages. Scheduled integrations can be those with a defined schedule or those submitted ad-hoc through the Submit Now option.

To monitor scheduled integration runs:

1. Access the Track Runs page in either of two ways:

   1. Access the Track Runs page directory from the navigation pane by clicking Integrations, then clicking the < arrow next to Designer.

   2. Click Monitoring, then click Runs.

      The Track Runs page is displayed.

   or

   1. Access the status of a scheduled integration instance submitted through the Submit Now option by going to the Integrations page.

   2. Find the scheduled integration that you want to run.

   3. From the menu at the far right, select Submit Now.

      If the submittal was successful, the following message is displayed.

      Submit Now request to run integration integration_name (version_number) was submitted successfully with request id number.

   4. Click the ID number.

      The Track Runs page is displayed. If the submitted integration does not appear, click the Refresh icon. Details about the run are displayed.

2. From the dropdown list, select the time period or retention period during which to search for instance runs.

   You can also specify a custom time range 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, Integrations, or Errors page. See Step 3 of Track Business Identifiers in Integrations During Runtime for details.
   
   Description of the illustration track_runs.png
   

3. Click to view the tracking status of the scheduled integration on the Tracking Instances page or click to rerun the scheduled integration.