jaegertracing/jaeger-agent

Jaeger Agent 镜像文档

⚠️ 已弃用
该镜像已被弃用，详情请参见 https://github.com/jaegertracing/jaeger/issues/4739%E3%80%82

镜像概述和主要用途

jaeger-agent 是一个守护进程，设计用于在每个主机上运行，负责接收应用程序通过 Jaeger 客户端库提交的分布式追踪信息，并将其转发至远程 collector 服务进行处理和存储。

核心功能和特性

1. 追踪数据接收与转发

• 通过 Thrift UDP 传输协议监听并接收应用程序提交的追踪数据（字节流）
• 内置 ThriftProcessor 处理器，通过多工作线程（N个）并发处理接收的数据
• 将原始数据转换为 Thrift 生成的对象模型，由 CollectorReporter 组件提交至远程 collector 服务

2. 采样策略管理

• 内置 HTTP 采样服务器，处理客户端采样策略查询请求（格式：http://localhost:port/sampling?service=xxxx）
• 通过 sampling.Manager 接口获取采样策略，由 sampling.CollectorProxy 实现与远程 collector 服务的交互
• 将 collector 返回的 Thrift 采样策略响应转换为 JSON 格式，返回给客户端

结构说明

Agent 组件

• Processor（ThriftProcessor）

  • Server（TBufferedServer）：基于 Thrift UDP Transport 实现的传输层服务，负责监听和接收 UDP 数据
  • Reporter（CollectorReporter）：负责将处理后的追踪跨度（spans）提交至远程 collector 服务

• UDP 数据处理流程：

  1. 监听 UDP 传输端口，接收原始字节流数据
  2. 通过通道（channel）转发至 ThriftProcessor
  3. 处理器工作线程读取通道数据，转换为 Thrift 对象模型
  4. 调用 CollectorReporter 将对象提交至 collector

采样服务器组件

• HTTP 服务：处理客户端采样策略查询请求
• 采样策略获取流程：
  1. 接收 http://localhost:port/sampling?service=xxxx 格式请求
  2. 委托 sampling.Manager（由 sampling.CollectorProxy 实现）查询远程 collector
  3. 将 collector 返回的 Thrift 响应转换为 JSON 格式
  4. 向客户端返回 JSON 格式的采样策略

使用注意事项

• 已弃用声明：该组件已正式弃用，不再推荐用于生产环境。详情请参见 Jaeger 官方说明：https://github.com/jaegertracing/jaeger/issues/4739
• 替代方案：建议迁移至 Jaeger 最新架构中的替代组件，或遵循官方文档中的升级指南。