Skip to main content
The Datadog toolkit connects a Datadog organization to agents and workflows using an API key and Application key and lets you list and search monitors, mute or unmute alerting, manage incidents, query metrics, search logs, inspect hosts, and read dashboards.

​
Prerequisites

  • An active Datadog organization on a supported site: US1, US3, US5, EU1, or AP1.
  • A Datadog API key and Application key — go to Organization Settings → API Keys and Organization Settings → Application Keys in Datadog.
  • Datadog permissions appropriate for the actions you intend to use. Incident Management must be enabled on the account for incident actions.
  • Prefer a dedicated service account and a scoped Application key over a personal administrator’s keys.
Both the API key and the Application key are required for every action. The Application key inherits the creating user’s full Datadog permissions — scope it to the minimum required. Mute Monitor, Unmute Monitor, Create Incident, and Update Incident change live Datadog data immediately. Never expose keys in prompts, chat, tickets, screenshots, or documentation.

​
Setup

1

Create Datadog API and Application keys

In Datadog, go to Organization Settings → API Keys and create or copy an API key. Then go to Organization Settings → Application Keys, create an Application key, and copy it immediately — Datadog may not show it again. Scope the Application key to the minimum permissions needed.
2

Open an agent or workflow

Open an agent and add the Datadog toolkit under Toolkits, or add a Datadog step to a workflow.
3

Create a saved connection

In the Datadog step, choose + New under Select saved connection. Enter a Connection Name, the API Key, the Application Key, and the Datadog Site that matches your organization (US1 is the default). Save the connection.
4

Enable only the tools you need

Start with read-only actions. Enable Mute Monitor, Create Incident, and Update Incident only for approved workflows.
5

Test the connection

Run Validate API Key first to confirm the API key is accepted. Then run List Monitors as a fuller smoke test — this also validates the Application key and site.

​
Available tools

​
Authentication

​
Monitors

​
Incidents

​
Metrics

​
Hosts

​
Logs

​
Dashboards

​
Use cases

  • Summarize monitors in Alert or Warn state before a standup or incident review.
  • Query CPU or latency metrics over the last hour and return the result to a workflow step.
  • Search recent error logs for a service and surface the top messages in chat.
  • Open a Datadog incident from an approved workflow when a threshold is breached.
  • Mute a noisy monitor during an approved maintenance window and unmute it afterward.

​
Troubleshooting