> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rootly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Connect your Datadog account to Rootly using API and Application keys to enable monitor alert ingestion, snapshots, and workflow actions.

## Before You Begin

<Callout icon="triangle-exclamation" color="#FEF3C7">
  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.
</Callout>

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

<Steps>
  <Step title="Open Rootly Integrations">
    Navigate to **Configuration → Integrations** in Rootly, search for **Datadog**, and click **Setup**.

    <Frame>
      <img src="https://mintcdn.com/rootly/7UqSlRjABCmNkM19/images/integrations/datadog/v2/datadog_integration.png?fit=max&auto=format&n=7UqSlRjABCmNkM19&q=85&s=f9f4cf0767ea463748368134396d5b71" alt="Datadog integration card in Rootly's integrations catalog" width="2840" height="1527" data-path="images/integrations/datadog/v2/datadog_integration.png" />
    </Frame>
  </Step>

  <Step title="Create an API Key in Datadog">
    In Datadog, navigate to **Organization Settings → API Keys** and click **+ New Key**.

    <Frame>
      <img src="https://mintcdn.com/rootly/7UqSlRjABCmNkM19/images/integrations/datadog/v2/api_key_add.png?fit=max&auto=format&n=7UqSlRjABCmNkM19&q=85&s=52b27fa509615362690ffbaae787b8f4" alt="Creating a new API key in Datadog organization settings" width="2698" height="1110" data-path="images/integrations/datadog/v2/api_key_add.png" />
    </Frame>

    Name the key (e.g., `Rootly Integration`) and click **Create Key**. Copy the key immediately.

    <Callout icon="triangle-exclamation" color="#FEF3C7">
      The API key value is only shown once at creation. Copy it before closing the dialog — not the Key ID.
    </Callout>
  </Step>

  <Step title="Create an Application Key in Datadog">
    In Datadog, navigate to **Personal Settings → Security → Application Keys** and click **+ New Key**.

    <Frame>
      <img src="https://mintcdn.com/rootly/7UqSlRjABCmNkM19/images/integrations/datadog/v2/application_key.png?fit=max&auto=format&n=7UqSlRjABCmNkM19&q=85&s=16f7d576a3709209e554d03d5dd3d6d0" alt="Creating a new application key in Datadog personal settings" width="2986" height="794" data-path="images/integrations/datadog/v2/application_key.png" />
    </Frame>

    Name the key (e.g., `Rootly Integration`), then edit its scope to include **Read** permission for **Dashboards**.

    <Frame>
      <img src="https://mintcdn.com/rootly/7UqSlRjABCmNkM19/images/integrations/datadog/v2/add_scope.png?fit=max&auto=format&n=7UqSlRjABCmNkM19&q=85&s=c1064b946ec67ca3ec61684264469d2a" alt="Adding dashboard read scope to the Datadog application key" width="1060" height="846" data-path="images/integrations/datadog/v2/add_scope.png" />
    </Frame>

    Copy the application key.

    <Callout icon="circle-info" color="#DBEAFE">
      Rootly only requires `dashboard_read` scope. You can add more permissions if needed for other integrations, but this is the minimum required.
    </Callout>
  </Step>

  <Step title="Enter credentials in Rootly">
    Back in the Rootly setup form, enter:

    * **Host** — your Datadog API hostname. Common values:

      | Region        | Host                    |
      | ------------- | ----------------------- |
      | US1 (default) | `api.datadoghq.com`     |
      | US3           | `api.us3.datadoghq.com` |
      | US5           | `api.us5.datadoghq.com` |
      | EU            | `api.eu.datadoghq.com`  |
      | Gov           | `api.ddog-gov.com`      |

    * **API Key** — paste the API key you created

    * **Application Key** — paste the application key you created

    Click **Connect**.

    <Frame>
      <img src="https://mintcdn.com/rootly/7UqSlRjABCmNkM19/images/integrations/datadog/v2/connect_datadog.png?fit=max&auto=format&n=7UqSlRjABCmNkM19&q=85&s=afc242de044fc6f1a1580bde59914bf9" alt="Datadog integration configuration form in Rootly" width="1787" height="982" data-path="images/integrations/datadog/v2/connect_datadog.png" />
    </Frame>
  </Step>

  <Step title="Confirm connection">
    Datadog will appear as **Connected** in your integrations list.

    <Frame>
      <img src="https://mintcdn.com/rootly/7UqSlRjABCmNkM19/images/integrations/datadog/v2/datadog_is_connected.png?fit=max&auto=format&n=7UqSlRjABCmNkM19&q=85&s=86b7724fab6537996fa073974eb29d0f" alt="Datadog showing as connected in Rootly's integrations list" width="2304" height="1382" data-path="images/integrations/datadog/v2/datadog_is_connected.png" />
    </Frame>
  </Step>
</Steps>

## 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**

<Frame>
  <img src="https://mintcdn.com/rootly/QMD-dNqeYW4BA9dg/images/integrations/common/uninstall-connected.png?fit=max&auto=format&n=QMD-dNqeYW4BA9dg&q=85&s=dbb790e2576c8969bba96bc26c95265f" alt="Click the Connected button to reveal the Disconnect option" width="319" height="188" data-path="images/integrations/common/uninstall-connected.png" />
</Frame>