datadog-cli

# Datadog CLI 供 AI 智能体使用 Datadog 日志和指标进行调试和分类的 CLI 工具。 ## 必读内容 **在使用任何命令之前，你必须阅读相关的参考文档：** - [日志命令](references/logs-commands.md) - [指标](references/metrics.md) - [查询语法](references/query-syntax.md) - [工作流](references/workflows.md) - [仪表板](references/dashboards.md) ## 设置 ### 环境变量 (必需) bash export DD_API_KEY="your-api-key" export DD_APP_KEY="your-app-key" 从此处获取密钥：https://app.datadoghq.com/organization-settings/api-keys ### 运行 CLI bash npx @leoflores/datadog-cli 对于非美国地区的 Datadog 站点，请使用 `--site` 标志： bash npx @leoflores/datadog-cli logs search --query "*" --site datadoghq.eu ## 命令概览 | 命令 | 描述 | |---------|-------------| | `logs search` | 使用过滤器搜索日志 | | `logs tail` | 实时流式传输日志 | | `logs trace` | 查找分布式链路的日志 | | `logs context` | 获取时间戳前后的日志 | | `logs patterns` | 对相似日志消息进行分组 | | `logs compare` | 比较不同周期的日志计数 | | `logs multi` | 并行运行多个查询 | | `logs agg` | 按 facet 聚合日志 | | `metrics query` | 查询时间序列指标 | | `errors` | 按服务/类型快速汇总错误 | | `services` | 列出有日志活动的服务 | | `dashboards` | 管理仪表板 (CRUD) | | `dashboard-lists` | 管理仪表板列表 | ## 快速示例 ### 搜索错误 bash npx @leoflores/datadog-cli logs search --query "status:error" --from 1h --pretty ### 实时日志追踪 bash npx @leoflores/datadog-cli logs tail --query "service:api status:error" --pretty ### 错误摘要 bash npx @leoflores/datadog-cli errors --from 1h --pretty ### 链路关联 bash npx @leoflores/datadog-cli logs trace --id "abc123def456" --pretty ### 查询指标 bash npx @leoflores/datadog-cli metrics query --query "avg:system.cpu.user{*}" --from 1h --pretty ### 比较周期 bash npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty ## 全局标志 | 标志 | 描述 | |------|-------------| | `--pretty` | 彩色易读输出 | | `--output ` | 将结果导出为 JSON 文件 | | `--site ` | Datadog 站点 (例如 `datadoghq.eu`) | ## 时间格式 - **相对时间**: `30m`, `1h`, `6h`, `24h`, `7d` - **ISO 8601**: `2024-01-15T10:3