Catchpoint Integration

Catchpoint provides an adaptive monitoring and analytics platform for cloud infrastructure and web applications. Opsgenie is an alert and notification management solution that is highly complementary to Catchpoint's alerting mechanism.

216

​What does Opsgenie offer to Catchpoint users?

Catchpoint sends alert notifications to Opsgenie API, with detailed information. Opsgenie acts as a dispatcher for these alerts, determines the right people to notify based on on-call schedules– notifies them using email, text messages (SMS), phone calls and iOS & Android push notifications, and escalates alerts until the alert is acknowledged or closed.

Functionality of the integration

  • When an alert is created in Catchpoint, an alert is also created in Opsgenie automatically through the integration.
  • When alert notification level is changed for a Catchpoint test, the alert that created in Opsgenie is closed automatically.

Configuring Opsgenie side of the integration

  1. Please create an Opsgenie account if you haven't done so already.
  2. Go to Catchpoint Integration page.

🚧

For Free and Essentials plans, you can only add the integrations from the Team Dashboards, please use the alternative instructions given below to add this integration.

  1. Specify who is notified of Catchpoint alerts using the Teams field. Auto-complete suggestions are provided as you type.

📘

An alternative for Step 2) and Step 3) is to add the integration from the Team Dashboard of the team which will own the integration. To add an integration directly to a team, navigate to the Team Dashboard and open Integrations tab. Click Add Integration and select the integration that you would like to add.

  1. Copy the integration API Key to use in the Catchpoint configuration.
  2. Click Save Integration.
1249

Configuration in Catchpoint

  1. Login to the Catchpoint Portal and go to Settings -> API.
932
  1. In the Alerts API section, paste the Opsgenie Catchpoint URL with API key: https://api.opsgenie.com/v1/json/catchpoint?apiKey=YOUR_API_KEY
  2. Select Template as Format then click Add New.
  3. Select JSON as the format of the template.
893
  1. Copy template file contents from here
  2. Save the template and save the API configuration.

Now manage your Catchpoint alerts at Opsgenie and leverage its full alerting functionality.

Advanced

Customize Catchpoint alert templates for additional information for Opsgenie.

For example, alertCreateDate field is added to template:

{
    "testName": "${TestName}",
    "testId": "${TestId}",
    "testUrl": "${TestUrl}",
    "alertTypeId": "${AlertTypeId}",
    "productName": "${ProductName}",
    "clientId": "${ClientId}",
    "notificationLevel": "${switch("${notificationLevelId}","0","WARNING","1","CRITICAL","3","OK")}",
    "nodeName":"${nodeDetails("${nodeName}")}",
    "nodeServerAddress":"${nodeDetails("${NodeServerAddress}")}",
    "alertCreateDate":"${alertCreateDateUtc}"
}

Simply, you can use {{_payload.variable_name}} variable for alert properties. E.g. :

854

Refer to Dynamic Fields for information.

Sample payload sent from Catchpoint

Create Alert payload:

{
  "message": "WARNING - Yahoo Test",
  "testName": "Yahoo Test",
  "testId": "81093",
  "testUrl": "http://www.yahoo.com",
  "alertTypeId": "7",
  "productName": "tests",
  "clientId": "24",
  "notificationLevel": "WARNING",
  "nodeName": "New York - Level3",
  "nodeServerAddress": "98.139.180.149",
  "description": "Description"
}

Sample alert

2433