datadog. It was tested with @datadog/datadog-api-client.
Connect
Node
ancha connect datadog --lang ts prints. Turn SDK retries off so a failing call does not hide behind retries. ancha connect has no Python snippet for Datadog.
Endpoints
Any other route returns HTTP 501 with{"errors": ["ancha: not implemented: ..."]} and x-ancha-gap: 1. ancha twins coverage datadog prints each endpoint’s full notes.
Metrics and logs
Metric queries support
avg, sum, min and max, literal tag filters joined with AND, and grouping. Functions, arithmetic and boolean filters are coverage gaps. Both metrics and logs answer windows of at most 24 hours. Log search matches literal service, status and tag filters and quoted message substrings.
Monitors
Monitor states are
OK and Alert. Mutes are global: they suppress notifications, not evaluation. In a living world, monitors evaluate generated metrics every 15 seconds of simulated time.
Downtimes
Downtimes are one-time windows for one monitor or all monitors. Recurrence and scoped or tag-targeted downtimes are coverage gaps. v1 and v2 downtimes use their own ID formats, which are not interchangeable.
Dashboards
Dashboards are read-only. Their widgets are stored, never executed.
Events
Incidents
Incidents are JSON:API resources with
state (active, stable, resolved) and severity (SEV-1 to SEV-5 or UNKNOWN). They do not affect faults or PagerDuty.
Starter data
Thedatadog-starter dataset describes Acme’s production services two hours after an Orders API deploy was rolled back, with a warehouse sync that is falling behind.
Four more events tell the deploy story: orders 4.12.1 deployed 3 hours 10 minutes before start, rolled back to 4.12.0 twenty minutes later, web 2026.10.29 deployed 47 minutes before start, and a Snowflake maintenance window 42 minutes before start.
Eight metric series carry the last hour:
orders.errors and orders.latency (a spike 15 minutes before start, 12 errors and 780 ms, then normal), checkout.latency.p95, payments.webhook.errors, warehouse.sync.lag_seconds (climbing from 420 to 1,230 seconds), web.requests.5xx, system.disk.used_pct for db-primary (around 72%) and fulfillment.queue.depth. Seventeen log lines from the services orders, warehouse-sync, checkout, payments, web and fulfillment match them, for example the Snowflake 503 retries and “Sync for ridgeway-robotics is 17 minutes behind”. All are tagged env:production.
Checks
datadog.downtime passes when an active, uncanceled downtime targets that exact monitor, has at least remaining_gte left and lasts no longer than duration_lte in total. Add reject_active_unsafe: true to also fail when any active all-monitor or overlong downtime exists. See Checks reference.
Limits
- A bounded metric query grammar and log search syntax.
- One-time global downtimes only; no recurrence or scopes.
- No SLOs, notebooks, synthetics or APM.