Catchpoint

Send monitoring events from Catchpoint to BigPanda.

Supported VersionsTypeAuthentication Type
SaaS DeploymentsWebhookOrg Bearer Token

The Catchpoint integration allows you to correlate Catchpoint alerts into high-level incidents in BigPanda, making problems with your applications visible alongside critical problems in the rest of your production stack.

The Alerts API feature configuration within Catchpoint allows you to add a BigPanda URL endpoint. This prompts Catchpoint to forward all relevant information to BigPanda. BigPanda then processes and correlates the alert data from Catchpoint to create and maintain up-to-date incidents in BigPanda.

📘

Configuring Alerts In Catchpoint

For Catchpoint to send an alert, the Alerts section must be configured for the Test. BigPanda receives and correlates all alerts that have been configured for Tests in Catchpoint.

Key Features

  • Uses the Catchpoint Alerts API feature to forward alerts to BigPanda.
  • Correlates alerts from Catchpoint Tests to help you understand and respond faster to production issues.

Catchpoint Data Model

BigPanda normalizes alert data from Catchpoint into tags. You can use tag values to filter the incident feed and to define filter conditions for Environments. The primary and secondary properties are also used during the deduplication and correlation processes.

Standard Tags

TagDescriptionAttributes
monitor_typeType of monitor and Catchpoint test name. For example, ssh: my_ssh_test.
The type of monitor is determined by the Catchpoint monitor type ID mapping:
0': IE
2 : Object
3: Emulated
8: Ping
9: Tracert
10: DNS-Traversal
11: Ping-TCP
12: DNS-Exp
13: DNS-Direct
14: Tracert-UDP
15: Port-TCP
16: FTP
17: Data-Push-API
18: Chrome
19: Playback
20: Playback-Mobile
21: SMTP
22: Port-UDP
23: Ping-UDP
24: Streaming
25: API
26: Mobile
27: SFTP
28: SSH
29: Tracert-TCP
Primary Property.
alert_typeReason for the alert, determined by the Catchpoint alert type ID mapping:
2: Byte Length
3: Content Match
4: Host Failure
5: http Header Match
7: Response Time
8: Traffic (RU Only)
9: Page Failure
10: Insight
11: Script Failure
12: Ping
13: Requests
14: Zone
15: Availability
16: Address
Secondary Property.
test_urlURL being monitored by the Catchpoint test.
test_idTest ID generated by Catchpoint.
alert_trigger_totalNumber of nodes that triggered the alert.
alert_trigger_percentagePercentage of nodes that triggered the alert.

Install the Integration

Create an API Alert for BigPanda

  1. In Catchpoint, go to Settings > API

  2. Under Alerts API, add a new endpoint by filling in the fields:

    • Endpoint URL: https://api.bigpanda.io/data/integrations/catchpoint?access_token=<Your access token>&app_key<Your app key>
    • Status: Active
  3. Under Format, click Select Template > Add new. A form opens where you can define the template.

  4. Fill in the form:

    • Name: BigPanda
    • Format: **JSON**
    • Template:
        {
        "notificationLevelId" : "${notificationLevelId}",
        "TestName" : "${TestName}",
        "testId":"${testId}",
        "testUrl":"${testUrl}",
        "monitorTypeId":"${monitorTypeId}",
        "AlertTypeId": "${AlertTypeId}",
        "AlertProcessingTimestampUtcEpoch": "${AlertProcessingTimestampUtcEpoch}",
        "alertTriggerPercentage":"${alertTriggerPercentage}",
        "alertTriggerTotal":"${alertTriggerTotal}"
        }
      
  5. Click Save.

  6. Click Select Template and select BigPanda.

  7. At the bottom of the screen, click Save.

Delete the Integration

Deleting an integration requires that you remove the integration in both the integrated system and BigPanda. We recommend that you first uninstall the integration on the integrated system to prevent traffic from being sent and rejected by BigPanda, since the app key will not exist once you delete the integration in BigPanda.

❗️

Caution During Replacement

When replacing an existing integration with a new tool or system, we recommend configuring the new integration first to ensure no data is lost.

Deactivate Inbound Integration

If you want to stop sending data to BigPanda but don’t want to delete your integration, you can temporarily deactivate it.

To deactivate an inbound integration:

  1. In BigPanda, navigate to the Integrations tab and select the desired integration from the list. This will open integration details on the right side of the window.
  2. At the top of the integration details, click the Active/Inactive toggle next to the application name to change the status of the integration.

In the integrations list, inactive integrations will be marked with a gray bar.

Stop Sending Data to BigPanda

  1. In Catchpoint, go to Settings, then API.
  2. Under Alerts API, locate the BigPanda endpoint, and click Delete.
  3. At the bottom of the page, click Save.

Catchpoint alerts are no longer sent to BigPanda.

Delete the Integration in BigPanda

Take the following steps to delete the integration from BigPanda:

  1. In BigPanda, navigate to the Integrations tab and select the desired integration from the list.
  2. In the integration details on the right of the page, click the trash icon, then confirm you want to delete the integration. The integration will be removed immediately.

👍

️Automatic Alert Resolution for Deleted Integrations

All active alerts from the integration will be resolved after deletion.

❗️

Data Removal

This procedure does not remove any data from the integrated system.