Skip to main content

Datadog

Overview

Connect Superblocks to Datadog to send metrics, logs, events, update notebooks, and more:

  • Send events to Datadog's Event Stream

  • Send custom logs directly to Datadog logs

Setting up Datadog

1. Set up Datadog

Log into your Datadog account, or create a free trial. Create a new API Key within Organization Settings and take note of the key, as well as the URL of your Datadog instance.

info

If you are unable to create an API Key you may need to contact someone with the API Keys Write permission, for example a member of the Datadog Admin Role

2. Create REST API integration

Select REST API from the in-app integrations page and fill out the form with the following configuration:

  • Display Name - Name that will be displayed to users when selecting this integration in Superblocks
  • Base URL - Webhook URL, for example https://api.datadoghq.com/api/v1/ (see note below)
  • Authentication - Set to None as Datadog's authentication is handled by the API Key
  • Headers - Create one named DD-API-KEY with the value of your key from step 1.

info

Base URL notes:

  • Datadog has a number of different regions to choose from and so the Base URL will differ dependent on your chosen region - for example .com or .eu.
  • Datadog's API also has two different versions, v1 and v2, depending on which API features you need, you may need to setup separate REST integrations for API version.
  • If you would like to lock the integration to a specific endpoint feel free to set the Base URL to the full API URL. For example, to only allow users the ability to create events in the US region, set the Base URL to https://api.datadoghq.com/api/v1/events.

3. Set environments

After creating the integration, you can optionally set different settings for your Production and Staging environments. This will allow you (for example) to use a separate account for staging and production.

success

Datadog Connected You can now to send metrics/events etc to Datadog in any Application, Workflow, or Scheduled Job.

Creating Datadog steps

Connect to your Datadog integration from Superblocks by creating steps in Application APIs, Workflows, and Scheduled Jobs.