pup 是 Datadog 的命令行工具，用于在终端中执行 Datadog API 操作，支持 OAuth2 与 API Key 两种认证方式。
用途：查询与操作 Datadog 各类可观测性资源，便于脚本化与自动化。
主要能力：日志搜索与聚合（pup logs search、pup logs aggregate）；指标查询与列表（pup metrics query、pup metrics list）；APM 服务与依赖（pup apm services list/stats/operations/resources、pup apm dependencies list）；链路搜索与聚合（pup traces search、pup traces aggregate）；监控器增删改查（pup monitors list/get/search/create/update/delete）；事件、事故、仪表盘、SLO、合成测试、停机、基础设施主机、用户与值班团队、安全信号与规则、服务目录、笔记本、可观测性管道、LLM 可观测性、参考表、成本云配置等。还提供 Live Debugger 探针创建与监听（pup debugger probes create/watch/list/delete）及符号库搜索（pup symdb search）。
安装：brew tap datadog-labs/pack && brew install pup；或 cargo install --git https://github.com/DataDog/pup。
认证：pup auth login（OAuth2 浏览器流程）、pup auth status、pup auth refresh、pup auth logout。无浏览器环境可设置 DD_API_KEY、DD_APP_KEY、DD_SITE。
限制：OAuth2 令牌约 1 小时过期，命令返回 401/403 时先执行 pup auth refresh，失败再 pup auth login；403 可能为应用密钥权限不足；404 需核对资源 ID；触发限流时应在调用间增加延迟。站点通过 DD_SITE 指定，如 datadoghq.com、datadoghq.eu、us3.datadoghq.com、us5.datadoghq.com、ap1.datadoghq.com、ddog-gov.com。