datadog-cli

1# Datadog CLI
2 
3A CLI tool for AI agents to debug and triage using Datadog logs and metrics.
4 
5## Required Reading
6 
7**You MUST read the relevant reference docs before using any command:**
8- [Log Commands](references/logs-commands.md)
9- [Metrics](references/metrics.md)
10- [Query Syntax](references/query-syntax.md)
11- [Workflows](references/workflows.md)
12- [Dashboards](references/dashboards.md)
13 
14## Setup
15 
16### Environment Variables (Required)
17 
18```bash
19export DD_API_KEY="your-api-key"
20export DD_APP_KEY="your-app-key"
21```
22 
23Get keys from: https://app.datadoghq.com/organization-settings/api-keys
24 
25### Running the CLI
26 
27```bash
28npx @leoflores/datadog-cli <command>
29```
30 
31For non-US Datadog sites, use `--site` flag:
32```bash
33npx @leoflores/datadog-cli logs search --query "*" --site datadoghq.eu
34```
35 
36## Commands Overview
37 
38| Command | Description |
39|---------|-------------|
40| `logs search` | Search logs with filters |
41| `logs tail` | Stream logs in real-time |
42| `logs trace` | Find logs for a distributed trace |
43| `logs context` | Get logs before/after a timestamp |
44| `logs patterns` | Group similar log messages |
45| `logs compare` | Compare log counts between periods |
46| `logs multi` | Run multiple queries in parallel |
47| `logs agg` | Aggregate logs by facet |
48| `metrics query` | Query timeseries metrics |
49| `errors` | Quick error summary by service/type |
50| `services` | List services with log activity |
51| `dashboards` | Manage dashboards (CRUD) |
52| `dashboard-lists` | Manage dashboard lists |
53…