MariaDBのログ:エラー、スロークエリ、Galeraイベント
MariaDBのエラーログとスロークエリログの出力先を確認し、GaleraのノードログとWSREPの状態を突き合わせます。
Galeraノードがクラスタに復帰したあと、決済のクエリが遅くなったとします。エラーログを見ると転送が始まった時刻が分かります。スロークエリログでは、しきい値を超えたSQLを探せます。ノードが今もクエリを受け付けられるか、フロー制御でどれだけ止まったかを調べるには、wsrepのステータスも必要です。
スロークエリログの変数名はMariaDB 10.11以降のものを使い、ファイル出力の例は単体のMariaDB 11.8で確認しました。Galeraの説明は公式資料に基づきます。パッケージやマネージドサービスでは既定値が異なる場合があります。
エラーログの出力先を先に確認する
稼働中のサーバーでSHOW VARIABLES LIKE 'log_error';を実行します。Unixではlog_errorが設定されていなければ、サーバーはエラーをstderrに書きます。systemdがその出力を受け取る構成なら、実際のサービスユニットを指定してjournalを読みます。たとえばjournalctl -u mariadbです。コンテナの場合は、ランタイムのstderrの扱いを確認します。
[mariadb]
log_error = /var/log/mariadb/error.log
log_warnings = 2
この設定はエラーをファイルに書き出します。親ディレクトリを作成し、MariaDBのサービスアカウントに書き込み権限を付けます。ファイルがすでにある場合は、そのファイルにも書き込み権限が必要です。log_warningsの文書上の既定値は2ですが、設定で変わるうえ、すべての警告に作用するわけではありません。接続障害の調査で一時的に値を上げるなら、元の値を記録し、調査後に戻します。ローテーションでファイルを移動したら、MariaDBにログを開き直させてから新しい出力先を確認します。エラーログ · ログのローテーション
スロークエリログの条件を明確にする
検証環境のサーバー設定ファイルに次の例を追加します。実際に書き込めるパスを使ってください。log_output = FILEは一般クエリログにも影響するので、既存の出力先を先に確認します。
[mariadb]
log_output = FILE
log_slow_query = 1
log_slow_query_file = /var/log/mariadb/slow.log
log_slow_query_time = 1
log_queries_not_using_indexes = OFF
log_slow_rate_limit = 1
この例は1秒をしきい値とし、インデックス未使用時にしきい値を無視する設定をオフにします。間引きは行いません。ほかの記録条件は適用されます。MariaDB 10.11以降で使う変数名はlog_slow_query、log_slow_query_file、log_slow_query_timeです。従来のslow_query_log、slow_query_log_file、long_query_timeも別名として使えます。
log_slow_filterでは、全表走査、filesort、内部一時テーブルなどの特徴で絞り込めます。not_using_indexを含めると、実行が速いクエリでも記録対象になる場合があります。log_slow_min_examined_row_limitで、確認した行数の少ないクエリを除外できます。log_slow_rate_limitを上げた場合、記録件数はサンプルとして扱います。MariaDB 11.7以降では、log_slow_always_query_timeを超えるクエリは間引きを回避できます。
ファイル出力ではlog_slow_verbosityで詳細を加えられます。query_planは実行計画に関する情報を記録し、explainは対応するSQLのEXPLAIN出力を含めます。テーブル出力はこの詳細設定に対応しません。ファイルはmariadb-dumpslowで類似したSQLを集計でき、テーブル出力はmysql.slow_logを調べます。ほかの分析ツールを使うなら、追加フィールドを含む実際のサンプルで試してください。スロークエリログ · サーバー変数 · mariadb-dumpslow
一般クエリログで短時間だけ捕捉する
一般クエリログには接続や切断と、受け取ったSQLが記録されます。受信時の記録なので、SQLの成功やトランザクションのコミットまでは分かりません。
SHOW GLOBAL VARIABLES
WHERE Variable_name IN ('general_log', 'general_log_file', 'log_output');
一時的に有効化する場合は、最初に設定値と出力先を控えます。一般クエリログがOFFで、出力先がすでにFILEのテスト環境なら、次のクエリで出力を確かめられます。
SET GLOBAL general_log = ON;
SELECT 1 AS learn_general_log_probe;
SET GLOBAL general_log = OFF;
確認が終わったら元の設定に戻します。log_outputをTABLEに変えると、有効なスロークエリログの出力先も変わります。どちらのログにもSQLのリテラル値が含まれることがあります。書き込み量と閲覧権限を考慮して運用します。一般クエリログ · テーブル出力
バイナリログの保持期間を復旧計画に合わせる
MariaDB 10.6.1以降でファイル型のバイナリログを使う場合の例です。604800秒は7日です。
[mariadb]
log_bin = /var/log/mariadb/mariadb-bin
binlog_expire_logs_seconds = 604800
max_binlog_size = 1G
必要な保持期間は、ベースバックアップの周期、どこまでさかのぼって復旧するか、レプリカが遅れたり切断したりする時間から決めます。期限の確認は起動時やローテーション時などに行われます。期限に達した瞬間に削除されるとは限りません。ファイルとインデックスはMariaDBが管理するため、OSのログローテーションや手動削除の対象にしません。バイナリログの管理
Galeraの障害をノード横断で追う
donorとjoinerのエラーログを同じ時刻で並べ、WSREPのメンバー変更、状態スナップショット転送(SST)、増分状態転送(IST)を探します。donorに必要なwrite setの履歴が残っていれば、ISTで追いつける場合があります。SSTが失敗した場合は、設定した転送方式のログも確認します。
SHOW GLOBAL STATUS
WHERE Variable_name IN (
'wsrep_cluster_status',
'wsrep_cluster_size',
'wsrep_ready',
'wsrep_connected',
'wsrep_local_state_comment',
'wsrep_local_recv_queue_avg',
'wsrep_flow_control_paused'
);
Galera環境ではwsrep_cluster_statusでPrimaryコンポーネントを、wsrep_readyとwsrep_local_state_commentでクエリの受付可否やノードの状態を確認します。wsrep_flow_control_pausedは、最後のFLUSH STATUS以降にフロー制御で停止していた時間の割合です。受信キューの状態と、ほかのノードの値も並べて見ます。
ファイル出力の場合、DataKitのログ収集で、読み取り可能なパスを種類ごとに指定できます。クラスタ名とノード名を残し、複数行SQLが1件として取り込まれるかをサンプルで確認します。Pipelineで時刻フィールドをそろえても、ホストの時刻ずれは補正されません。時刻同期は別途設定します。観測したWSREPの特定エラーは、Guanceのログ検知でノード別やクラスタ別に数えられます。エラーとスローログの保持期間を変える場合は、ログインデックスの振り分け条件と保存ポリシーを確認します。Galeraのステータス変数 · Guanceのログ検知 · ログインデックス
