7.3. ロギングの設定

手順

1. log4j.properties ファイルを開きます。

2. コネクターのロガーを設定します。

   この例では、MySQL コネクターとコネクターによって使用されるデータベース履歴実装のロガーを設定し、ログ DEBUG レベルのメッセージを設定します。

   log4j.properties

   ...
   log4j.logger.io.debezium.connector.mysql=DEBUG, stdout  1
   log4j.logger.io.debezium.relational.history=DEBUG, stdout  2
   
   log4j.additivity.io.debezium.connector.mysql=false  3
   log4j.additivity.io.debezium.relational.history=false  4
   ...

   1

   、DEBUG、、INFO WARNおよび ERROR メッセージを stdout アペンダー io.debezium.connector.mysql に送信するようにという名前のロガーを設定します。

   2

   、DEBUG、、INFO WARNおよび ERROR メッセージを stdout アペンダー io.debezium.relational.history に送信するようにという名前のロガーを設定します。

   3 4

   追加をオフにします。これは 、 ログメッセージが親ロガーの追加者に送信されないことを意味します（これにより、複数のアペンダーを使用する際に重複ログメッセージが表示されるのを防ぐことができます）。

3. 必要に応じて、コネクター内のクラスの特定のサブセットのロギングレベルを変更します。

   コネクター全体のロギングレベルを増やすと、ログの詳細レベルが高まるため、何が発生しているかを理解することが困難になる可能性があります。このような場合、トラブルシューティングを行う問題に関連するクラスのサブセットのロギングレベルを変更できます。

   1. コネクターのロギングレベルをまたはのいずれ DEBUG かに設定し TRACEます。

   2. コネクターのログメッセージを確認します。

      トラブルシューティングを行う問題に関連するログメッセージを見つけます。各ログメッセージの最後には、メッセージを生成した Java クラスの名前が表示されます。

   3. コネクターのログレベルをに設定し INFOます。

   4. 特定した各 Java クラスのロガーを設定します。

      たとえば、binlog の処理時に MySQL コネクターが一部のイベントをスキップする理由が不明なシナリオについて考えてみましょう。コネクター全体でオン DEBUG または TRACE ロギングを行うのではなく、コネクターのロギングレベルを維持 INFO し、binlog を読み取るクラス TRACE のみを設定 DEBUG または設定できます。

      log4j.properties

      ...
      log4j.logger.io.debezium.connector.mysql=INFO, stdout
      log4j.logger.io.debezium.connector.mysql.BinlogReader=DEBUG, stdout
      log4j.logger.io.debezium.relational.history=INFO, stdout
      
      log4j.additivity.io.debezium.connector.mysql=false
      log4j.additivity.io.debezium.relational.history=false
      log4j.additivity.io.debezium.connector.mysql.BinlogReader=false
      ...