Skip to main content

Catchpoint

Supported Versions

Type

Authentication Type

SaaS Deployments

Webhook

Org 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

Tag

Description

Attributes

monitor_type

Type 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_type

Reason 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_url

URL being monitored by the Catchpoint test.

test_id

Test ID generated by Catchpoint.

alert_trigger_total

Number of nodes that triggered the alert.

alert_trigger_percentage

Percentage of nodes that triggered the alert.

Install the Integration

Install the integration by following these steps:

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.

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.

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.

In this section: