SuperAPI AI 工具集

dd-logs

通用与其它

查看项目

更新于 10-16 05:05

技能介绍

用途:通过命令行管理 Datadog 日志,涵盖搜索、管线处理、归档与成本控制,是 datadog/pup 提供的一项技能。

前提:需已安装 Datadog Pup,命令为 cargo install --git https://github.com/DataDog/pup;随后使用 pup auth login 登录。

搜索:使用 pup logs search,例如 --query="status:error" --from="1h",可加 --limit 100;默认输出 JSON。支持的查询语法包括全文搜索(error)、标签或属性等值(status:error、@http.status_code:500)、数值范围(@http.status_code:>=400)、布尔组合(AND)、通配(@message:timeout)。

管线:pup obs-pipelines list 列出,pup obs-pipelines create --file pipeline.json 创建(JSON)。常用处理器包括 grok-parser、status-remapper、attribute-remapper 等。

成本控制:通过排除过滤器只索引必要内容,例如按 status:debug 过滤;可用 pup logs search 结合 jq 统计高频来源。归档用 pup logs archives list 查看,配置支持 S3 等目标,并可设置 rehydration_tags。还可用 pup logs metrics list 查看基于日志的指标,注意分组仅用有限基数值以控制基数。

敏感数据:可用 hash-remapper 等规则脱敏;官方示例建议在应用侧对信用卡号、SSN 等先行清洗。

限制与说明:在 Datadog UI 中显示关联 trace 的日志,其 dd.trace_id / dd.span_id 可能不会出现在 API 结果中,原因是 trace ID 重映射后源属性被移除并存为内部属性,这是 Datadog 的预期行为,不必重试查询或改动埋点;临时办法是改用未被重映射的独立属性(如 @custom.trace_id),或通过 pup traces search 按服务与时间窗口反查。更多语法、管线、排除过滤器与归档的细节参见官方文档。定价、适用平台等信息暂未提供。