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

# Datadog

> Steadwing queries Datadog for infrastructure metrics, monitor states, and application performance data to identify anomalies and bottlenecks during incident analysis.

## What does the Datadog integration do?

Steadwing connects to Datadog to query infrastructure metrics, monitor states, and application performance data from your Datadog account. During root cause analysis, Steadwing pulls relevant metrics to identify anomalies, resource bottlenecks, and performance degradation patterns that correlate with production incidents.

## Why Use Datadog with Steadwing?

<CardGroup cols={2}>
  <Card title="Metrics Analysis" icon="chart-line">
    Analyze infrastructure and application metrics during incidents
  </Card>

  <Card title="Anomaly Detection" icon="triangle-alert">
    Identify unusual metric patterns that indicate root causes
  </Card>

  <Card title="Resource Monitoring" icon="server">
    Track CPU, memory, disk, and network usage during incidents
  </Card>

  <Card title="Monitor Correlation" icon="bell">
    Connect Datadog alerts to incident timing for better context
  </Card>
</CardGroup>

## How do I connect Datadog to Steadwing?

### Step 1: Create Datadog API Keys

#### Generate API Key

1. Log in to your Datadog account
2. Navigate to **Organization Settings** → **API Keys**
   * Direct link: [https://app.datadoghq.com/organization-settings/api-keys](https://app.datadoghq.com/organization-settings/api-keys)
3. Click **+ New Key**
4. Configure the key:
   * **Name:** Steadwing Integration
5. Click **Create Key**
6. Copy the generated API key

#### Generate Application Key

1. In Datadog, go to **Organization Settings** → **Application Keys**
   * Direct link: [https://app.datadoghq.com/organization-settings/application-keys](https://app.datadoghq.com/organization-settings/application-keys)
2. Click **+ New Key**
3. Configure the key:
   * **Name:** Steadwing Integration
4. Click **Create Key**
5. Copy the Application Key ID (not the full key)

<Warning>
  Save your keys immediately! Store them securely as they provide access to your Datadog data.
</Warning>

### Step 2: Identify Your Datadog Region

Determine your Datadog region by checking your Datadog URL:

* `app.datadoghq.com` → **us1**
* `us3.datadoghq.com` → **us3**
* `us5.datadoghq.com` → **us5**
* `app.datadoghq.eu` → **eu**
* `ap1.datadoghq.com` → **ap1**

### Step 3: Connect Datadog in Steadwing

1. Navigate to [Steadwing Settings](https://app.steadwing.com/settings)
2. Find the **Datadog** integration card
3. Click to expand the collapsible form
4. Fill in the required fields:
   * **API Key:** Your Datadog API key
   * **Region:** Your Datadog site (us1, us3, us5, eu, or ap1)
   * **Application Key:** Your Datadog Application Key ID
5. Toggle the switch to **Enable** the integration

## What data does Steadwing pull from Datadog?

### Data Collection

Steadwing queries Datadog for:

* **Infrastructure Metrics** - CPU, memory, disk, network usage
* **Application Metrics** - Request rates, latency, error rates
* **Custom Metrics** - Any custom metrics you've configured
* **Monitor States** - Active alerts and monitor status
* **Event Timeline** - Deployments, configuration changes, alerts

## What permissions does the Datadog integration need?

### Required Permissions

The Datadog API integration requires:

* **metrics\_read** - Read time series metric data
* **monitors\_read** - Read monitor configurations and states

## FAQs

<AccordionGroup>
  <Accordion title="What's the difference between API Key and Application Key?">
    The API Key authenticates your organization, while the Application Key identifies the specific user or service making API calls. Both are required for full Datadog API access.
  </Accordion>

  <Accordion title="How do I find my Datadog region?">
    Check your Datadog URL. For example, if you access Datadog at `us3.datadoghq.com`, your region is `us3`. If you use `app.datadoghq.com`, your region is `us1`.
  </Accordion>

  <Accordion title="Can Steadwing modify Datadog monitors or dashboards?">
    No, Steadwing only has read access. It queries metrics and monitor states but never modifies configurations, dashboards, or data.
  </Accordion>

  <Accordion title="Does Steadwing count against my Datadog API limits?">
    Yes, API calls count toward your Datadog rate limits. Steadwing is optimized to make minimal API calls, typically only during active RCA.
  </Accordion>

  <Accordion title="What happens if my API keys are revoked?">
    The integration will not work. Simply create new API keys and update them in Steadwing Settings to reconnect.
  </Accordion>
</AccordionGroup>

Need additional help? Please reach out to us at [hello@steadwing.com](mailto:hello@steadwing.com)