POST /api/v2/logs/analytics/aggregate: computes compute (results keyed c0, c1, …) over
the logs matching the filter, optionally grouped by facets.
Iterates over every matching event across pages (cursor pagination). limit caps the total
number of events; a repeated cursor raises UnavailableError (protocol loop guard).
Log indexes from GET /api/v1/logs/config/indexes (needs logs_read_config).
Datadog has no public API that lists facets or attributes. Always throws UnsupportedError.
Index names from GET /api/v1/logs/config/indexes (needs the logs_read_config permission).
Category search: one page of searchLogs (start/end → from/to, order →
sort, cursor → page.cursor). total is never set (Datadog returns none).
One page of POST /api/v2/logs/events/search. Pass nextCursor back as cursor (with the
same filter and sort) for the next page.
Polling tail over search (Datadog Live Tail has no public API). Default interval 5000 ms because the search API is rate limited.
Polls search until a record matches (default interval 5000 ms, timeout 30000 ms).
Authentication and validation errors propagate at once; TimeoutError at the deadline.
Datadog Logs query client (needs
appKey):searchLogs(one page),iterateLogs(cursor pagination),aggregateLogs, and the category BaseLogQueryClient methods:search,waitForLog,tail(polling search),listStreams(index names, needslogs_read_config);listLabelsthrowsUnsupportedError.