Datadog#

Work with Datadog from chat - inspect monitors, metrics, logs, incidents, dashboards, and observability data.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure Datadog API access yourself.

Setup in 3 Steps#

Step 1: InstallStep 2: Pair AccountStep 3: Connect Datadog_App-specific connection GIF coming soon_Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect Datadog

Connection flow#

text

User → ClawLink OAuth → Datadog account
         ↓
    OpenClaw tools
    (via ClawLink)

Step 1 — Install the ClawLink plugin:

text

openclaw plugins install clawhub:clawlink-plugin

Start a fresh chat after installing.

Step 2 — Pair ClawLink:

1. Call clawlink_begin_pairing
2. Open the returned URL in your browser
3. Sign in to ClawLink and approve the device

Step 3 — Connect Datadog: Open claw-link.dev/dashboard?add=datadog, complete the OAuth flow, then confirm.

App-specific connection GIF coming soon

Step 4 — Verify and discover:

javascript

// 1. Verify Datadog is connected
clawlink_list_integrations()

// 2. List available tools
clawlink_list_tools({ integration: "datadog" })

// 3. Search tools if needed
clawlink_search_tools({ query: "monitor", integration: "datadog" })

Architecture#

text

┌─────────────────────────────────────────────────────────┐
│                    OpenClaw (you)                       │
├─────────────────────────────────────────────────────────┤
│  ClawLink Plugin  →  clawlink_* tools                   │
├─────────────────────────────────────────────────────────┤
│                    ClawLink Cloud                       │
│         (credentials, connection state, routing)        │
├─────────────────────────────────────────────────────────┤
│              Datadog API (user's account)               │
└─────────────────────────────────────────────────────────┘

Tool reference#

Read operations#

ToolDescriptionRiskdatadog_get_dashboardGet detailed dashboard info including widgets, layout, template variablessafedatadog_get_monitorGet monitor details, current state, configuration, active downtimessafedatadog_get_service_dependenciesGet APM service dependency graph (upstream/downstream services)safedatadog_get_synthetics_locationsList all available public/private synthetic test locationssafedatadog_get_tagsGet all tags associated with a specific hostsafedatadog_get_usage_summaryGet usage summary (API calls, hosts, containers, billing metrics)safedatadog_list_all_tagsList all tags in use across the organizationsafedatadog_list_api_keysList all API keys (names, owners, last-used timestamps)safedatadog_list_apm_servicesList APM services for application performance monitoringsafedatadog_list_aws_integrationList configured AWS account integrationssafedatadog_list_dashboardsList all dashboards with basic infosafedatadog_list_eventsList events within a time range (deployments, outages, changes)safedatadog_list_hostsList all hosts with metrics, tags, and statussafedatadog_list_incidentsList incidents with timeline and impact trackingsafedatadog_list_log_indexesList all log indexes (use before searching logs)safedatadog_list_metricsDiscover active metric names since a given timestampsafedatadog_list_monitorsGet all monitor details with filtering by group, name, tagssafedatadog_list_rolesList organization roles and their permissionssafedatadog_list_service_checksList service check statuses for infrastructure componentssafedatadog_list_sl_osList Service Level Objectives and reliability targetssafedatadog_list_syntheticsList synthetic API tests from multiple global locationssafedatadog_list_usersList team members, their roles, and access levelssafedatadog_list_webhooksList configured webhook integrationssafedatadog_query_metricsQuery time series metric data for custom dashboards/reportssafedatadog_search_logsSearch logs with advanced filtering (time in ms, no sort param)safedatadog_search_spans_analyticsAnalyze span data with aggregations (error rates, latency patterns)safedatadog_search_tracesSearch distributed traces across servicessafe

Write operations#

ToolDescriptionRiskdatadog_create_dashboardCreate a customizable monitoring dashboardconfirmdatadog_create_downtimeSuppress alerts during maintenance windowsconfirmdatadog_create_eventTrack deployments, outages, configuration changesconfirmdatadog_create_monitorCreate a monitor with alerting thresholds and notificationsconfirmdatadog_create_sloCreate a Service Level Objective for reliability trackingconfirmdatadog_create_synthetic_api_testCreate a synthetic API test from multiple global locationsconfirmdatadog_create_webhookRegister a webhook endpoint for monitor notificationsconfirmdatadog_delete_dashboardPermanently remove a dashboardhigh_impactdatadog_delete_monitorPermanently delete a monitorhigh_impactdatadog_mute_monitorTemporarily silence alerts (maintenance windows)confirmdatadog_submit_metricsSubmit custom metrics and business KPIsconfirmdatadog_unmute_monitorRe-enable alerts from a previously muted monitorconfirmdatadog_update_dashboardUpdate dashboard configuration, widgets, or layoutconfirmdatadog_update_host_tagsReplace all tags on a specific hostconfirmdatadog_update_monitorUpdate monitor thresholds or notification settingsconfirm

Code examples#

Example 1: List all monitors and find critical ones#

javascript

// Get all monitors
const monitors = await clawlink_call_tool({
  tool: "clawlink_list_tools",
  parameters: { integration: "datadog" }
});

// Then get details for a specific monitor
const monitor = await clawlink_call_tool({
  tool: "datadog_get_monitor",
  parameters: { monitor_id: "123456" }
});

// Or list all monitors with details
const allMonitors = await clawlink_call_tool({
  tool: "datadog_list_monitors",
  parameters: {}
});

Example 2: Query metrics and search logs#

javascript

// List available metrics first
const metrics = await clawlink_call_tool({
  tool: "datadog_list_metrics",
  parameters: { from: 1704067200 }
});

// Query specific metrics
const timeseries = await clawlink_call_tool({
  tool: "datadog_query_metrics",
  parameters: {
    query: "system.cpu.user{*}",
    from: 1704067200,
    to: 1704153600
  }
});

// Search logs for errors
const errors = await clawlink_call_tool({
  tool: "datadog_search_logs",
  parameters: {
    query: "status:error",
    from: 1704067200000,
    to: 1704153600000
  }
});

Example 3: Create and manage monitors#

javascript

// Create a monitor
const newMonitor = await clawlink_call_tool({
  tool: "datadog_create_monitor",
  parameters: {
    name: "High CPU Alert",
    type: "metric alert",
    query: "avg(last_5m):system.cpu.user{*} > 90",
    message: "CPU usage is above 90%"
  }
});

// Mute a monitor during maintenance
await clawlink_call_tool({
  tool: "datadog_mute_monitor",
  parameters: {
    monitor_id: "123456",
    scope: "env:production"
  }
});

Example 4: Investigate an incident#

javascript

// List recent incidents
const incidents = await clawlink_call_tool({
  tool: "datadog_list_incidents",
  parameters: {}
});

// Get service dependencies for the affected service
const deps = await clawlink_call_tool({
  tool: "datadog_get_service_dependencies",
  parameters: { service_name: "payment-service" }
});

// Search traces for errors
const traces = await clawlink_call_tool({
  tool: "datadog_search_traces",
  parameters: { service: "payment-service", status: "error" }
});

Error handling#

Error patternLikely causeResolutionMonitor not foundWrong monitor IDCall datadog_list_monitors to get correct IDPermission deniedMissing Datadog scopesUser may need to reconnect Datadog with full permissionsToo many resultsLarge time rangeNarrow the time range or add filters to reduce result sizeSort parameter not supportedUsing sort in log searchRemove sort param — Datadog Logs API does not support itInvalid type for aggregate_requestSpan analytics schema violationUse datadog_search_traces instead for basic trace search

Security & Permissions#

• ClawLink stores only the OAuth token, never the raw API key
• Device credentials are stored locally in OpenClaw plugin config
• datadog_list_api_keys returns metadata only (no secret key values)
• Datadog OAuth scopes are determined by ClawLink's registered app — user may need to reconnect if scopes change

Troubleshooting#

Tools not showing up after install:

• Start a fresh OpenClaw chat to reload the plugin catalog
• Call clawlink_list_integrations to confirm ClawLink is paired

"Integration not connected" error:

• Direct user to claw-link.dev/dashboard?add=datadog
• Confirm they complete the OAuth flow and approve the connection

Empty results from datadog_list_events:

• Events are often sparse — start with a broad time range and minimal filters
• Combining multiple filters (tags + sources + priority) with narrow ranges may return empty results

---

Powered by ClawLink — your OpenClaw integration hub for Datadog.