datadog_events_list
Retrieve Datadog events from the event/alert stream, filtered by tags, sources, or query, and limited to a time range with pagination support.
Instructions
List Datadog events from the event/alert stream (e.g. deploys, monitor alerts), optionally filtered (e.g. service:api) over a time range (default last 1h). For application log lines use datadog_logs_search instead. limit of 0 (or omitted) auto-paginates across cursor pages up to 10000; any non-zero value caps the total at that count (default 100). from / to accept relative shorthand (15m, 1h), now, RFC 3339, or Unix epoch seconds. Read-only. Mirrors omni-dev datadog events list. Output is YAML.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End of the time range, same formats as `from`. Defaults to `now`. | |
| from | No | Start of the time range. Accepts relative shorthand (`15m`, `1h`), `now`, RFC 3339, or Unix epoch seconds. Defaults to `1h`. | |
| tags | No | Comma-separated list of `key:value` tags, e.g. `env:prod,team:sre`. Optional. | |
| limit | No | Maximum events to return. `0` means "fetch every match across pages (capped at 10000)"; any non-zero value caps the total at that count, paginating underneath as needed. Defaults to 100. | |
| filter | No | Datadog events query (e.g. `service:api`). Optional; omit to match all events in the window. | |
| sources | No | Comma-separated list of source names, e.g. `github,nagios`. Optional. |