Datadog 追踪查询代理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/datadog-apm-trace-query-agent。
技能介绍
解决什么问题
微服务架构里,一次请求往往横跨多个服务。当延迟告警响起,在 UI 里逐条翻看 span 既慢又容易漏掉关键路径;分面条件散落在多张筛选器里,手工拼查询很容易跑偏。这个技能面向已接入 Datadog APM 的 Node.js 服务,让你直接通过 Trace Search API 查询分布式追踪,而不是依赖鼠标点击拼条件。
核心能力
- 分面过滤:按服务、操作、标签等维度筛选 trace,快速缩小排查范围
- p99 延迟分解:在服务跨度中定位拉高尾部延迟的具体 span
- 慢查询识别:通过
db.statement标签筛出拖慢请求的数据库语句
工作方式
- 向 Trace Search API 提交带分面条件的查询请求
- 对命中的 trace 做聚合分析,聚焦 p99 尾部延迟来源
- 在 span 上按
db.statement标签过滤,定位具体慢 SQL
适用边界
- 前提是应用已接入 Datadog APM 并持续产生追踪数据
- 数据由
dd-traceTracer 采集,覆盖范围以 Node.js 应用为主 - 尾部延迟分析的粒度取决于采样策略,低采样下长尾 span 可能缺失
使用场景
- 微服务接口 p99 延迟突增时,需要在 Datadog APM 中按服务和操作做分面过滤,定位拖累延迟的 span
- 排查慢数据库查询,需要按 db.statement 标签筛选 span,找出执行缓慢的 SQL 语句
- 收到 APM 告警后,需要用 Trace Search API 拉取完整分布式追踪,还原跨服务调用路径
- 优化服务性能时,需要拆解服务跨度的 p99 延迟构成,确认时间消耗在网络还是数据库调用上
适合人员
- 负责线上服务稳定性的后端工程师,需要在告警发生时快速定位跨服务调用的性能瓶颈
- 专注应用性能优化的 SRE,需要通过尾延迟分析找出拉高 p99 的具体 span
- 负责数据库性能调优的工程师,需要按 db.statement 标签筛出拖慢接口的慢 SQL
- 搭建 APM 可观测体系的运维工程师,需要确认 dd-trace Tracer 采集的追踪数据能否支撑 trace 查询