15.4. 为 Kafka 连接启用追踪
使用配置属性为 Kafka 连接启用分布式追踪。只有 Kafka Connect 本身生成和使用的消息才会被跟踪。要跟踪在 Kafka Connect 和外部系统间发送的消息,您必须使用那些系统的连接器配置追踪。
您可以启用使用 OpenTelemetry 或 OpenTracing 的追踪。
流程
-
在
opt/kafka/libs目录中添加追踪工件。 在相关的 Kafka Connect 配置文件中配置制作者和消费者追踪。
-
如果您以独立模式运行 Kafka 连接,请编辑
/opt/kafka/config/connect-standalone.properties文件。 -
如果您以分布式模式运行 Kafka Connect,请编辑
/opt/kafka/config/connect-distributed.properties文件。
在配置文件中添加以下追踪拦截器属性:
OpenTelemetry 的属性
producer.interceptor.classes=io.opentelemetry.instrumentation.kafkaclients.TracingProducerInterceptor consumer.interceptor.classes=io.opentelemetry.instrumentation.kafkaclients.TracingConsumerInterceptorOpenTracing 的属性
producer.interceptor.classes=io.opentracing.contrib.kafka.TracingProducerInterceptor consumer.interceptor.classes=io.opentracing.contrib.kafka.TracingConsumerInterceptor启用追踪后,您可以在运行 Kafka Connect 脚本时初始化追踪。
-
如果您以独立模式运行 Kafka 连接,请编辑
- 保存配置文件。
- 设置 用于追踪的环境变量。
使用配置文件作为参数(以及任何连接器属性)在独立或分布式模式下启动 Kafka 连接:
在独立模式下运行 Kafka 连接
su - kafka /opt/kafka/bin/connect-standalone.sh \ /opt/kafka/config/connect-standalone.properties \ connector1.properties \ [connector2.properties ...]在分布式模式下运行 Kafka 连接
su - kafka /opt/kafka/bin/connect-distributed.sh /opt/kafka/config/connect-distributed.properties现在,启用了 Kafka Connect 的内部消费者和制作者进行追踪。