SuperAPI AI 工具集

distributed-tracing

通用与其它

查看项目

更新于 10-15 23:39

技能介绍

用途:跨服务追踪单个请求,诊断延迟与错误传播,或为新集成添加可观测边界。适合在有服务拓扑与暂存请求的前提下,梳理一条用户旅程并落地追踪。

前提与输入:需记录已安装的 SDK 与后端版本、允许采集器端点、服务依赖图和一个暂存环境请求。选择导出器 API 或部署配置前,应先查阅已安装版本对应的主要文档。该技能不负责安装追踪后端。

主要做法:先阅读 resources/implementation-playbook.md,确定一条用户旅程;在加载被插桩框架前配置匹配的 OpenTelemetry SDK 与 OTLP 导出器,并参考 references/instrumentation.md 处理上下文传播、关闭刷新与隐私检查;按 references/jaeger-setup.md 配置 Jaeger,或沿用现有 Tempo/采集器部署所支持的配置,部署前检查监听、认证、传输保护、存储与保留策略。

上下文需在 HTTP 与异步消息间传播,使用稳定操作名与白名单属性,不记录凭证、原始请求体或敏感查询值。分别发送成功与失败的暂存请求,在后端确认 span 已连通,记录服务标识、父子关系、时长单位与导出器错误。测量队列丢失与开销后再决定采样;固定百分比不保证覆盖率或性能。

验证要点:每个被验证边界(含队列消费者)都有真实追踪证据;仅使用允许字段且属性基数有界;观察到关闭刷新与导出器失败行为;访问、存储与保留策略独立于 UI 可用性单独核查。

限制:头部采样可能在尾部采样看到错误前就将其丢弃;内存演示不能证明持久存储;上下文传播与跨服务时钟需真实集成测试;该指南并非可运行的多服务应用。