mcpField
D
datadog-cli

datadog-cli

github.com/davila7云与 DevOps33.0k334 次安装1 天前更新
代码仓库

关于 datadog-cli

Datadog CLI 是供 AI Agent 和运维人员排查 Datadog 日志与指标的命令行工具，包含日志搜索和分诊、指标查询以及仪表板管理功能。

主要功能

  1. 01搜索和实时查看日志
  2. 02将日志关联到分布式跟踪
  3. 03比较并聚合日志结果
  4. 04查询时间序列指标
  5. 05管理仪表板及其列表

适用场景

  1. 01分诊近期服务错误
  2. 02比较不同时段的错误数量
  3. 03查找与跟踪关联的日志
  4. 04排查时检查服务指标

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davila7/claude-code-templates --skill datadog-cli

安装后在 Claude Code 中输入/datadog-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
dashboards.md
logs-commands.md
metrics.md
query-syntax.md
workflows.md

详细介绍

Datadog CLI

供 AI Agent 使用 Datadog 日志和指标进行调试与问题排查的 CLI 工具。

必读文档

使用任何命令前，你必须阅读相关参考文档：

设置

环境变量（必需）
export DD_API_KEY="your-api-key"
export DD_APP_KEY="your-app-key"

从此处获取密钥：https://app.datadoghq.com/organization-settings/api-keys

运行 CLI
npx @leoflores/datadog-cli <command>

对于非美国地区的 Datadog 站点，请使用 --site 标志：

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管理仪表板列表

快速示例

搜索错误
npx @leoflores/datadog-cli logs search --query "status:error" --from 1h --pretty
实时查看日志
npx @leoflores/datadog-cli logs tail --query "service:api status:error" --pretty
错误摘要
npx @leoflores/datadog-cli errors --from 1h --pretty
跟踪关联
npx @leoflores/datadog-cli logs trace --id "abc123def456" --pretty
查询指标
npx @leoflores/datadog-cli metrics query --query "avg:system.cpu.user{*}" --from 1h --pretty
比较时段
npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty

全局标志

标志描述
--pretty使用颜色输出易于阅读的内容
--output <file>将结果导出到 JSON 文件
--site <site>Datadog 站点（例如，datadoghq.eu）

时间格式

  • 相对时间：30m、1h、6h、24h、7d
  • ISO 8601：2024-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 --pretty

# 4. Narrow down by service
npx @leoflores/datadog-cli logs search --query "status:error service:api" --from 1h --pretty

# 5. Get context around a timestamp
npx @leoflores/datadog-cli logs context --timestamp "2024-01-15T10:30:00Z" --service api --pretty

# 6. Follow the distributed trace
npx @leoflores/datadog-cli logs trace --id "TRACE_ID" --pretty

更多调试工作流请参阅 workflows.md。

评论

支持 Markdown