19.4. Kafka Connect のトレースの有効化
設定プロパティーを使用して Kafka Connect の分散トレースを有効にします。Kafka Connect により生成および消費されるメッセージのみがトレースされます。Kafka Connect と外部システム間で送信されるメッセージをトレースするには、これらのシステムのコネクターでトレースを設定する必要があります。
OpenTelemetry を使用したトレースを有効にできます。
手順
-
トレースアーティファクトを
opt/kafka/libsディレクトリーに追加します。 関連する Kafka Connect 設定ファイルでプロデューサーとコンシューマーのトレースを設定します。
-
Kafka Connect をスタンドアロンモードで実行している場合は、
./config/connect-standalone.propertiesファイルを編集します。 -
Kafka Connect を分散モードで実行している場合は、
./config/connect-distributed.propertiesファイルを編集します。
次のトレースインターセプタープロパティーを設定ファイルに追加します。
OpenTelemetry のプロパティー
producer.interceptor.classes=io.opentelemetry.instrumentation.kafkaclients.TracingProducerInterceptor consumer.interceptor.classes=io.opentelemetry.instrumentation.kafkaclients.TracingConsumerInterceptorトレースを有効にすると、Kafka Connect スクリプトの実行時にトレースを初期化します。
-
Kafka Connect をスタンドアロンモードで実行している場合は、
- 設定ファイルを作成します。
- トレースの 環境変数 を設定します。
設定ファイルをパラメーター (およびコネクターのプロパティー) として使用して、スタンドアロンまたは分散モードで Kafka Connect を開始します。
スタンドアロンモードでの Kafka Connect の実行
./bin/connect-standalone.sh \ ./config/connect-standalone.properties \ connector1.properties \ [connector2.properties ...]分散モードでの Kafka Connect の起動
./bin/connect-distributed.sh ./config/connect-distributed.propertiesKafka Connect の内部コンシューマーとプロデューサーがトレースできるようになりました。