Datadog Topology

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

Supported Versions

Type

Authentication Type

SaaS

API

Bearer Token

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.

How it Works

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.

Installing 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 Name

Values

Description

action

"install"

This tells BigPanda to start polling with the information provided in the payload

dataDogApiKey

Token

The Datadog API Key

dataDogAppKey

Token

The Datadog Application Key

bigPandaApiToken

Token

The BigPanda Bearer Token

serviceMapEnvironments

Empty list or List of Strings

This 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

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...]
}'

Uninstalling the Integration

Unsubscribe from Integration

  1. Send a one-time unsubscribe request, either using cURL or your favorite request client, to the integration's configuration endpoint.

Parameter Name

Values

Description

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

dataDogApiKey

Token

This is the Datadog API Key

dataDogAppKey

Token

The 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"
}'

Cleanup 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