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

# Datadog

> Connect Datadog to give ewake access to your metrics, logs, traces, and monitors.

<Info>
  **What you'll get:** ewake can query your Datadog metrics, logs, traces, APM data, and monitors in real time. This is the primary data source for alert investigation and root cause analysis.
</Info>

***

## Prerequisites

* A Datadog account with **admin or org-level access** to create API and Application keys
* Access to your ewake dashboard

***

## Configuration

<Steps>
  <Step title="Log in to Datadog">
    Navigate to your Datadog instance:

    * **US:** [app.datadoghq.com](https://app.datadoghq.com)
    * **EU:** [app.datadoghq.eu](https://app.datadoghq.eu)

    <Note>
      Use the EU URL if your Datadog account is hosted in Europe. The two regions are separate accounts, using the wrong URL will cause authentication errors at the connection step.
    </Note>
  </Step>

  <Step title="Open Organization Settings">
    Hover over your name in the **bottom left** → click **Organization Settings**.
  </Step>

  <Step title="Create an API Key">
    Go to **API Keys** → click **New Key**. Name it `ewake` and copy the key immediately.

    <Note>
      Copy the key now, you won't be able to see it again after closing the modal.
    </Note>
  </Step>

  <Step title="Create an Application Key">
    <a id="scopes" />

    Go to **Application Keys** → click **New Key**. Name it `ewake`.

    Grant it the following read-only scopes:

    | Scope                     | Why                                                   |
    | ------------------------- | ----------------------------------------------------- |
    | `apm_api_catalog_read`    | Read API catalog metadata                             |
    | `apm_pipelines_read`      | Map observability data flows                          |
    | `apm_read`                | Access APM trace data                                 |
    | `apm_service_ingest_read` | Detect traffic anomalies per service                  |
    | `dashboards_read`         | Surface relevant dashboards during investigation      |
    | `debugger_read`           | Add runtime state context from Live Debugger captures |
    | `error_tracking_read`     | Correlate errors with deploys and alerts              |
    | `events_read`             | Detect deployment and infrastructure events           |
    | `llm_observability_read`  | Investigate issues in LLM-backed services             |
    | `logs_read_archives`      | Query historical logs for past incidents              |
    | `logs_read_data`          | Read log lines as investigation evidence              |
    | `logs_read_index_data`    | Build efficient log queries                           |
    | `metrics_read`            | Read time-series metrics for any service              |
    | `monitors_read`           | Understand what triggered an alert                    |
    | `timeseries_query`        | Build correlation queries across metrics              |

    ```
    apm_api_catalog_read,apm_pipelines_read,apm_read,apm_service_ingest_read,dashboards_read,debugger_read,error_tracking_read,events_read,llm_observability_read,logs_read_archives,logs_read_data,logs_read_index_data,metrics_read,monitors_read,timeseries_query
    ```

    Copy the Application key.
  </Step>

  <Step title="Open the Datadog integration modal in ewake">
    In your ewake dashboard, go to **Integrations** → **Datadog** → click **Configure**.

    <img src="https://mintcdn.com/ewakeai/M1QmRrA-jDM2VkcE/images/integrations/observability/datadog/connect-modal.png?fit=max&auto=format&n=M1QmRrA-jDM2VkcE&q=85&s=74af39918330414a49b9881512df82ba" alt="Connect to Datadog modal in ewake" style={{ maxHeight: "320px", objectFit: "cover", objectPosition: "top", borderRadius: "8px" }} width="1693" height="770" data-path="images/integrations/observability/datadog/connect-modal.png" />
  </Step>

  <Step title="Paste your credentials">
    | Field                | Value                                                               |
    | -------------------- | ------------------------------------------------------------------- |
    | **Datadog Base URL** | `https://api.datadoghq.com` (US) or `https://api.datadoghq.eu` (EU) |
    | **API Key**          | The key created in Step 3                                           |
    | **Application Key**  | The key created in Step 4                                           |
  </Step>

  <Step title="Connect">
    Click **Connect**.

    <Check>
      Datadog is connected. Ewake can now access your observability data.
    </Check>
  </Step>
</Steps>

***

<Card title="What does ewake access in Datadog? →" icon="shield-halved" href="/security/permissions#datadog" horizontal />
