Datadog Topology

This integration allows you to enrich alerts coming into BigPanda with topology information from Datadog.

Supported VersionsTypeAuthentication Type
SaaSAPIBearer Token

The BigPanda Datadog Topology integration works by first querying the Datadog API to retrieve your topology information. The data is then processed and transformed into a BigPanda enrichment which is automatically uploaded to BigPanda and immediately starts enriching your incoming alerts with topology information from Datadog.

Key Features

  • Enriches alerts in BigPanda with topology information from Datadog
  • Automatically detects enrichment schema from your Datadog topology data.
  • Automatically creates and manages Enrichments in BigPanda.

Install the Integration

Create a Datadog API Token and Datadog Application Key for BigPanda

  1. In Datadog, navigate to Integrations > APIs.
  2. Under API Keys give the token a name such as "BigPanda Topology Integration" then click Create API Key.
  3. Under Application Keys give the token a name such as "BigPanda Topology Integration" then click Create APP Key.
  4. View the newly created API Token and App Key. Copy the generated tokens, saving them for use later in the setup.

Configure the Datadog Integration in BigPanda

  1. Send a one-time install request, either using cURL or your favorite request client to the integration's configuration endpoint.
  2. Make sure that you provide the following parameters in the body:
Parameter NameValuesDescription
action"install"This tells BigPanda to start polling with the information provided in the payload
dataDogApiKeyTokenThe Datadog API Key
dataDogAppKeyTokenThe Datadog Application Key
bigPandaApiTokenTokenThe BigPanda Bearer Token
serviceMapEnvironmentsEmpty list or List of StringsThis contains the list of environments in Datadog from which to poll for topology information. If the list is empty it will not poll any topology data

🚧

Case Sensitive

Make sure the values for serviceMapEnvironments are lower case

This is the install request:

curl --location --request POST 'https://inbound.bigpanda.io/datadog/configure' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "install",
  "dataDogApiKey":    "XXXXXXX",
  "dataDogAppKey":    "XXXXXXX",
  "bigPandaApiToken": "XXXXXXX",
  "serviceMapEnvironments": [ENV1, ENV2...]
}'

Uninstall the Integration

Deleting an integration requires changes to both the integrated system and BigPanda. You must uninstall the integration on the integrated system and then delete the integration from BigPanda.

🚧

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

Stop Sending Data to BigPanda

On the integrated system, disable any settings that send data to BigPanda.

Manually resolve any open alerts sent from the integration to remove the associated incidents from your incident feed. These incidents will not automatically resolve without an ok status from the original sending integration.

  1. Send a one-time unsubscribe request, either using cURL or your favorite request client to the integration's configuration endpoint.
Parameter NameValuesDescription
action"uninstall"This tells BigPanda that we would like to remove the configuration for the provided Datadog API Key and stop polling for topology data
dataDogApiKeyTokenThis is the Datadog API Key
dataDogAppKeyTokenThe Datadog Application Key

This is the uninstall request:

curl --location --request POST 'https://inbound.bigpanda.io/datadog/configure' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "uninstall",
  "dataDogApiKey":    "XXXXXXX",
  "dataDogAppKey":    "XXXXXXX"
}'

Clean Up API Tokens

  1. In Datadog, navigate to Integrations > APIs.
  2. Locate the API token for the BigPanda Topology Integration.
  3. Click the Revoke button to delete the token.
  4. Locate the Application Key token for the BigPanda Topology Integration.
  5. Click the Revoke button to delete the token.

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, click Delete Integration. A support message opens, pre-populated with a request to delete the selected integration.
  3. Press Enter to send the request.
  4. The BigPanda support team will remove the integration from the UI.

This procedure does not remove any data from BigPanda or the integrated system. As needed, remove data from each system before deleting the integration.