Datadog Connector
Prerequisites
- A Datadog account (any plan)
- Admin access to create API and application keys
Getting Your Credentials
Datadog requires both an API Key and an Application Key.
Step 1: Create an API Key
- Log into Datadog
- Go to Organization Settings > API Keys
- Click New Key
- Name it (e.g.,
Landed sync) - Copy the key
Step 2: Create an Application Key
- In Datadog, go to Organization Settings > Application Keys
- Click New Key
- Name it (e.g.,
Landed sync) - Copy the key
Note: The Application Key determines the permissions. It inherits the permissions of the user who created it. Use an admin user for full access to all streams.
Step 3: Identify Your Datadog Site
Your Datadog site determines the API endpoint. Common values:
| Site | URL |
|---|---|
datadoghq.com | US1 (default) |
us3.datadoghq.com | US3 |
us5.datadoghq.com | US5 |
datadoghq.eu | EU1 |
ap1.datadoghq.com | AP1 |
Check your browser URL when logged into Datadog to determine your site.
Configuration in Landed
| Field | Value |
|---|---|
| API Key | Your Datadog API key |
| Application Key | Your Datadog application key |
| Datadog Site (optional) | Your Datadog site (default: datadoghq.com) |
Available Streams
| Stream | Description | Sync Mode |
|---|---|---|
monitors | Monitor definitions with query, status, tags | Full refresh |
dashboards | Dashboard metadata (title, layout, author) | Full refresh |
service_level_objectives | SLO definitions with targets and thresholds | Full refresh |
users | User records with roles and status | Full refresh |
roles | Role definitions with permissions | Full refresh |
downtimes | Scheduled downtime records | Full refresh |
incidents | Incident records with status and timeline | Incremental |
logs | Log entries (most recent) | Incremental |
synthetic_tests | Synthetic monitoring test definitions | Full refresh |
Common Issues
| Symptom | Cause | Fix |
|---|---|---|
401 Unauthorized | Invalid API key | Regenerate the API key in Datadog > Organization Settings |
403 Forbidden | Application key lacks permissions | Create the application key with an admin user |
| Wrong data or empty results | Incorrect Datadog site | Set the correct site (e.g., datadoghq.eu for EU accounts) |
Rate limit exceeded | Too many API calls | Landed handles rate limiting automatically |
| Missing incidents | Incidents feature not enabled | Incidents requires Datadog's incident management feature |
Static IPs for Allowlisting
If your Datadog configuration requires IP allowlisting:
- Production:
34.170.185.84,35.192.90.94 - Staging:
34.171.93.34