Catchpoint
Send monitoring events from Catchpoint to BigPanda.
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
Create an API Alert for BigPanda
-
In Catchpoint, go to Settings > API
-
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
- Endpoint URL:
-
Under Format, click Select Template > Add new. A form opens where you can define the template.
-
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}" }
-
Click Save.
-
Click Select Template and select BigPanda.
-
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:
- 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.
- 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
- In Catchpoint, go to Settings, then API.
- Under Alerts API, locate the BigPanda endpoint, and click Delete.
- 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:
- In BigPanda, navigate to the Integrations tab and select the desired integration from the list.
- 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.
Updated 4 months ago