Agent Skills
返回列表
🔒

OpenTelemetry 追踪分析器

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 的指南,在 AI 助手中安装规范名为 @user_3c6cb52e/opentelemetry-trace-analyzer 的技能。

技能介绍

解决什么问题

当生产环境中的请求跨越多个微服务时,定位性能瓶颈往往像在迷宫中寻找出口。开发者常面临这样的困境:用户反馈某个接口响应变慢,但日志分散在 Loki,追踪数据存在 Jaeger 或 Tempo,两者缺乏直接关联。手动比对 trace_id 不仅耗时,还可能遗漏关键上下文。

技能如何工作

该工具通过统一接口直接查询 Jaeger 和 Tempo 的分布式追踪数据,支持 gRPC 和 HTTP 两种协议。核心工作流分为三步:

  • 追踪数据提取:通过 OpenTelemetry Collector 的 processors 模块,按服务名、时间范围或标签过滤追踪数据,支持分页和采样率调整。
  • 瓶颈分析:基于延迟阈值自动标记异常 span,例如超过 500ms 的数据库调用或跨区域 HTTP 请求,生成可视化调用链。
  • 日志关联:通过 trace_id 和 span_id 作为关联键,从 Loki 中提取同上下文的日志流,将错误堆栈或异常信息附加到对应 span 下方。

适用边界与注意点

  • 网络连通性:需要确保工具所在环境能访问 Jaeger/Tempo 的 gRPC 端口(默认 4315)和 HTTP API 端口(默认 16686/3300),且网络策略允许跨命名空间调用。
  • 数据保留策略:追踪数据的保留时间直接影响查询范围,若 Tempo 仅保留 7 天数据,则无法分析更早的性能问题。
  • 性能开销:在高吞吐量场景(如每秒数万请求)下,全量拉取追踪数据可能导致内存压力,建议启用分页查询(limit 参数)或提前配置采样率。
  • 处理器配置:自定义 OpenTelemetry Collector 的 processors 时(如添加 tail_sampling),需确保规则与业务逻辑匹配,避免过滤掉关键慢请求。

使用场景

  • SRE团队排查生产环境微服务接口响应慢问题,需要关联Jaeger追踪与Loki日志快速定位根因
  • DevOps工程师优化数据库查询性能时,通过OpenTelemetry Collector分析慢查询span并关联异常日志
  • 后端开发人员在跨区域微服务调用中定位延迟瓶颈,结合Tempo追踪与Loki日志验证网络抖动假设
  • 系统架构师评估微服务架构性能时,使用工具批量提取Jaeger/Tempo追踪数据并生成瓶颈热力图

适合人员

  • SRE工程师:需要跨系统关联分布式追踪与日志,快速定位生产环境性能瓶颈
  • 后端开发人员:希望在微服务架构中快速定位跨服务调用延迟问题
  • DevOps工程师:需要优化分布式系统性能时,通过追踪数据与日志关联验证优化方案
  • 系统架构师:评估微服务架构性能时,需要工具支持批量提取和分析追踪数据