Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards. Use this when debugging production issues or working with Datadog observability.
Use the skills CLI to install this skill with one command. Auto-detects all installed AI assistants.
Method 1 - skills CLI
npx skills i softaworks/agent-toolkit/skills/datadog-cliMethod 2 - openskills (supports sync & update)
npx openskills install softaworks/agent-toolkitAuto-detects Claude Code, Cursor, Codex CLI, Gemini CLI, and more. One install, works everywhere.
Installation Path
Download and extract to one of the following locations:
No setup needed. Let our cloud agents run this skill for you.
Select Provider
Select Model
Best for coding tasks
Environment setup included
A CLI tool for AI agents to debug and triage using Datadog logs and metrics.
You MUST read the relevant reference docs before using any command:
export DD_API_KEY="your-api-key"
export DD_APP_KEY="your-app-key"Get keys from: https://app.datadoghq.com/organization-settings/api-keys
npx @leoflores/datadog-cli <command>For non-US Datadog sites, use --site flag:
npx @leoflores/datadog-cli logs search --query "*" --site datadoghq.eu| 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 |
npx @leoflores/datadog-cli logs search --query "status:error" --from 1h --prettynpx @leoflores/datadog-cli logs tail --query "service:api status:error" --prettynpx @leoflores/datadog-cli errors --from 1h --prettynpx @leoflores/datadog-cli logs trace --id "abc123def456" --prettynpx @leoflores/datadog-cli metrics query --query "avg:system.cpu.user{*}" --from 1h --prettynpx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty| Flag | Description |
|---|---|
--pretty | Human-readable output with colors |
--output <file> | Export results to JSON file |
--site <site> | Datadog site (e.g., datadoghq.eu) |
30m, 1h, 6h, 24h, 7d2024-01-15T10:30:00Z# 1. Quick error overview
npx @leoflores/datadog-cli errors --from 1h --pretty
# 2. Is this new? Compare to previous period
npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty
# 3. Find error patterns
npx @leoflores/datadog-cli logs patterns --query "status:error" --from 1h
See workflows.md for more debugging workflows.
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 |