Jaeger 分布式追踪 5 分钟完整指南从接入 Trace 到 RED 性能指标一站跑通【免费下载链接】jaegerCNCF Jaeger, a Distributed Tracing Platform项目地址: https://gitcode.com/GitHub_Trending/ja/jaegerJaeger 是 CNCF 毕业级的分布式追踪平台负责接收 OpenTelemetry 上报的链路数据存入可插拔的存储后端并提供 UI 完成 trace 搜索、对比与 RED 性能指标查看帮你快速定位微服务架构里的瓶颈与错误来源。一次慢请求的排查困境想象一个订单接口平均耗时 800ms但你只有四个服务的日志文件。你拿着 request ID 在日志里逐条翻发现 frontend 等 driver 花了 600ms可 driver 的日志又指向 customer 服务——翻到第三跳时间线已经对不上了。你缺的不是日志而是一张把每个请求在各服务间的耗时、错误状态完整串起来的链路图。这正是 Jaeger 解决的问题每个请求生成唯一 Trace ID所有服务的 span 按时间轴拼回慢在哪一跳、哪一跳报了错一眼可见。架构思路把 trace 生命周期拆成四层可独立配置的单元Jaeger v2 不再从零造轮子而是复用 OpenTelemetry Collector 的组件体系把一条 trace 的生命周期拆成四段接收receiver、处理processor、导出exporter、查询query service UI。每段都是独立单元通过一个 YAML 文件声明式组装——你可以只换掉存储导出器而不动接收端也可以只加一个采样 processor 而不改后端。仓库里 cmd/jaeger/config.yaml 就是一个完整的最小配置样本。核心能力拆解三种上报协议共用一条流水线OTLP、Jaeger 原生协议、Zipkin 三类 receiver 可同时在一条 traces 流水线中声明旧系统用 Zipkin 上报、新系统用 OTel SDK 上报可以并存接入方不需要统一改造。六种存储后端按场景切换内存开发调试、Badger单机轻量、Elasticsearch、OpenSearch、Cassandra、ClickHouse大规模生产。后端能力会启动时自动通告给 UI不支持的功能直接隐藏。各后端的参考配置就在 cmd/jaeger/ 目录下如config-cassandra.yaml、config-clickhouse.yaml。从 span 数据直接算出 RED 性能指标SPMService Performance Monitoring功能把 span 数据聚合成请求量、错误率、延迟三类 RED 指标在 UI 的 Monitor 标签页以图表呈现也提供 HTTP API 供外部系统调用。它还能跳过 Prometheus直接从 Elasticsearch/OpenSearch 里的 trace 存储查询指标省掉一套指标存储。详细说明见 docker-compose/monitor/README.md。自适应采样控制数据成本生产环境的 span 量可能压垮存储。adaptive_sampling processor 会根据当前流量与采样率动态调整remote_sampling扩展把策略下发给 SDK端上就能少采。策略可以是静态 JSON 文件也可以是自适应计算见 sampling-strategies.json。完整实操走查从零到看到第一条 trace 以下走查基于仓库自带的 monitor 演示环境它会拉起 Jaeger、模拟流量、Prometheus 和 Grafana 一整条链路不需要你准备真实应用。第一步拿到仓库git clone https://gitcode.com/GitHub_Trending/ja/jaeger cd jaeger/docker-compose/monitor第二步启动完整链路docker compose up这个 docker-compose.yml 会启动四个容器Jaeger all-in-one挂载 config-spm.yaml 作为配置、MicroSim持续生成模拟 span、Prometheus、Grafana。MicroSim 每 500ms 发一条 span 到 OTLP HTTP 端口 4318稍等一两分钟积累数据即可。第三步主动注入一条 trace 并到 UI 查看docker run --env OTEL_EXPORTER_OTLP_TRACES_ENDPOINThttp://jaeger:4318/v1/traces \ --network monitor_backend --rm jaegertracing/jaeger-tracegen:latest \ -trace-exporter otlp-http -traces 1tracegen 是仓库内置的链路生成器cmd/tracegen/。打开 http://localhost:16686/ 在 Search 页把 Service 选为tracegen点击 Find Traces就能看到带时间轴分布和 span 明细的搜索结果第四步切换 Monitor 标签看 RED 指标进入 http://localhost:16686/monitor 选择tracegen服务页面会展示延迟含 P95/P90/P50 分位、错误率、请求速率三张图以及每个 operation 的 Impact 排序——哪个接口对整体性能影响最大这里比翻 trace 更快想验证数据链路是否真的走通还可以打开 Grafanahttp://localhost:3000 已预置 Jaeger mixin 看板查看 Prometheus 侧的原始指标。配置与调优建议配置项调整位置为什么memory 后端max_traces配置文件 storage 段内存后端无淘汰压力时 trace 会无限堆积开发环境建议限制在 10 万左右initial_sampling_probabilityremote_sampling 扩展自适应采样的起点值流量大时调低可显著减少存储写入但会损失低频请求细节SPANMETRICS_FLUSH_INTERVAL环境变量RED 指标的聚合刷新间隔调小则 Monitor 页更新更及时调大降低计算开销查询参数lookback/stepUI 或 HTTP API时间窗与数据点粒度直接决定后端压力排查历史问题时别默认开 1 小时窗口 1ms 步长社区参与Jaeger 由 CNCF 托管并采用开放治理代码、文档、issue 之外的贡献翻译、测试、反馈同样受欢迎参与方式见 README。项目遵循明确的功能弃用缓冲期与存储后端版本支持策略方便规划升级节奏。快速上手三步拉取仓库git clone https://gitcode.com/GitHub_Trending/ja/jaeger进入docker-compose/monitor目录执行docker compose up访问 http://localhost:16686/ 等 MicroSim 积累数据后查看 Search 与 Monitor 页只想要最小验证环境时一条docker run --rm -p 16686:16686 -p 4317:4317 -p 4318:4318 jaegertracing/jaeger:latest即可启动含内存存储的 all-in-one详见 README Quick Start 与 examples/hotrod/ 示例应用。现在打开终端把上面四条命令跑一遍——几分钟后你就能在自己的 Jaeger UI 里看到第一条完整 trace。核心关键词分布式追踪、Jaeger、链路搜索长尾关键词Jaeger Docker 部署、OpenTelemetry trace 接入、RED 性能监控指标、分布式追踪存储后端选型、自适应采样配置【免费下载链接】jaegerCNCF Jaeger, a Distributed Tracing Platform项目地址: https://gitcode.com/GitHub_Trending/ja/jaeger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考