ログレベル

OceanBaseデータベースのログは7つのログレベルに分類されており、その意味は以下の表のとおりです。表内のログレベルは、高いものから低いものへと順に並べられています。

SHOW PARAMETERS コマンドを使用して現在のログ出力レベルを確認できます。ログのデフォルトの出力レベルはWDIAGレベルです。

obclient> SHOW PARAMETERS LIKE '%syslog_level%';

実行結果は次のとおりです：

+-------+----------+----------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
| zone  | svr_type | svr_ip         | svr_port | name         | data_type | value | info                                                                                                                         | section  | scope   | source  | edit_level        | default_value | isdefault |
+-------+----------+----------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
| zone1 | observer | 172.xx.xxx.xxx |     2882 | syslog_level | NULL      | WDIAG | specifies the current level of logging. There are DEBUG, TRACE, WDIAG, EDIAG, INFO, WARN, ERROR, seven different log levels. | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | WDIAG         |         1 |
+-------+----------+----------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
1 row in set

OceanBaseデータベースでは、ログレベルを設定することで、より正確なターゲットログを取得できます。設定はシステムレベル、セッションレベル、ステートメントレベルの3つのレベルで行うことができ、ログ出力時の優先順位は高いものから順にステートメント、セッション、システムとなります。また、OceanBaseデータベースではモジュールごとの設定もサポートされています。

• システムレベル：クラスタ全体のすべてのOBServerに適用されます。システムテナントでのみ設定可能です。
• セッションレベル：現在のテナントがクラスタ内で存在するOBServerに適用されます。
  • セッションレベルの変数の設定は、現在のセッションにのみ有効であり、他のセッションには無効です。
  • グローバルレベルの変数の設定は、現在のセッションには無効であり、再ログインして新しいセッションを作成する必要がある場合にのみ有効になります。
• ステートメントレベル：現在実行されているステートメントが存在するOBServerに適用されます。SQLステートメントの実行期間中のみ有効です。

以下は、システムレベル、セッションレベル、ステートメントレベルの3つのレベルでログ出力レベルを設定する具体的な方法です。

• システムレベルでログモジュールのレベルを設定します。

  次の2つの方法で設定できます：

  • システム構成パラメータ syslog_level を使用して、システムレベルのログレベルを設定します。例えば、SQLモジュールのログレベルを debug に設定し、COMMONモジュールのログレベルを error に設定します。

      obclient > ALTER SYSTEM SET syslog_level='sql.*:debug, common.*:error';
    

  • OSの bash kill -41/42 $pid コマンドを使用して、システムレベルのログレベルを設定します。

    kill -41 はプログラムログのレベルを下げるために使用されます。例えば、現在のプログラムログのレベルがINFOの場合、kill -41 を実行すると、レベルはTRACEに低下します。kill -42 はプログラムログのレベルを上げるために使用されます。例えば、現在のプログラムログのレベルがINFOの場合、kill -42 を実行すると、レベルはWARNに引き上げられます。

    システム構成パラメータ syslog_level を使用して、システムレベルのログレベルを設定することを推奨します。OceanBaseデータベースは設定のリフレッシュ時に、config ファイル(OceanBaseのインストールディレクトリ内の etc/observer.config.bin)に設定されている syslog_level をインポートするため、kill方式は無効になります。

    注意

    kill -41/kill -42 を使用してログレベルを調整することは、SQLクライアントからOceanBaseクラスタにログインできない場合にのみ推奨されます。

• セッションレベルでログモジュールのレベルを設定します。

  システム変数 ob_log_level を使用して、セッションレベルのログレベルを設定します。例えば、SQLモジュールのログレベルを debug に設定し、COMMONモジュールのログレベルを info に設定します。

  obclient > SET @@ob_log_level='sql.*:debug, common.*:info';
  

• ステートメントレベルでログモジュールのレベルを設定します。

  Hintを使用して、ステートメントレベルのログレベルを設定できます。例えば、SQLモジュールのログレベルを debug に設定し、COMMONモジュールのログレベルを info に設定します。その他のHintステートメントに関する詳細については、Optimizer Hintを参照してください。

  obclient > SELECT /*+log_level('sql.*:debug, common.*:info')*/ * FROM t;
  

  説明

  MySQLのCクライアントを使用してHint付きのSQLステートメントを実行する場合、-c オプションを使用してログインする必要があります。そうしないと、MySQLクライアントはHintをユーザーのSQLステートメントからコメントとして削除し、システムはユーザーのHintを受け取ることができません。