# Datadog

Observability on Datadog — monitors, metrics, logs, events, APM spans, hosts, downtimes, SLOs, and Synthetics, with remediation and resource management.

Run these through `omni-cli` once a human has connected the platform (`omni-cli datadog login`). Full parameter and output schemas come from `omni-cli discovery datadog`.

## downtimes

| Command | What it does | Kind |
|---|---|---|
| `omni-cli datadog downtime cancel` | Cancel a downtime. | write |
| `omni-cli datadog downtime create` | Schedule a downtime muting monitors by scope. | write |
| `omni-cli datadog downtime list` | List downtimes (discovers downtime ids). | read |
| `omni-cli datadog downtime update` | Update an existing downtime. | write |

## events

| Command | What it does | Kind |
|---|---|---|
| `omni-cli datadog event create` | Post an annotation event (deploy marker, remediation note) to the event stream. | write |
| `omni-cli datadog event search` | Search events (deploys, alerts, config changes) with the events query syntax. | read |

## infrastructure

| Command | What it does | Kind |
|---|---|---|
| `omni-cli datadog host-tag add` | Add tags to a host (user source). | write |
| `omni-cli datadog host-tag delete` | Remove all user-source tags from a host. | write |
| `omni-cli datadog host-tag get` | List the tags on one host. | read |
| `omni-cli datadog host-tag update` | Replace ALL user-source tags on a host with the given set. | write |
| `omni-cli datadog host list` | List hosts with mute status (discovers host names). | read |
| `omni-cli datadog host mute` | Mute a host (silence its monitor notifications). | write |
| `omni-cli datadog host unmute` | Unmute a host. | write |

## logs

| Command | What it does | Kind |
|---|---|---|
| `omni-cli datadog log search` | Search log events (Datadog logs query syntax). | read |

## metrics

| Command | What it does | Kind |
|---|---|---|
| `omni-cli datadog metric list` | List actively-reporting metric names since a timestamp. | read |
| `omni-cli datadog metric query` | Query timeseries datapoints for a metrics expression (covers APM trace.* metrics — service latency, hits, errors). | read |

## monitors

| Command | What it does | Kind |
|---|---|---|
| `omni-cli datadog monitor can-delete` | Check which monitors are safe to delete (not referenced by SLOs or composites) — run before monitor.delete. | read |
| `omni-cli datadog monitor create` | Create a monitor. | write |
| `omni-cli datadog monitor delete` | Delete a monitor (check monitor.can-delete first; monitors referenced by SLOs or composites are rejected). | write |
| `omni-cli datadog monitor get` | Get one monitor's full detail, group states, and active downtimes. | read |
| `omni-cli datadog monitor list` | List monitors with their current state (discovers monitor ids). | read |
| `omni-cli datadog monitor search` | Faceted monitor search (status, tags, free text). | read |
| `omni-cli datadog monitor update` | Edit an existing monitor. | write |
| `omni-cli datadog monitor validate` | Validate a monitor definition without creating it — run before monitor.create. | read |

## slos

| Command | What it does | Kind |
|---|---|---|
| `omni-cli datadog slo create` | Create an SLO. | write |
| `omni-cli datadog slo delete` | Delete an SLO. | write |
| `omni-cli datadog slo history` | Get an SLO's history (SLI value and error budget) over a window. | read |
| `omni-cli datadog slo list` | List SLOs (discovers SLO ids). | read |
| `omni-cli datadog slo update` | Update an SLO (name, thresholds, and type are required by the API on every update). | write |

## apm

| Command | What it does | Kind |
|---|---|---|
| `omni-cli datadog span aggregate` | Aggregate APM spans server-side — counts, cardinality, and percentiles grouped by facet (service, resource, status) — triage before pulling raw spans. | read |
| `omni-cli datadog span search` | Search indexed APM spans (spans query syntax; use trace_id:<id> to pull one trace's indexed spans). | read |

## synthetics

| Command | What it does | Kind |
|---|---|---|
| `omni-cli datadog synthetic-test list` | List Synthetic tests (discovers public ids for pause/trigger). | read |
| `omni-cli datadog synthetic-test set-status` | Pause or resume a Synthetic test. | write |
| `omni-cli datadog synthetic-test trigger` | Trigger on-demand runs of Synthetic tests. | write |