Datadog Cli

作者 softaworks3027f20f3181无许可证2.5K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库7个月前更新

Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards. Use this when debugging production issues or working with Datadog observability.

仅含说明DevOps & Cloud
AI 生成的概览

指导 AI 代理使用 Datadog CLI 搜索日志、查询指标、追踪请求并管理仪表板。

功能
该技能提供通过 npx 操作 Datadog 命令行工具的说明和参考文档。内容涵盖日志搜索、实时跟踪、链路追踪关联、上下文查询、模式分组、时段对比、聚合、指标查询、错误摘要、服务列表以及仪表板管理。文档还说明了所需的环境变量、全局参数、时间格式和事故排查流程。
适用场景
适用于借助 Datadog 可观测性数据调试或排查生产问题,或代理需要搜索日志、查询指标、查看仪表板时。它面向事故调查和运维排障,而非一般编码任务。
运行要求
需要 Node.js 与 npx 来运行 Datadog CLI 包,需要访问 Datadog 的网络连接,并需设置 DD_API_KEY 和 DD_APP_KEY 环境变量。非美国站点需使用 --site 参数。不附带脚本,仅为说明与参考文档。

Datadog CLI

A CLI tool for AI agents to debug and triage using Datadog logs and metrics.

Required Reading

You MUST read the relevant reference docs before using any command:

  • Log Commands [blocked]
  • Metrics [blocked]
  • Query Syntax [blocked]
  • Workflows [blocked]
  • Dashboards [blocked]

Setup

Environment Variables (Required)

bash
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

Running the CLI

bash
npx @leoflores/datadog-cli <command>

For non-US Datadog sites, use --site flag:

bash
npx @leoflores/datadog-cli logs search --query "*" --site datadoghq.eu

Commands Overview

CommandDescription
logs searchSearch logs with filters
logs tailStream logs in real-time
logs traceFind logs for a distributed trace
logs contextGet logs before/after a timestamp
logs patternsGroup similar log messages
logs compareCompare log counts between periods
logs multiRun multiple queries in parallel
logs aggAggregate logs by facet
metrics queryQuery timeseries metrics
errorsQuick error summary by service/type
servicesList services with log activity
dashboardsManage dashboards (CRUD)
dashboard-listsManage dashboard lists

Quick Examples

Search Errors

bash
npx @leoflores/datadog-cli logs search --query "status:error" --from 1h --pretty

Tail Logs (Real-time)

bash
npx @leoflores/datadog-cli logs tail --query "service:api status:error" --pretty

Error Summary

bash
npx @leoflores/datadog-cli errors --from 1h --pretty

Trace Correlation

bash
npx @leoflores/datadog-cli logs trace --id "abc123def456" --pretty

Query Metrics

bash
npx @leoflores/datadog-cli metrics query --query "avg:system.cpu.user{*}" --from 1h --pretty

Compare Periods

bash
npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty

Global Flags

FlagDescription
--prettyHuman-readable output with colors
--output <file>Export results to JSON file
--site <site>Datadog site (e.g., datadoghq.eu)

Time Formats

  • Relative: 30m, 1h, 6h, 24h, 7d
  • ISO 8601: 2024-01-15T10:30:00Z

Incident Triage Workflow

bash
# 1. Quick error overviewnpx @leoflores/datadog-cli errors --from 1h --pretty
# 2. Is this new? Compare to previous periodnpx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty
# 3. Find error patternsnpx @leoflores/datadog-cli logs patterns --query "status:error" --from 1h --pretty
# 4. Narrow down by servicenpx @leoflores/datadog-cli logs search --query "status:error service:api" --from 1h --pretty
# 5. Get context around a timestampnpx @leoflores/datadog-cli logs context --timestamp "2024-01-15T10:30:00Z" --service api --pretty
# 6. Follow the distributed tracenpx @leoflores/datadog-cli logs trace --id "TRACE_ID" --pretty

See workflows.md [blocked] for more debugging workflows.

来源与署名

来源:softaworks/agent-toolkit位于skills/datadog-cli提交3027f20

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架