Integrate Opsgenie with Catchpoint

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

If you're using Opsgenie's Free or Essentials plan or if you’re using Opsgenie with Jira Service Management's Standard plan, you can add this integration from your team dashboard only. The Integrations page under Settings is not available in your plan.

Go to Teams and select your team.
Select Integrations on the left navigation and then select Add integration.

Adding the integration from your team dashboard will make your team the owner of the integration. This means Opsgenie will assign the alerts received through this integration to your team only. Follow the rest of the steps in this section to set up the integration.

Go to Settings > Integrations. Search for Catchpoint and select Add.
Specify who is notified of Catchpoint alerts using the Responders field. Auto-complete suggestions are provided as you type.
Copy the integration API Key to use in the Catchpoint configuration.
Select Save Integration.

Configuration in Catchpoint

2. In the Alerts API section, paste the Opsgenie Catchpoint URL with API key: https://api.opsgenie.com/v1/json/catchpoint?apiKey=YOUR_API_KEY

3. Select Template as Format then click Add New.

4. Select JSON as the format of the template.

5. Copy template file contents from here

6. 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:

JSON

{
    "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. :

Refer to Dynamic Fields for information.

Sample payload sent from Catchpoint

Create Alert payload:

JSON

{
  "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"
}

Was this helpful?

It wasn't accurate

It wasn't clear

It wasn't relevant

Still need help?

The Atlassian Community is here for you.

Ask the Community