用途:管理 Datadog 监控器(Monitor),用于创建、查询和维护告警规则。
主要能力:列出监控器(pup monitors list,可按标签过滤如 --tags "team:platform")、获取单个监控器(pup monitors get <id>)、按文件创建监控器(pup monitors create --file monitor.json)。静默告警通过 downtime 实现:pup downtime create --file downtime.json,取消用 pup downtime cancel <downtime_id>;资料说明没有 pup monitors mute/unmute 命令。
使用方式:需先将 pup 加入 PATH,先执行 pup auth login 登录。命令执行遵循令牌高效顺序:先检查上下文,缺值先运行发现命令,仍不明确则询问用户,再运行目标命令,避免易失败的推测命令。
最佳实践:避免告警疲劳,使用 last_Xm 而非 last_1m,阈值基于 SLO,消息中包含 runbook 链接;合理限定作用域(如 env:prod,service:api by {host});设置恢复阈值(critical_recovery、warning_recovery)防止抖动;消息中附上下文与通知目标。删除监控器不应直接删除,而应安全标记为 [MARKED FOR DELETION]。
监控器类型包括 metric alert、query alert、service check、event alert、log alert、composite、apm。可用 jq 审计无归属或高告警量的监控器。
限制:依赖 pup 工具;静默需用 downtime 而非 mute;资料未提供具体收费、平台支持范围及完整安装步骤。