Datadog connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Set up the connector

   Register your Datadog credentials with Scalekit so it can authenticate requests on your behalf. You do this once per environment.

   Dashboard setup steps

   Register your Datadog API credentials with Scalekit so Scalekit can proxy API requests and inject your keys automatically. Datadog uses API key authentication — there is no redirect URI or OAuth flow.

   1. Find your Datadog site

      Datadog hosts accounts on regional sites. You must provide your site when creating a connected account — Scalekit uses it to route API calls to the correct endpoint.

      Site identifier	Region
      datadoghq.com	US1 (default)
      us3.datadoghq.com	US3
      us5.datadoghq.com	US5
      datadoghq.eu	EU1
      ap1.datadoghq.com	AP1
      ddog-gov.com	US1-FED (GovCloud)

      If you are unsure which site your account uses, check the URL when you sign in to Datadog — for example, app.datadoghq.eu means your site is datadoghq.eu. See the Datadog site documentation for details.

   2. Get your Datadog API key and Application key

      • Sign in to Datadog and go to Organization Settings → API Keys.
      • Copy an existing API key or click + New Key to create one dedicated to this integration.

      

      • Go to Organization Settings → Application Keys.
      • Copy an existing Application key or click + New Key to create a dedicated one. Copy the key value immediately — Datadog will not show it again.

      

      Both keys are required

      Datadog requires both an API Key (for authentication) and an Application Key (for authorization to specific actions like reading metrics and managing monitors). Keep both keys in a secure secret store.

   3. Create a connection in Scalekit

      • In Scalekit dashboard, go to AgentKit → Connections → Create Connection. Find Datadog and click Create.

      

      • Note the Connection name — you will use this as connection_name in your code (e.g., datadog).
      • Click Save.

      

   4. Add a connected account

      Connected accounts link a specific user identifier in your system to a set of Datadog credentials. Add them via the dashboard for testing, or via the Scalekit API in production.

      Via dashboard (for testing)

      • Open the connection you created and click the Connected Accounts tab → Add account.
      • Fill in:
        • Your User’s ID — a unique identifier for this user in your system (e.g., user_123)
        • API Key — the Datadog API key from step 2
        • Application Key — the Datadog Application key from step 2
        • Datadog Site — your site identifier from step 1 (e.g., datadoghq.com)
      • Click Create Account.

      

      Via API (for production)

      Node.js

      import { Scalekit } from '@scalekit-sdk/node';
      
      const scalekit = new Scalekit(
        process.env.SCALEKIT_ENV_URL,
        process.env.SCALEKIT_CLIENT_ID,
        process.env.SCALEKIT_CLIENT_SECRET,
      );
      
      // Never hard-code credentials — read from secure storage or user input
      const datadogApiKey = getUserDatadogApiKey();   // retrieve from your secure store
      const datadogAppKey = getUserDatadogAppKey();
      const datadogSite = getUserDatadogSite();       // e.g. 'datadoghq.com'
      
      await scalekit.actions.upsertConnectedAccount({
        connectionName: 'datadog',
        identifier: 'user_123',
        credentials: {
          api_key: datadogApiKey,
          app_key: datadogAppKey,
          dd_site: datadogSite,
        },
      });

      Python

      import os
      from scalekit import ScalekitClient
      
      scalekit_client = ScalekitClient(
          env_url=os.environ["SCALEKIT_ENV_URL"],
          client_id=os.environ["SCALEKIT_CLIENT_ID"],
          client_secret=os.environ["SCALEKIT_CLIENT_SECRET"],
      )
      
      # Never hard-code credentials — read from secure storage or user input
      datadog_api_key = get_user_datadog_api_key()  # retrieve from your secure store
      datadog_app_key = get_user_datadog_app_key()
      datadog_site = get_user_datadog_site()        # e.g. 'datadoghq.com'
      
      scalekit_client.actions.upsert_connected_account(
          connection_name="datadog",
          identifier="user_123",
          credentials={
              "api_key": datadog_api_key,
              "app_key": datadog_app_key,
              "dd_site": datadog_site,
          }
      )

      Production usage tip

      In production, call upsert_connected_account (Python) / upsertConnectedAccount (Node.js) when a user connects their Datadog account — for example, on an integrations settings page in your app.

4. Make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'datadog'
   const identifier = 'user_123'
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'datadog_containers_list',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "datadog"
   identifier = "user_123"
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="datadog_containers_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Get synthetics browser test, monitor, event — Get a specific Datadog Synthetics browser test by public ID
• Create downtime, monitor, host tags — Create a new Datadog downtime to suppress alerts
• Trigger synthetics test — Trigger one or more Datadog Synthetics tests to run immediately
• Delete notebook, synthetics test, dashboard — Delete a specific notebook by its ID
• List processes, log indexes, permissions — List live processes running on your infrastructure
• Update slo, downtime, metric metadata — Update an existing Datadog Service Level Objective

Common workflows

Proxy API call

Node.js

const result = await actions.request({
  connectionName: 'datadog',
  identifier: 'user_123',
  path: '/api/v1/monitor',
  method: 'GET',
});
console.log(result);

Python

result = actions.request(
    connection_name='datadog',
    identifier='user_123',
    path="/api/v1/monitor",
    method="GET"
)
print(result)

No OAuth flow needed

Datadog uses API key auth — unlike OAuth connectors, there is no authorization link or redirect flow. Once you call upsertConnectedAccount (Node.js) / upsert_connected_account (Python), or add an account via the dashboard, your users can make requests immediately.

Create a monitor

Node.js

const monitor = await actions.executeTool({
  connector: 'datadog',
  identifier: 'user_123',
  toolName: 'datadog_monitor_create',
  toolInput: {
    name: 'High CPU Usage',
    type: 'metric alert',
    query: 'avg(last_5m):avg:system.cpu.user{*} > 90',
    message: 'CPU usage is high on {{host.name}}. @slack-alerts',
  },
});
console.log('Monitor created:', monitor.id);

Python

monitor = actions.execute_tool(
    connection_name='datadog',
    identifier='user_123',
    tool_name="datadog_monitor_create",
    tool_input={
        "name": "High CPU Usage",
        "type": "metric alert",
        "query": "avg(last_5m):avg:system.cpu.user{*} > 90",
        "message": "CPU usage is high on {{host.name}}. @slack-alerts",
    },
)
print("Monitor created:", monitor["id"])

Search logs

Node.js

const logs = await actions.executeTool({
  connector: 'datadog',
  identifier: 'user_123',
  toolName: 'datadog_logs_search',
  toolInput: {
    query: 'service:web status:error',
    from: '2024-01-01T00:00:00Z',
    to: '2024-01-02T00:00:00Z',
    limit: 50,
  },
});
console.log('Log count:', logs.data?.length);

Python

logs = actions.execute_tool(
    connection_name='datadog',
    identifier='user_123',
    tool_name="datadog_logs_search",
    tool_input={
        "query": "service:web status:error",
        "from": "2024-01-01T00:00:00Z",
        "to": "2024-01-02T00:00:00Z",
        "limit": 50,
    },
)
print("Log count:", len(logs.get("data", [])))

Query metrics

Node.js

const metrics = await actions.executeTool({
  connector: 'datadog',
  identifier: 'user_123',
  toolName: 'datadog_metrics_query',
  toolInput: {
    query: 'avg:system.cpu.user{*}',
    from: 1704067200,  // Unix timestamp
    to: 1704153600,
  },
});
console.log('Series:', metrics.series);

Python

metrics = actions.execute_tool(
    connection_name='datadog',
    identifier='user_123',
    tool_name="datadog_metrics_query",
    tool_input={
        "query": "avg:system.cpu.user{*}",
        "from": 1704067200,
        "to": 1704153600,
    },
)
print("Series:", metrics.get("series"))

Create an incident

Node.js

const incident = await actions.executeTool({
  connector: 'datadog',
  identifier: 'user_123',
  toolName: 'datadog_incident_create',
  toolInput: {
    title: 'Database connection failures',
    customer_impacted: true,
    severity: 'SEV-2',
  },
});
console.log('Incident ID:', incident.data?.id);

Python

incident = actions.execute_tool(
    connection_name='datadog',
    identifier='user_123',
    tool_name="datadog_incident_create",
    tool_input={
        "title": "Database connection failures",
        "customer_impacted": True,
        "severity": "SEV-2",
    },
)
print("Incident ID:", incident.get("data", {}).get("id"))

Create a scheduled downtime

The start and end fields use ISO 8601 format, not Unix timestamps.

Node.js

const downtime = await actions.executeTool({
  connector: 'datadog',
  identifier: 'user_123',
  toolName: 'datadog_downtime_create',
  toolInput: {
    scope: 'env:production',
    start: '2026-06-01T02:00:00Z',
    end: '2026-06-01T04:00:00Z',
    message: 'Scheduled maintenance window',
  },
});
// Use data.id (UUID), not included[].id (user UUID)
const downtimeId = downtime.data?.id;
console.log('Downtime ID:', downtimeId);

Python

downtime = actions.execute_tool(
    connection_name='datadog',
    identifier='user_123',
    tool_name="datadog_downtime_create",
    tool_input={
        "scope": "env:production",
        "start": "2026-06-01T02:00:00Z",
        "end": "2026-06-01T04:00:00Z",
        "message": "Scheduled maintenance window",
    },
)
# Use data["id"] (UUID), not included[0]["id"] (user UUID)
downtime_id = downtime["data"]["id"]
print("Downtime ID:", downtime_id)

Downtime response includes two IDs

The downtime_create response contains both data.id (the downtime UUID) and included[].id (the creator’s user UUID). Always use data.id for subsequent downtime_get, downtime_update, and downtime_cancel calls.

Create a metric SLO

The query field must be a JSON string containing numerator and denominator metric queries. Pass thresholds as a JSON string too.

Node.js

const slo = await actions.executeTool({
  connector: 'datadog',
  identifier: 'user_123',
  toolName: 'datadog_slo_create',
  toolInput: {
    name: 'API Success Rate',
    type: 'metric',
    query: JSON.stringify({
      numerator: 'sum:requests.success{*}.as_count()',
      denominator: 'sum:requests.total{*}.as_count()',
    }),
    thresholds: JSON.stringify([{ target: 99.5, timeframe: '30d' }]),
  },
});
const sloId = slo.data?.[0]?.id;

Python

import json

slo = actions.execute_tool(
    connection_name='datadog',
    identifier='user_123',
    tool_name="datadog_slo_create",
    tool_input={
        "name": "API Success Rate",
        "type": "metric",
        "query": json.dumps({
            "numerator": "sum:requests.success{*}.as_count()",
            "denominator": "sum:requests.total{*}.as_count()",
        }),
        "thresholds": json.dumps([{"target": 99.5, "timeframe": "30d"}]),
    },
)
slo_id = slo["data"][0]["id"]

Retrieve an event

Datadog event IDs are 64-bit integers that exceed the float64 precision limit. Always use the id_str field from event_create or events_list_v2 — not the numeric id field — to avoid silent precision loss.

Node.js

// Create an event and capture its string ID
const created = await actions.executeTool({
  connector: 'datadog',
  identifier: 'user_123',
  toolName: 'datadog_event_create',
  toolInput: {
    title: 'Deployment completed',
    text: 'v2.3.1 deployed to production',
    date_happened: Math.floor(Date.now() / 1000),
  },
});
const eventId = created.event?.id_str; // use id_str, not id

// Retrieve it
const event = await actions.executeTool({
  connector: 'datadog',
  identifier: 'user_123',
  toolName: 'datadog_event_get',
  toolInput: { event_id: eventId },
});
console.log(event.event?.title);

Python

import time

created = actions.execute_tool(
    connection_name='datadog',
    identifier='user_123',
    tool_name="datadog_event_create",
    tool_input={
        "title": "Deployment completed",
        "text": "v2.3.1 deployed to production",
        "date_happened": int(time.time()),
    },
)
event_id = created["event"]["id_str"]  # use id_str, not id

event = actions.execute_tool(
    connection_name='datadog',
    identifier='user_123',
    tool_name="datadog_event_get",
    tool_input={"event_id": event_id},
)
print(event["event"]["title"])

Submit custom metrics

datadog_metrics_submit takes separate array parameters for timestamps and values — not a serialized series object.

Node.js

await actions.executeTool({
  connector: 'datadog',
  identifier: 'user_123',
  toolName: 'datadog_metrics_submit',
  toolInput: {
    metric_name: 'app.request.duration',
    metric_type: 3,                              // 3 = gauge
    points_timestamps: JSON.stringify([Math.floor(Date.now() / 1000)]),
    points_values: JSON.stringify([142.5]),
    tags: JSON.stringify(['env:production', 'service:api']),
  },
});

Python

import time, json

actions.execute_tool(
    connection_name='datadog',
    identifier='user_123',
    tool_name="datadog_metrics_submit",
    tool_input={
        "metric_name": "app.request.duration",
        "metric_type": 3,                         # 3 = gauge
        "points_timestamps": json.dumps([int(time.time())]),
        "points_values": json.dumps([142.5]),
        "tags": json.dumps(["env:production", "service:api"]),
    },
)

metric_type values

0 = unspecified, 1 = count, 2 = rate, 3 = gauge. Use 3 (gauge) for point-in-time measurements.

Getting resource IDs

Most tools require IDs that must be fetched from the API — never guess or hard-code them.

Resource	Tool to get ID	Field in response
Monitor ID	datadog_monitors_list	array[].id
Dashboard ID	datadog_dashboards_list	dashboards[].id
Downtime ID	datadog_downtime_create response	data.id (UUID — not included[].id)
Notebook ID	datadog_notebooks_list	data[].id
Incident ID	datadog_incidents_list	data[].id
SLO ID	datadog_slos_list	data[].id
Role ID	datadog_roles_list	data[].id
User ID	datadog_users_list	data[].id
RUM App ID	datadog_rum_applications_list	data[].id
Event ID	datadog_event_create response	event.id_str (use id_str, not id — see note below)
Metric name	datadog_metrics_list	metrics[] (requires from Unix timestamp)
Log pipeline ID	datadog_log_pipelines_list	array[].id

Why event IDs must come from id_str

Datadog event IDs are 64-bit integers (e.g. 8610103547030771722) that exceed the float64 precision limit (~9 × 10¹⁵). When the numeric id field is parsed as a JSON number, it loses precision and the path resolves to a wrong ID, causing a 400 “No event matches” error. Always read event.id_str from the response and pass it as a string to datadog_event_get.

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

datadog_api_key_validate # Validate the current Datadog API key. 0 params ▾

Validate the current Datadog API key.

datadog_audit_logs_search # Search audit log events in Datadog for a given time window. 6 params ▾

Search audit log events in Datadog for a given time window.

Name Type Required Description

from string required Start of the time window in ISO 8601 format, e.g. 'now-1h' or '2023-01-01T00:00:00Z'.

to string required End of the time window in ISO 8601 format, e.g. 'now' or '2023-01-02T00:00:00Z'.

cursor string optional Pagination cursor from a previous response to fetch the next page.

limit integer optional Maximum number of audit events to return (max 1000).

query string optional Filter query for the audit log search.

sort string optional Sort order: 'timestamp' for ascending, '-timestamp' for descending.

datadog_containers_list # List all containers running on your infrastructure. 3 params ▾

List all containers running on your infrastructure.

Name Type Required Description

filter_tags string optional Filter containers by tag.

page_cursor string optional Cursor for pagination to get the next page of results.

page_size integer optional Maximum number of containers to return per page.

datadog_current_user_get # Get the current authenticated Datadog user. 0 params ▾

Get the current authenticated Datadog user.

datadog_dashboard_create # Create a new Datadog dashboard. 6 params ▾

Create a new Datadog dashboard.

Name Type Required Description

layout_type string required Layout type for the dashboard (ordered or free).

title string required Title of the dashboard.

description string optional Description of the dashboard.

tags string optional JSON array of tags for the dashboard.

template_variables string optional JSON array of template variable objects.

widgets string optional JSON array of widget objects for the dashboard.

datadog_dashboard_delete # Delete a Datadog dashboard by ID. 1 param ▾

Delete a Datadog dashboard by ID.

Name Type Required Description

dashboard_id string required ID of the dashboard to delete.

datadog_dashboard_get # Get a specific Datadog dashboard by ID. 1 param ▾

Get a specific Datadog dashboard by ID.

Name Type Required Description

dashboard_id string required ID of the dashboard to retrieve.

datadog_dashboard_update # Update an existing Datadog dashboard. 5 params ▾

Update an existing Datadog dashboard.

Name Type Required Description

dashboard_id string required ID of the dashboard to update.

layout_type string required Layout type for the dashboard (ordered or free).

title string required Title of the dashboard.

description string optional Description of the dashboard.

widgets string optional JSON array of widget objects for the dashboard.

datadog_dashboards_list # List all Datadog dashboards. 4 params ▾

List all Datadog dashboards.

Name Type Required Description

count integer optional Maximum number of dashboards to return.

filter_deleted string optional Filter deleted dashboards (true/false).

filter_shared string optional Filter shared dashboards (true/false).

start integer optional Start index for pagination.

datadog_downtime_cancel # Cancel a Datadog downtime by ID. 1 param ▾

Cancel a Datadog downtime by ID.

Name Type Required Description

downtime_id string required ID of the downtime to cancel.

datadog_downtime_create # Create a new Datadog downtime to suppress alerts. 7 params ▾

Create a new Datadog downtime to suppress alerts.

Name Type Required Description

scope string required Scope of the downtime, e.g. * or env:prod.

end string optional ISO-8601 UTC datetime when the downtime ends, e.g. 2026-04-28T12:00:00+00:00.

message string optional Message to include with the downtime.

monitor_id integer optional Monitor ID to apply the downtime to. Omit to apply to all monitors.

monitor_tags string optional JSON array of monitor tags to match for the downtime, e.g. ["*"] for all monitors.

start string optional ISO-8601 UTC datetime when the downtime starts, e.g. 2026-04-28T10:00:00+00:00.

timezone string optional Timezone for the downtime schedule (IANA format).

datadog_downtime_get # Get a specific Datadog downtime by ID. 1 param ▾

Get a specific Datadog downtime by ID.

Name Type Required Description

downtime_id string required ID of the downtime to retrieve.

datadog_downtime_update # Update an existing Datadog downtime. 3 params ▾

Update an existing Datadog downtime.

Name Type Required Description

downtime_id string required ID of the downtime to update.

message string optional Updated message for the downtime.

scope string optional Updated scope of the downtime.

datadog_downtimes_list # List all Datadog downtimes. 3 params ▾

List all Datadog downtimes.

Name Type Required Description

filter_monitor_id integer optional Filter downtimes by monitor ID.

page_limit integer optional Number of items to return per page.

page_offset integer optional Offset for pagination.

datadog_event_create # Create a new event in Datadog. 8 params ▾

Create a new event in Datadog.

Name Type Required Description

text string required Body text of the event.

title string required Title of the event.

aggregation_key string optional Key to aggregate related events.

alert_type string optional Alert type: info, error, warning, success, user_update, recommendation, snapshot.

date_happened integer optional Unix timestamp when the event occurred.

host string optional Host name to associate with the event.

priority string optional Priority of the event: normal or low.

tags string optional JSON array of tags for the event.

datadog_event_get # Get a specific Datadog event by ID. 1 param ▾

Get a specific Datadog event by ID.

Name Type Required Description

event_id string required ID of the event to retrieve. Use the id_str value from event_create or events_list_v2 to avoid float precision loss.

datadog_events_list_v2 # List Datadog events using the v2 API with filtering and pagination. 6 params ▾

List Datadog events using the v2 API with filtering and pagination.

Name Type Required Description

filter_from string optional ISO 8601 datetime for start of the filter range.

filter_query string optional Search query to filter events.

filter_to string optional ISO 8601 datetime for end of the filter range.

page_cursor string optional Cursor for pagination.

page_limit integer optional Maximum number of events to return.

sort string optional Sort order for events (timestamp or asc).

datadog_events_query # Query Datadog events within a time range. 8 params ▾

Query Datadog events within a time range.

Name Type Required Description

end integer required Unix timestamp for end of query window.

start integer required Unix timestamp for start of query window.

count integer optional Maximum number of events to return.

page integer optional Page number for pagination.

priority string optional Priority filter: normal or low.

sources string optional Comma-separated event sources to filter by.

tags string optional Comma-separated tags to filter events by.

unaggregated string optional Whether to return unaggregated events (true/false).

datadog_graph_snapshot # Take a snapshot of a metric graph in Datadog. 5 params ▾

Take a snapshot of a metric graph in Datadog.

Name Type Required Description

end integer required End of the time window as a Unix timestamp (seconds).

metric_query string required The Datadog metric query for the graph snapshot.

start integer required Start of the time window as a Unix timestamp (seconds).

event_query string optional Query string to add event bands to the snapshot graph.

title string optional Title for the snapshot graph.

datadog_host_mute # Mute a Datadog host to suppress alerts. 4 params ▾

Mute a Datadog host to suppress alerts.

Name Type Required Description

host_name string required Name of the host to mute.

end integer optional Unix timestamp when the mute ends.

message string optional Message describing why the host is being muted.

override string optional Whether to override an existing mute (true/false).

datadog_host_tags_create # Add tags to a specific host in Datadog. 3 params ▾

Add tags to a specific host in Datadog.

Name Type Required Description

host_name string required The hostname to add tags to.

tags string required JSON array of tag strings to add to the host. E.g. ["env:prod","role:db"].

source string optional The source of the tags (optional). Used to filter tags by source.

datadog_host_tags_delete # Remove all tags from a specific host in Datadog. 2 params ▾

Remove all tags from a specific host in Datadog.

Name Type Required Description

host_name string required The hostname to remove all tags from.

source string optional The source of the tags to remove (optional).

datadog_host_tags_get # Get all tags for a specific host. 1 param ▾

Get all tags for a specific host.

Name Type Required Description

host_name string required The hostname to retrieve tags for.

datadog_host_tags_update # Replace all tags for a specific host in Datadog. 3 params ▾

Replace all tags for a specific host in Datadog.

Name Type Required Description

host_name string required The hostname whose tags will be replaced.

tags string required JSON array of tag strings to set on the host. Replaces all existing tags. E.g. ["env:prod","role:db"].

source string optional The source of the tags (optional).

datadog_host_unmute # Unmute a Datadog host. 1 param ▾

Unmute a Datadog host.

Name Type Required Description

host_name string required Name of the host to unmute.

datadog_hosts_list # List Datadog hosts with optional filtering and sorting. 6 params ▾

List Datadog hosts with optional filtering and sorting.

Name Type Required Description

count integer optional Maximum number of hosts to return.

filter string optional Filter string to search hosts.

include_muted_hosts_data string optional Whether to include muted hosts data (true/false).

sort_dir string optional Sort direction: asc or desc.

sort_field string optional Field to sort hosts by.

start integer optional Starting offset for pagination.

datadog_hosts_totals # Get the total number of active and up Datadog hosts. 0 params ▾

Get the total number of active and up Datadog hosts.

datadog_incident_create # Create a new Datadog incident. 4 params ▾

Create a new Datadog incident.

Name Type Required Description

customer_impacted string required Whether customers are impacted (true/false).

title string required Title of the incident.

severity string optional Severity level: SEV-1, SEV-2, SEV-3, SEV-4, SEV-5, or UNKNOWN.

state string optional Initial state: active, stable, or resolved.

datadog_incident_get # Get a specific Datadog incident by ID. 1 param ▾

Get a specific Datadog incident by ID.

Name Type Required Description

incident_id string required ID of the incident to retrieve.

datadog_incidents_list # List Datadog incidents with optional filtering. 4 params ▾

List Datadog incidents with optional filtering.

Name Type Required Description

filter string optional Search query to filter incidents.

page_offset integer optional Offset for pagination.

page_size integer optional Number of incidents per page.

sort string optional Sort field: created or modified.

datadog_ip_ranges_list # Get all IP ranges used by Datadog agents and services. 0 params ▾

Get all IP ranges used by Datadog agents and services.

datadog_log_indexes_list # List all Datadog log indexes. 0 params ▾

List all Datadog log indexes.

datadog_log_pipeline_get # Get a specific Datadog log processing pipeline by ID. 1 param ▾

Get a specific Datadog log processing pipeline by ID.

Name Type Required Description

pipeline_id string required ID of the log pipeline to retrieve.

datadog_log_pipelines_list # List all Datadog log processing pipelines. 0 params ▾

List all Datadog log processing pipelines.

datadog_logs_aggregate # Aggregate Datadog log events with grouping and compute operations. 5 params ▾

Aggregate Datadog log events with grouping and compute operations.

Name Type Required Description

compute string required JSON array of compute objects defining aggregations.

from string required ISO 8601 start time for log aggregation.

to string required ISO 8601 end time for log aggregation.

group_by string optional JSON array of group_by objects.

query string optional Log filter query string.

datadog_logs_search # Search and filter Datadog log events. 6 params ▾

Search and filter Datadog log events.

Name Type Required Description

from string required ISO 8601 start time for the log search.

to string required ISO 8601 end time for the log search.

cursor string optional Pagination cursor for fetching next page.

limit integer optional Maximum number of log events to return (max 1000).

query string optional Log search query string.

sort string optional Sort order: timestamp (newest first) or asc (oldest first).

datadog_metric_metadata_get # Get metadata for a specific Datadog metric. 1 param ▾

Get metadata for a specific Datadog metric.

Name Type Required Description

metric_name string required Name of the metric to retrieve metadata for.

datadog_metric_metadata_update # Update metadata for a specific Datadog metric. 5 params ▾

Update metadata for a specific Datadog metric.

Name Type Required Description

metric_name string required Name of the metric to update metadata for.

description string optional Description of the metric.

short_name string optional Short name for the metric.

type string optional Metric type: gauge, rate, or count.

unit string optional Unit of the metric.

datadog_metric_tags_list # List all tags for a specific Datadog metric. 1 param ▾

List all tags for a specific Datadog metric.

Name Type Required Description

metric_name string required Name of the metric to list tags for.

datadog_metrics_list # List active metrics reported from a given Unix timestamp. 3 params ▾

List active metrics reported from a given Unix timestamp.

Name Type Required Description

from integer required Unix timestamp from which to start the search.

host string optional Hostname to filter the list of metrics to those active on this host.

tag_filter string optional Filter metrics by tag.

datadog_metrics_query # Query timeseries metric data from Datadog. 3 params ▾

Query timeseries metric data from Datadog.

Name Type Required Description

from integer required Unix timestamp for start of query window.

query string required Datadog metric query string.

to integer required Unix timestamp for end of query window.

datadog_metrics_submit # Submit metric data points to Datadog. 6 params ▾

Submit metric data points to Datadog.

Name Type Required Description

metric_name string required Name of the metric to submit.

metric_type integer required Metric type: 0=unspecified, 1=count, 2=rate, 3=gauge.

points_timestamps string required JSON array of Unix timestamps for the data points.

points_values string required JSON array of float values corresponding to each timestamp.

host string optional Host name to associate with the metric.

tags string optional JSON array of tag strings to associate with the metric.

datadog_monitor_create # Create a new Datadog monitor. 8 params ▾

Create a new Datadog monitor.

Name Type Required Description

name string required Name of the monitor.

query string required The monitor query string.

type string required Type of the monitor (e.g. metric alert, service check, event alert, query alert).

message string optional Notification message for the monitor.

no_data_timeframe integer optional Number of minutes before notifying on missing data.

notify_no_data string optional Whether to notify when no data is received (true/false).

priority integer optional Monitor priority from 1 (highest) to 5 (lowest).

tags string optional JSON array of tags to associate with the monitor.

datadog_monitor_delete # Delete a Datadog monitor by ID. 1 param ▾

Delete a Datadog monitor by ID.

Name Type Required Description

monitor_id integer required ID of the monitor to delete.

datadog_monitor_get # Get a specific Datadog monitor by ID. 1 param ▾

Get a specific Datadog monitor by ID.

Name Type Required Description

monitor_id integer required ID of the monitor to retrieve.

datadog_monitor_mute # Mute a Datadog monitor, optionally with a scope and end time. 3 params ▾

Mute a Datadog monitor, optionally with a scope and end time.

Name Type Required Description

monitor_id integer required ID of the monitor to mute.

end integer optional Unix timestamp when the mute should end.

scope string optional Scope to apply the mute to, e.g. role:db.

datadog_monitor_search # Search Datadog monitors using a query string. 4 params ▾

Search Datadog monitors using a query string.

Name Type Required Description

page integer optional Page number for pagination.

per_page integer optional Number of results per page.

query string optional Search query string.

sort string optional Sort field and direction.

datadog_monitor_unmute # Unmute a Datadog monitor. 1 param ▾

Unmute a Datadog monitor.

Name Type Required Description

monitor_id integer required ID of the monitor to unmute.

datadog_monitor_update # Update an existing Datadog monitor. 6 params ▾

Update an existing Datadog monitor.

Name Type Required Description

monitor_id integer required ID of the monitor to update.

message string optional Updated notification message for the monitor.

name string optional New name for the monitor.

priority integer optional Monitor priority from 1 (highest) to 5 (lowest).

query string optional Updated query string for the monitor.

tags string optional JSON array of tags to associate with the monitor.

datadog_monitors_list # List all Datadog monitors with optional filtering. 7 params ▾

List all Datadog monitors with optional filtering.

Name Type Required Description

group_states string optional Comma-separated list of group states to filter by (e.g. alert,warn).

monitor_tags string optional Comma-separated list of monitor tags.

name string optional Filter monitors by name.

page integer optional Page number for pagination.

page_size integer optional Number of monitors to return per page.

tags string optional Comma-separated list of tags to filter monitors.

with_downtimes string optional Whether to include downtime information (true/false).

datadog_notebook_create # Create a new notebook in Datadog. 2 params ▾

Create a new notebook in Datadog.

Name Type Required Description

name string required The name of the notebook.

cells string optional JSON array of notebook cell objects to include in the notebook.

datadog_notebook_delete # Delete a specific notebook by its ID. 1 param ▾

Delete a specific notebook by its ID.

Name Type Required Description

notebook_id integer required The ID of the notebook to delete.

datadog_notebook_get # Get a specific Datadog notebook by its ID. 1 param ▾

Get a specific Datadog notebook by its ID.

Name Type Required Description

notebook_id integer required The ID of the notebook to retrieve.

datadog_notebooks_list # List all notebooks available in your Datadog account. 5 params ▾

List all notebooks available in your Datadog account.

Name Type Required Description

author_handle string optional Filter notebooks by the author's handle.

count integer optional The number of notebooks to return per page.

include_cells string optional Whether to include notebook cells in the response. Use 'true' or 'false'.

query string optional Filter notebooks by a text query string.

start integer optional The offset for pagination (number of notebooks to skip).

datadog_permissions_list # List all available Datadog permissions. 0 params ▾

List all available Datadog permissions.

datadog_processes_list # List live processes running on your infrastructure. 6 params ▾

List live processes running on your infrastructure.

Name Type Required Description

from integer optional Start of the time window as a Unix timestamp (seconds).

page_cursor string optional Cursor for pagination to get the next page of results.

page_limit integer optional Maximum number of processes to return (max 1000).

search string optional Filter processes by name or command.

tags string optional Comma-separated list of tags to filter processes.

to integer optional End of the time window as a Unix timestamp (seconds).

datadog_role_create # Create a new Datadog role. 2 params ▾

Create a new Datadog role.

Name Type Required Description

name string required Name for the new role.

permissions string optional JSON array of permission objects to assign to the role.

datadog_role_get # Get a specific Datadog role by ID. 1 param ▾

Get a specific Datadog role by ID.

Name Type Required Description

role_id string required UUID of the role to retrieve.

datadog_roles_list # List all Datadog roles. 4 params ▾

List all Datadog roles.

Name Type Required Description

filter string optional Filter roles by name.

page_number integer optional Page number for pagination.

page_size integer optional Number of roles per page.

sort string optional Field to sort roles by.

datadog_rum_application_create # Create a new Datadog RUM application. 2 params ▾

Create a new Datadog RUM application.

Name Type Required Description

name string required Name of the RUM application.

type string required Type of the RUM application: browser, ios, android, react-native, flutter, or roku.

datadog_rum_application_get # Get a specific RUM application by its ID. 1 param ▾

Get a specific RUM application by its ID.

Name Type Required Description

id string required The ID of the RUM application to retrieve.

datadog_rum_applications_list # List all Datadog RUM applications. 0 params ▾

List all Datadog RUM applications.

datadog_service_check_submit # Submit a service check result to Datadog. 5 params ▾

Submit a service check result to Datadog.

Name Type Required Description

check string required The name of the service check, e.g. 'app.is_ok'.

host_name string required The hostname associated with this service check.

status integer required The status of the service check. 0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN.

message string optional A message describing the current state of the service check.

tags string optional JSON array of tag strings to associate with the service check. E.g. ["env:prod","role:db"].

datadog_slo_create # Create a new Service Level Objective (SLO) in Datadog. 7 params ▾

Create a new Service Level Objective (SLO) in Datadog.

Name Type Required Description

name string required Name of the SLO.

thresholds string required JSON array of threshold objects, e.g. [{"timeframe":"7d","target":99.9}].

type string required Type of SLO: metric or monitor.

description string optional Description of the SLO.

monitor_ids string optional JSON array of monitor IDs for a monitor-based SLO.

query string optional JSON object with numerator and denominator for metric-based SLOs.

tags string optional JSON array of tags for the SLO.

datadog_slo_delete # Delete a Datadog Service Level Objective by ID. 1 param ▾

Delete a Datadog Service Level Objective by ID.

Name Type Required Description

slo_id string required ID of the SLO to delete.

datadog_slo_get # Get a specific Datadog Service Level Objective by ID. 1 param ▾

Get a specific Datadog Service Level Objective by ID.

Name Type Required Description

slo_id string required ID of the SLO to retrieve.

datadog_slo_history # Get historical data for a specific Datadog SLO. 4 params ▾

Get historical data for a specific Datadog SLO.

Name Type Required Description

from_ts integer required Unix timestamp for start of the history range.

slo_id string required ID of the SLO.

to_ts integer required Unix timestamp for end of the history range.

target string optional Custom target value for the history calculation.

datadog_slo_update # Update an existing Datadog Service Level Objective. 7 params ▾

Update an existing Datadog Service Level Objective.

Name Type Required Description

slo_id string required ID of the SLO to update.

type string required Type of SLO: metric or monitor. Required by the Datadog API on update.

description string optional Updated description for the SLO.

name string optional Updated name for the SLO.

query string optional JSON object with numerator and denominator for metric-type SLOs.

tags string optional JSON array of updated tags.

thresholds string optional JSON array of updated threshold objects.

datadog_slos_list # List Service Level Objectives (SLOs) in Datadog. 5 params ▾

List Service Level Objectives (SLOs) in Datadog.

Name Type Required Description

ids string optional Comma-separated list of SLO IDs to retrieve.

limit integer optional Maximum number of SLOs to return.

offset integer optional Offset for pagination.

query string optional Search query to filter SLOs by name.

tags_query string optional Filter SLOs by tags.

datadog_synthetics_api_test_get # Get a specific Datadog Synthetics API test by public ID. 1 param ▾

Get a specific Datadog Synthetics API test by public ID.

Name Type Required Description

public_id string required Public ID of the Synthetics API test.

datadog_synthetics_browser_test_get # Get a specific Datadog Synthetics browser test by public ID. 1 param ▾

Get a specific Datadog Synthetics browser test by public ID.

Name Type Required Description

public_id string required Public ID of the Synthetics browser test.

datadog_synthetics_global_variables_list # List all Datadog Synthetics global variables. 0 params ▾

List all Datadog Synthetics global variables.

datadog_synthetics_locations_list # List all Datadog Synthetics locations (public and private). 0 params ▾

List all Datadog Synthetics locations (public and private).

datadog_synthetics_test_delete # Delete one or more Datadog Synthetics tests by public ID. 1 param ▾

Delete one or more Datadog Synthetics tests by public ID.

Name Type Required Description

public_ids string required JSON array of public IDs of Synthetics tests to delete.

datadog_synthetics_test_pause_resume # Pause or resume a Datadog Synthetics test. 2 params ▾

Pause or resume a Datadog Synthetics test.

Name Type Required Description

new_status string required New status for the test: live or paused.

public_id string required Public ID of the Synthetics test.

datadog_synthetics_test_results_get # Get the latest results for a specific Datadog Synthetics test. 3 params ▾

Get the latest results for a specific Datadog Synthetics test.

Name Type Required Description

public_id string required Public ID of the Synthetics test.

from_ts integer optional Unix timestamp for start of results range.

to_ts integer optional Unix timestamp for end of results range.

datadog_synthetics_test_trigger # Trigger one or more Datadog Synthetics tests to run immediately. 1 param ▾

Trigger one or more Datadog Synthetics tests to run immediately.

Name Type Required Description

tests string required JSON array of test objects with public_id.

datadog_synthetics_tests_list # List all Datadog Synthetics tests. 2 params ▾

List all Datadog Synthetics tests.

Name Type Required Description

page_number integer optional Page number for pagination.

page_size integer optional Number of tests to return per page.

datadog_user_create # Create a new Datadog user. 4 params ▾

Create a new Datadog user.

Name Type Required Description

email string required Email address of the new user.

name string optional Display name of the user.

roles string optional JSON array of role IDs to assign to the user.

title string optional Job title of the user.

datadog_user_disable # Disable a Datadog user account by UUID. 1 param ▾

Disable a Datadog user account by UUID.

Name Type Required Description

user_id string required UUID of the user to disable.

datadog_user_get # Get a specific Datadog user by UUID. 1 param ▾

Get a specific Datadog user by UUID.

Name Type Required Description

user_id string required UUID of the user to retrieve.

datadog_user_roles_list # Get all roles assigned to a specific Datadog user. 1 param ▾

Get all roles assigned to a specific Datadog user.

Name Type Required Description

user_id string required UUID of the user.

datadog_user_update # Update an existing Datadog user. 4 params ▾

Update an existing Datadog user.

Name Type Required Description

user_id string required UUID of the user to update.

disabled string optional Whether to disable the user (true/false).

name string optional Updated display name for the user.

title string optional Updated job title for the user.

datadog_users_list # List Datadog users with optional filtering. 5 params ▾

List Datadog users with optional filtering.

Name Type Required Description

filter string optional Filter string to search users by name or email.

page_number integer optional Page number for pagination.

page_size integer optional Number of users per page.

sort string optional Field to sort users by.

sort_dir string optional Sort direction: asc or desc.