Skip to main content

​
Before You Begin

We recommend performing the installation with a service account to ensure the integration does not break if the installing user leaves the company. Ensure you are logged in as an Admin in Rootly.
You will need three pieces of information from Datadog:
  • Host — your Datadog account’s API hostname
  • API Key — authenticates Rootly with your Datadog organization
  • Application Key — grants Rootly permission to read dashboards

​
Set Up the Datadog Integration

1

Open Rootly Integrations

Navigate to Configuration → Integrations in Rootly, search for Datadog, and click Setup.
Datadog integration card in Rootly's integrations catalog
2

Create an API Key in Datadog

In Datadog, navigate to Organization Settings → API Keys and click + New Key.
Creating a new API key in Datadog organization settings
Name the key (e.g., Rootly Integration) and click Create Key. Copy the key immediately.
The API key value is only shown once at creation. Copy it before closing the dialog — not the Key ID.
3

Create an Application Key in Datadog

In Datadog, navigate to Personal Settings → Security → Application Keys and click + New Key.
Creating a new application key in Datadog personal settings
Name the key (e.g., Rootly Integration), then edit its scope to include Read permission for Dashboards.
Adding dashboard read scope to the Datadog application key
Copy the application key.
Rootly only requires dashboard_read scope. You can add more permissions if needed for other integrations, but this is the minimum required.
4

Enter credentials in Rootly

Back in the Rootly setup form, enter:
  • Host — your Datadog API hostname. Common values:
    RegionHost
    US1 (default)api.datadoghq.com
    US3api.us3.datadoghq.com
    US5api.us5.datadoghq.com
    EUapi.eu.datadoghq.com
    Govapi.ddog-gov.com
  • API Key — paste the API key you created
  • Application Key — paste the application key you created
Click Connect.
Datadog integration configuration form in Rootly
5

Confirm connection

Datadog will appear as Connected in your integrations list.
Datadog showing as connected in Rootly's integrations list

​
Uninstall

To remove the Datadog integration:
  1. Go to Configuration → Integrations and find Datadog
  2. Click the Connected button to reveal the disconnect option
  3. Click Delete
Click the Connected button to reveal the Disconnect option