Events generated from integration failures (both inbound and outbound configurations) can be monitored.

  • Alerts are generated when integration failures occur.
  • Metrics are provided to monitor integration failures.
  • Templates are available to create and assign to the integration.

Monitoring integration failures are applicable to the following types of integrations:

  • Monitoring integration
  • Collaboration integration
  • Email Alert
  • Email Incident
  • Custom Integration (Only for client-based APIs)
  • Integration failure details are not captured.
  • Integration failure monitoring is implemented only at the client-level.

Step 1: View metrics

  1. Select a client from the All Clients list.
  2. Go to Setup > Monitor Management > Metrics.
  3. From Collector Type, select Integration.

The following metrics are available for monitoring integration failures:

MetricDescription the metric used to count the email failures.
integration.inbound.failures.countDefines the metric used to count the failures raised during the inbound data flow.
integration.inbound.reqs.throttledDefines the metric used to throttle the inbound requests.
integration.outbound.failures.countDefines the metric used to count the failures raised during the outbound data flow.
integration.outbound.time-outsDefines the metric used to count the time-outs caused during outbound data flow.

Step 2: Create monitor

  1. Select Setup > Monitoring > Monitors and click +.

  2. Enter the following information:

    • Monitor Scope: Partner Monitor or Client Specific Monitor
    • Partner: (auto-populated)
    • Client: select_client
    • Adaptor Type: Integration
    • Name: monitoring_name
    • Description: short-description
    • To add the integration failure metrics, click Add Metrics.
    • Select all the metrics and click Add Metrics.
  3. Click Save.

Step 3: Create template

  1. Go to Monitor Management > Templates and click +.
  2. From the Select Template Scope, select Global Template.
  3. From the Collector Type, select Integration.
  4. Select Monitor as Monitor Type.
  5. Enter Template Name and Description.
  6. In the Monitors section, click +Add.
  7. In the Frequency drop-down list, select the required frequency of polling to monitor selected metrics.
  8. In the Monitor Definition drop-down list, select the monitor created in the earlier step.
  9. Select the Alert checkbox for all parameters.
  10. Select the Warning Operator and define the value for the Warning Threshold.
  11. Select the Critical Operator and define the value for the Critical Threshold.
  12. Click Add. The monitors are added to the template.
  13. Click Save.

Step 4: Assign template to integration

  1. Go to Integrations > Integrations.
  2. Select a client for the selected partner. All the installed integrations for the client are displayed.
  3. Select the integration and click the Monitoring tab to assign the template.
  4. Click +Assign Template. The list of templates are displayed.
  5. Select the template to be assigned to the client and click Assign Templates.
  6. The template gets assigned to the integration.

Step 5: View alerts

  1. Go to Alerts, click Edit Criteria and select the Partner, Client.
  2. Select Alert Type > Monitoring and click Apply. All alerts raised from integration failure for the selected partner and client are displayed.
  3. Click the alert to view the details and click the Alert History tab to view complete details of the alert.

An alert is triggered when there is an integration failure. The alert description includes a timestamp and an error message.

Timestamp format: Day + Month + Date + time (hours,minutes,seconds) +
time zone + year.

Integration failure event error message