10.3. Debezium ログの設定

手順

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

   additivity を無効にします。これにより、ログメッセージが親ロガーのアペンダーに送信されなくなります (これにより、複数のアペンダーを使用する際に、ログメッセージが重複して表示されるのを防ぐことができます)。

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

   コネクター全体のログレベルを上げるとログがより煩雑になり、状況を把握するのが困難になる場合があります。このような場合は、トラブルシューティングを行う問題に関連するクラスのサブセットのログレベルだけを変更することができます。

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

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

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

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

   4. 識別したそれぞれの Java クラスのロガーを設定します。

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

      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
      ...