Monitoring Integrations

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

Topics

• Viewing the Dashboard

• Viewing System Health

• Viewing Design-Time Metrics

• Monitoring Integrations

• Monitoring Agents

Viewing the Dashboard

You can view information about how your integrations are performing on the Dashboard page.

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. On the Oracle Integration Cloud Service home page, click Monitoring.

The Dashboard page provides the following details:

• The data starting from the time an instance was created.

• 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 Cloud Service 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 Reporting 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.

Description of the illustration ics_monitoring_dashboard1.png

Viewing the Activity Stream

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

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. From the menu at the far right, 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.

Viewing System Health

You can view information about the system health of Oracle Integration Cloud Service components. As you navigate around Oracle Integration Cloud Service, 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 multiple locations in Oracle Integration Cloud Service:

• From the main banner of pages

• From the Integrations, Connections, and Lookups pages

• From the mapper or expression builder

• From the System Health selection of the Integration Health menu on the Dashboards page.

To view system health:

1. On any page of Oracle Integration Cloud Service or from the Integration page, Connections page, Lookups page, mapper, or expression builder, click the System Health icon in the upper right corner to display the status of system health. Green indicates that the service is running as expected. Red indicates that errors are occurring in the service that can impact your active integrations. Gray indicates that no agents are configured. When database space usage reaches 70%, the color changes from green to orange.
   
   
   Description of the illustration system_health.png
   

   You can also view the status of system health from the Monitoring dashboard.

2. Access the Monitoring dashboard through one of the following methods:
   1. On the Oracle Integration Cloud Service Home page, click the Monitor diagram.
   or
   1. Click in the upper left corner of the page, then select Monitoring > Dashboards.
3. From the Integration Health menu, select System Health.
4. View the current status of system services upon which Oracle Integration Cloud Service 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 70%, 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 or quiesced state of the database. For this example, the database is in an unquiesced state. This means that users can perform the usual Oracle Integration Cloud Service 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 70%, you can receive an email notification if you subscribed to receive system failure notifications. When database space usage reaches 80%, 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 Sending 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 Purging and Retaining Data in the Database

   • The state of the database purge and the data retention period. For this example, the gray color indicates that database purging is not currently running. The current data retention period is also displayed. Click anywhere in the DATABASE section to access the Database Configuration page to make changes. See Purging and Retaining Data in the Database

6. View the maximum mount usage in the file system. The warning threshold is 85%, 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 Sending Service Failure Alerts, System Status Reports, and Integration Error Reports by Notification Emails. When usage reaches 90%, the color changes from orange to red and Oracle Integration Cloud Service 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 90%:

   • 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 STATUS 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 and ICS_Tmp are 73% and ICS_App is 60%, 73% is displayed.
      
      Description of the illustration ics_mount_space.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.

Viewing Design-Time Metrics

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

To view the design-time metrics of Oracle Integration Cloud Service:

1. On the Oracle Integration Cloud Service home page, click the Monitor diagram.
2. From the Integration Health menu, select Design-Time Metrics.
3. View details about the following components in Oracle Integration Cloud Service:

   • 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 connectivity and execution agents.

   
   
   Description of the illustration monitoring_designtime.png
   
4. Click the arrow for Integrations to display details about the number of integrations configured for the following::

   • Performing file transfers

   • Using the Map Data integration type

   • Using undefined integrations

   • Using message exchange pattern (MEP) types

5. Click the arrow for Integrations again to view how many integrations are using each adapter.
6. Click the arrows for Connections and Agents to view more specific details about those components.

Monitoring Integrations

On the Oracle Integration Cloud Service 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. On the Oracle Integration Cloud Service home page , click the Monitoring diagram.
   The Dashboard is displayed.
2. 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.
   
   Description of the illustration sample_incid_int.png
   
3. From the In Retention Period list, select the time period for which to display integration information (for example, one hour, six hours, one day, two days, three days, or since the first activation).
4. From the Integration list, select the Activity Stream to view the activity stream for the integrations.

Monitoring Agents

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

To monitor an agent:

1. On the Oracle Integration Cloud Service home page, click the Monitoring diagram.

2. In the navigation panel on the left, click Agents.

3. The Agent Monitoring page shows details such as the time at which the agent was last updated and the on-premises agents associated with the agent groups.

   Note:

   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.

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).