1. Create Tokens
In Datadog, create both an API Key and App Key. On each page:- Click + New Key
- Name it
resolveand click Create Key - Click Copy and save the key to use below
App Key Scopes
App Key Scopes
If you use Datadog App Key scopes for granular permissions, ensure you include the minimum requirements:
- APM: apm_api_catalog_read, apm_pipelines_read, apm_read, apm_service_catalog_read
- Dashboards: dashboards_read
- Events: events_read
- Logs: logs_read_data, logs_read_index_data
- Metrics: metrics_read, timeseries_query
- Monitors: monitors_read (add
monitors_downtimeif using Mitigation Actions) - Notebooks: notebooks_read
- RUM: rum_apps_read
- SLOs: slos_read
- Teams: teams_read
- Usage: usage_read
Service Accounts
Service Accounts
If you use datadog service accounts to manage App Keys, create a service account with a role with the permissions listed under “App Key Scopes”.Then, create an App key for that service account.
2. Connect Datadog
Set up the integration either in the Resolve UI or in the Satellite configuration.- Resolve UI
- Satellite
Connect Via Resolve UI
- Open Datadog Integration in Resolve
- Click Add Connection
- Enter a name (ex.
Datadog-Main) - Leave Environments blank to ingest data from all environments, or list specific ones that match your Satellite config
- Paste your API Key and App Key from Datadog
- Enter your site domain (ex.
datadoghq.com) - (Optional) Enable Sensitive Data Redaction
- Turn on the toggle Service Map Enabled
- Click Save
Alert Webhooks
- Open Datadog Integration and click the integration in the table
- Scroll down and click Edit
- In Webhooks click the
+button to create a new token - Name the token Monitors and click Save
- Keep the Configure Webhook Integration page open in a tab
- In a secon tab, open the Datadog Webhooks Integration
- Next to Webhooks click + New
- Copy fields from the Configure Webhook Integration tab (Step 5), click Save
- Open your Datadog Monitors
- For each monitor, click Edit
- In Configure notifications & automations add
@webhook-resolveai
Managing monitors with Terraform? Add
@webhook-resolveai to each monitor’s Message field instead.
