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 從公開儲存庫中收錄這些內容。

檢舉或申請下架