9.2. 为 Kafka 客户端设置追踪
初始化 Jaeger tracer,以检测您的客户端应用程序以进行分布式追踪。
9.2.1. 为 Kafka 客户端初始化 Jaeger tracer 复制链接链接已复制到粘贴板!
使用一组 追踪环境变量 配置和初始化 Jaeger tracer。
流程
在每个客户端应用程序中:
将 Jaeger 的 Maven 依赖项添加到客户端应用程序的
pom.xml
文件中:<dependency> <groupId>io.jaegertracing</groupId> <artifactId>jaeger-client</artifactId> <version>1.5.0.redhat-00001</version> </dependency>
<dependency> <groupId>io.jaegertracing</groupId> <artifactId>jaeger-client</artifactId> <version>1.5.0.redhat-00001</version> </dependency>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 使用 追踪环境变量 定义 Jaeger tracer 的配置。
从您在第两个步骤中定义的环境变量创建 Jaeger tracer:
Tracer tracer = Configuration.fromEnv().getTracer();
Tracer tracer = Configuration.fromEnv().getTracer();
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意有关初始化 Jaeger tracer 的替代方法,请参阅 Java OpenTracing 库 文档。
将 Jaeger tracer 注册为全局 tracer:
GlobalTracer.register(tracer);
GlobalTracer.register(tracer);
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
现在,为要使用的客户端应用程序初始化 Jaeger tracer。
9.2.2. 用于追踪的环境变量 复制链接链接已复制到粘贴板!
在为 Kafka 客户端配置 Jaeger tracer 时使用这些环境变量。
追踪环境变量是 Jaeger 项目的一部分,可能会有所变化。有关最新的环境变量,请参阅 Jaeger 文档。
属性 | 必需 | Description |
---|---|---|
| 是 | Jaeger tracer 服务的名称。 |
| 否 |
通过 User Datagram Protocol (UDP)与 |
| 否 |
用于通过 UDP 与 |
| 否 |
|
| 否 | 以 bearer 令牌的形式发送到端点的身份验证令牌。 |
| 否 | 如果使用基本身份验证发送到端点的用户名。 |
| 否 | 如果使用基本身份验证发送到端点的密码。 |
| 否 |
用于传播 trace 上下文的以逗号分隔的格式列表。默认为标准 Jaeger 格式。有效值为 |
| 否 | 指明报告程序是否还应记录范围。 |
| 否 | 报告者的最大队列大小。 |
| 否 | 报告者的清除间隔,以 ms 为单位。定义 Jaeger reporter flushes span batches 的频率。 |
| 否 | 用于客户端 trace 的抽样策略:
要示例所有 trace,请使用 Constant sampling 策略和参数 1。 如需了解 Jaeger 架构和客户端抽样配置参数概述,请参阅 Jaeger 文档。 |
| 否 | sampler 参数(数字)。 |
| 否 | 如果选择了 Remote sampling 策略,要使用的主机名和端口。 |
| 否 | 添加到所有报告的 span 的 tracer 级别标签的逗号分隔列表。
该值也可以使用 |