datadog-cli
Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards. Use this when debugging production issues or working with Datadog observability.
By softaworks · 644 installs
npx skills add softaworks/agent-toolkit --skill datadog-cli
Source repository · Upstream listing
Datadog CLI
A CLI tool for AI agents to debug and triage using Datadog logs and metrics.
Required Reading
You MUST read the relevant reference docs before using any command:
[Log Commands](references/logs commands.md)
[Metrics](references/metrics.md)
[Query Syntax](references/query syntax.md)
[Workflows](references/workflows.md)
[Dashboards](references/dashboards.md)
Setup
Environment Variables (Required)
Get keys from: https://app.datadoghq.com/organization settings/api keys
Running the CLI
For non US Datadog sites, use site flag:
Commands Overview
Command Description
logs search Search logs with filters
logs tail Stream logs in real time
logs trace Find logs for a distributed trace
logs context Get logs before/after a timestamp
logs patterns Group similar log messages
logs compare Compare log counts between periods
logs multi Run multiple queries in parallel
logs agg Aggregate logs by facet
metrics query Query timeseries metrics
errors Quick error summary by service/type
services List services with log activity
dashboards Manage dashboards (CRUD)
dashboard lists Manage dashboard lists
Quick Examples
Search Errors
Tail Logs (Real time)
Error Summary
Trace Correlation
Query Metrics
Compare Periods
Global Flags
Flag Description
pretty Human readable output with colors
output <file Export results to JSON file
site <site Datadog site (e.g., datadoghq.eu )
Time Formats
Relative : 30m , 1h , 6h , 24h , 7d
ISO 8601 : 2024 01 15T10:30:00Z
Incident Triage Workflow
See [workflows.md](references/workflows.md) for more debugging workflows.