Skip to main content

​
Overview

The Datadog integration enables Steadwing to query metrics, monitors, and infrastructure 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?

Metrics Analysis

Analyze infrastructure and application metrics during incidents

Anomaly Detection

Identify unusual metric patterns that indicate root causes

Resource Monitoring

Track CPU, memory, disk, and network usage during incidents

Monitor Correlation

Connect Datadog alerts to incident timing for better context

​
Setup Instructions

​
Step 1: Create Datadog API Keys

​
Generate API Key

  1. Log in to your Datadog account
  2. Navigate to 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
  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)
Save your keys immediately! Store them securely as they provide access to your Datadog data.

​
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
  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

​
Step 4: Verify Connection

  1. Return to Steadwing Settings
  2. Confirm the Datadog integration shows as Connected
  3. Create a test incident to verify metric data is being pulled correctly

​
How Datadog Integration Works

​
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

​
Root Cause Analysis

When analyzing an incident, Steadwing:
  1. Identifies the incident time window
  2. Queries relevant metrics from Datadog
  3. Detects anomalies and unusual patterns
  4. Correlates metric spikes with incident timing
  5. Compares metrics to historical baselines
  6. Includes metric graphs and insights in the RCA report

​
Configuration

​
Required Permissions

The Datadog API integration requires:
  • metrics_read - Read time series metric data
  • monitors_read - Read monitor configurations and states

​
FAQs

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.
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.
No, Steadwing only has read access. It queries metrics and monitor states but never modifies configurations, dashboards, or data.
Yes, API calls count toward your Datadog rate limits. Steadwing is optimized to make minimal API calls, typically only during active RCA.
The integration will not work. Simply create new API keys and update them in Steadwing Settings to reconnect.
Need additional help? Please reach out to us at [email protected]