{"id":"e1066b84-22ef-42d0-b70c-c3f466f334a2","shortId":"nuSC5D","kind":"skill","title":"datadog-cli","tagline":"Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards. Use this when debugging production issues or working with Datadog observability.","description":"# Datadog CLI\n\nA CLI tool for AI agents to debug and triage using Datadog logs and metrics.\n\n## Required Reading\n\n**You MUST read the relevant reference docs before using any command:**\n- [Log Commands](references/logs-commands.md)\n- [Metrics](references/metrics.md)\n- [Query Syntax](references/query-syntax.md)\n- [Workflows](references/workflows.md)\n- [Dashboards](references/dashboards.md)\n\n## Setup\n\n### Environment Variables (Required)\n\n```bash\nexport DD_API_KEY=\"your-api-key\"\nexport DD_APP_KEY=\"your-app-key\"\n```\n\nGet keys from: https://app.datadoghq.com/organization-settings/api-keys\n\n### Running the CLI\n\n```bash\nnpx @leoflores/datadog-cli <command>\n```\n\nFor non-US Datadog sites, use `--site` flag:\n```bash\nnpx @leoflores/datadog-cli logs search --query \"*\" --site datadoghq.eu\n```\n\n## Commands Overview\n\n| Command | Description |\n|---------|-------------|\n| `logs search` | Search logs with filters |\n| `logs tail` | Stream logs in real-time |\n| `logs trace` | Find logs for a distributed trace |\n| `logs context` | Get logs before/after a timestamp |\n| `logs patterns` | Group similar log messages |\n| `logs compare` | Compare log counts between periods |\n| `logs multi` | Run multiple queries in parallel |\n| `logs agg` | Aggregate logs by facet |\n| `metrics query` | Query timeseries metrics |\n| `errors` | Quick error summary by service/type |\n| `services` | List services with log activity |\n| `dashboards` | Manage dashboards (CRUD) |\n| `dashboard-lists` | Manage dashboard lists |\n\n\n## Quick Examples\n\n### Search Errors\n```bash\nnpx @leoflores/datadog-cli logs search --query \"status:error\" --from 1h --pretty\n```\n\n### Tail Logs (Real-time)\n```bash\nnpx @leoflores/datadog-cli logs tail --query \"service:api status:error\" --pretty\n```\n\n### Error Summary\n```bash\nnpx @leoflores/datadog-cli errors --from 1h --pretty\n```\n\n### Trace Correlation\n```bash\nnpx @leoflores/datadog-cli logs trace --id \"abc123def456\" --pretty\n```\n\n### Query Metrics\n```bash\nnpx @leoflores/datadog-cli metrics query --query \"avg:system.cpu.user{*}\" --from 1h --pretty\n```\n\n### Compare Periods\n```bash\nnpx @leoflores/datadog-cli logs compare --query \"status:error\" --period 1h --pretty\n```\n\n## Global Flags\n\n| Flag | Description |\n|------|-------------|\n| `--pretty` | Human-readable output with colors |\n| `--output <file>` | Export results to JSON file |\n| `--site <site>` | Datadog site (e.g., `datadoghq.eu`) |\n\n## Time Formats\n\n- **Relative**: `30m`, `1h`, `6h`, `24h`, `7d`\n- **ISO 8601**: `2024-01-15T10:30:00Z`\n\n## Incident Triage Workflow\n\n```bash\n# 1. Quick error overview\nnpx @leoflores/datadog-cli errors --from 1h --pretty\n\n# 2. Is this new? Compare to previous period\nnpx @leoflores/datadog-cli logs compare --query \"status:error\" --period 1h --pretty\n\n# 3. Find error patterns\nnpx @leoflores/datadog-cli logs patterns --query \"status:error\" --from 1h --pretty\n\n# 4. Narrow down by service\nnpx @leoflores/datadog-cli logs search --query \"status:error service:api\" --from 1h --pretty\n\n# 5. Get context around a timestamp\nnpx @leoflores/datadog-cli logs context --timestamp \"2024-01-15T10:30:00Z\" --service api --pretty\n\n# 6. Follow the distributed trace\nnpx @leoflores/datadog-cli logs trace --id \"TRACE_ID\" --pretty\n```\n\nSee [workflows.md](references/workflows.md) for more debugging workflows.","tags":["datadog","cli","agent","toolkit","softaworks","agent-skills","automation","claude","claude-code","coding-agent","development"],"capabilities":["skill","source-softaworks","skill-datadog-cli","topic-agent-skills","topic-automation","topic-claude","topic-claude-code","topic-coding-agent","topic-development"],"categories":["agent-toolkit"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/softaworks/agent-toolkit/datadog-cli","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add softaworks/agent-toolkit","source_repo":"https://github.com/softaworks/agent-toolkit","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1689 github stars · SKILL.md body (3,296 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-03T00:52:48.808Z","embedding":null,"createdAt":"2026-04-18T21:54:26.285Z","updatedAt":"2026-05-03T00:52:48.808Z","lastSeenAt":"2026-05-03T00:52:48.808Z","tsv":"'-01':314,394 '-15':315,395 '/organization-settings/api-keys':95 '00z':318,398 '1':323 '1h':218,243,266,279,307,331,349,363,380 '2':333 '2024':313,393 '24h':309 '3':351 '30':317,397 '30m':306 '4':365 '5':382 '6':402 '6h':308 '7d':310 '8601':312 'abc123def456':253 'activ':194 'agent':34 'agg':173 'aggreg':174 'ai':33 'api':76,80,232,378,400 'app':84,88 'app.datadoghq.com':94 'app.datadoghq.com/organization-settings/api-keys':93 'around':385 'avg':263 'bash':73,99,111,209,225,238,247,257,270,322 'before/after':149 'cli':3,5,28,30,98 'color':291 'command':56,58,119,121 'compar':159,160,268,274,337,344 'context':146,384,391 'correl':246 'count':162 'crud':198 'dashboard':15,67,195,197,200,203 'dashboard-list':199 'datadog':2,4,25,27,40,106,299 'datadog-c':1 'datadoghq.eu':118,302 'dd':75,83 'debug':19,36,420 'descript':122,284 'distribut':143,405 'doc':52 'e.g':301 'environ':70 'error':183,185,208,216,234,236,241,277,325,329,347,353,361,376 'exampl':206 'export':74,82,293 'facet':177 'file':297 'filter':128 'find':139,352 'flag':110,282,283 'follow':403 'format':304 'get':90,147,383 'global':281 'group':154 'human':287 'human-read':286 'id':252,411,413 'incid':319 'iso':311 'issu':21 'json':296 'key':77,81,85,89,91 'leoflores/datadog-cli':101,113,211,227,240,249,259,272,328,342,356,371,389,408 'list':190,201,204 'log':8,41,57,114,123,126,129,132,137,140,145,148,152,156,158,161,165,172,175,193,212,221,228,250,273,343,357,372,390,409 'manag':14,196,202 'messag':157 'metric':10,43,60,178,182,256,260 'multi':166 'multipl':168 'must':47 'narrow':366 'new':336 'non':104 'non-us':103 'npx':100,112,210,226,239,248,258,271,327,341,355,370,388,407 'observ':26 'output':289,292 'overview':120,326 'parallel':171 'pattern':153,354,358 'period':164,269,278,340,348 'pretti':219,235,244,254,267,280,285,332,350,364,381,401,414 'previous':339 'product':20 'queri':9,62,116,169,179,180,214,230,255,261,262,275,345,359,374 'quick':184,205,324 'read':45,48 'readabl':288 'real':135,223 'real-tim':134,222 'refer':51 'references/dashboards.md':68 'references/logs-commands.md':59 'references/metrics.md':61 'references/query-syntax.md':64 'references/workflows.md':66,417 'relat':305 'relev':50 'request':12 'requir':44,72 'result':294 'run':96,167 'search':7,115,124,125,207,213,373 'see':415 'servic':189,191,231,369,377,399 'service/type':188 'setup':69 'similar':155 'site':107,109,117,298,300 'skill' 'skill-datadog-cli' 'source-softaworks' 'status':215,233,276,346,360,375 'stream':131 'summari':186,237 'syntax':63 'system.cpu.user':264 't10':316,396 'tail':130,220,229 'time':136,224,303 'timeseri':181 'timestamp':151,387,392 'tool':31 'topic-agent-skills' 'topic-automation' 'topic-claude' 'topic-claude-code' 'topic-coding-agent' 'topic-development' 'trace':11,138,144,245,251,406,410,412 'triag':38,320 'us':105 'use':16,39,54,108 'variabl':71 'work':23 'workflow':65,321,421 'workflows.md':416 'your-api-key':78 'your-app-key':86","prices":[{"id":"b6a30b19-45e6-40fa-9151-fd57f947bbf8","listingId":"e1066b84-22ef-42d0-b70c-c3f466f334a2","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"softaworks","category":"agent-toolkit","install_from":"skills.sh"},"createdAt":"2026-04-18T21:54:26.285Z"}],"sources":[{"listingId":"e1066b84-22ef-42d0-b70c-c3f466f334a2","source":"github","sourceId":"softaworks/agent-toolkit/datadog-cli","sourceUrl":"https://github.com/softaworks/agent-toolkit/tree/main/skills/datadog-cli","isPrimary":false,"firstSeenAt":"2026-04-18T21:54:26.285Z","lastSeenAt":"2026-05-03T00:52:48.808Z"}],"details":{"listingId":"e1066b84-22ef-42d0-b70c-c3f466f334a2","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"softaworks","slug":"datadog-cli","github":{"repo":"softaworks/agent-toolkit","stars":1689,"topics":["agent-skills","ai","automation","claude","claude-code","coding-agent","development"],"license":"mit","html_url":"https://github.com/softaworks/agent-toolkit","pushed_at":"2026-03-05T16:46:24Z","description":"A curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.","skill_md_sha":"b1cc94ebcee47a694caccfedd058371dfbec3827","skill_md_path":"skills/datadog-cli/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/softaworks/agent-toolkit/tree/main/skills/datadog-cli"},"layout":"multi","source":"github","category":"agent-toolkit","frontmatter":{"name":"datadog-cli","description":"Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards. Use this when debugging production issues or working with Datadog observability."},"skills_sh_url":"https://skills.sh/softaworks/agent-toolkit/datadog-cli"},"updatedAt":"2026-05-03T00:52:48.808Z"}}