用途:面向 Datadog 日志的搜索、处理与归档,强调成本意识。前置条件为已安装 Datadog Pup。
主要能力:使用 pup logs search 按查询语法检索日志,支持全文、标签、属性、数值范围、布尔与通配符查询,可指定时间范围与条数。配置类命令包括 pup logs archives list、pup logs restriction-queries list、pup logs custom-destinations list。支持处理器配置,如 grok-parser、status-remapper、attribute-remapper;支持排除过滤器以控制索引成本;支持归档到 S3 等目标;支持日志指标列表与查询;支持敏感数据脱敏规则(如 hash-remapper)。
使用方式:先执行 pup auth login 登录。搜索示例:pup logs search --query="status:error" --from="1h";带过滤:pup logs search --query="service:api status:error" --from="1h" --limit 100。命令执行建议先检查上下文,缺值先做发现命令,仍不明确再询问用户,避免易失败的推测命令。
适用场景:日志排障、成本优化(排除健康检查、调试日志、静态资源、心跳等噪声)、合规归档、基于日志生成指标。
限制:pup 0.42.0 无 pup logs rehydrate 命令,恢复需用 Datadog UI/API。日志指标分组应使用有界值以避免高基数。敏感数据应在应用侧先脱敏再发送。日志不出现需检查 agent 与管道过滤器;搜索慢可缩小时间范围或使用索引;属性缺失需检查 grok 解析器。