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

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

   2

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

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