MySQLのログを使い分ける:エラー、スロークエリ、一般クエリ、バイナリログ
MySQL 8.0・8.4のログ設定と調べ方を解説。スロークエリの集計、バイナリログの保持、レプリケーションと時点復旧の注意点を整理します。
デプロイ中に MySQL が再起動し、復帰後も読み取り API が遅い。まずエラーログで起動とリカバリの経過を確認し、次に同じ時間帯に完了したクエリをスロークエリログで調べます。デプロイによるデータの変更を再現したいなら、参照先はバイナリログです。
以下の対象はセルフマネージドの MySQL 8.0 と 8.4 です。[mysqld] は起動時の設定例です。変更前に、実際のパス、権限、永続化済みの設定を確認してください。
どの MySQL ログから調べるか
| ログ | 調べたいこと | 通常の既定状態 |
|---|---|---|
| エラーログ | 起動に失敗した理由、リカバリ時の診断情報 | 有効。出力先は起動設定による |
| スロークエリログ | 完了した処理のうち、記録条件を満たしたステートメント | 無効 |
| 一般クエリログ | 短い調査期間にサーバーが受け取った接続や SQL | 無効 |
| バイナリログ | レプリカやリストア先が再生する変更イベント | 有効 |
1. エラーログ
[mysqld]
log_error = /var/log/mysql/error.log
稼働中なら SHOW GLOBAL VARIABLES LIKE 'log_error'; で設定を確認できます。起動しない場合は、先にサービスやコンテナの起動設定を調べます。例では起動時にファイルを指定するため、mysqld に対象ディレクトリへの書き込み権限が必要です。標準エラー出力の場合は、systemd のジャーナルやコンテナランタイム側に記録されることがあります。
既定のフィルター log_filter_internal では、log_error_verbosity の 1 はエラー、2 は警告も含め、3 は情報レベルのメッセージも含めます。抑制リストなどの追加条件も確認してください。終了、起動、InnoDB リカバリの記録を時系列に並べると、再起動の原因と、その後に続く遅延を分けて調べられます。 MySQL エラーログの仕様(英語)
2. スロークエリログ
[mysqld]
log_output = FILE
slow_query_log = 1
slow_query_log_file = /var/log/mysql/slow.log
long_query_time = 1
# log_queries_not_using_indexes = 1
# log_slow_admin_statements = 1
スロークエリログは既定で無効、long_query_time の既定値は 10 秒です。例の 1 秒は調整値で、記録には min_examined_row_limit などの条件も関わります。最初のコメント行を有効にすると、行の検索にインデックスを使わなかったステートメントも候補になり、実行時間がしきい値より短くても記録される場合があります。次の行は ALTER TABLE などの対象となる管理ステートメントを含める設定です。どちらも増えるログ量を確認してから有効にします。
log_output はスロークエリログと一般クエリログの両方に作用します。FILE はファイルに、TABLE はそれぞれ mysql.slow_log と mysql.general_log に書き込み、NONE は出力を止めます。動的変数を SET GLOBAL で変えても、その変更自体は再起動後に引き継がれません。既存の接続の long_query_time も変わらないため、確認には新しい接続を使います。変更を残すには起動設定を管理するか、対応する変数に対して承認済みの SET PERSIST を使います。
ファイルの Query_time と Lock_time は秒単位です。Rows_examined と Rows_sent を見比べると、調べた行数と返した行数の差がわかります。対応するツールを用意し、読み取り可能なログのコピーを集計します。
mysqldumpslow -l -s t /path/to/copied/slow.log
pt-query-digest /path/to/copied/slow.log
mysqldumpslow はこの例ではグループを総クエリ時間順に並べ、-l でロック待ち時間を差し引かないようにします。pt-query-digest はクエリをフィンガープリントでまとめます。運用時のしきい値はサービスのレイテンシ目標、ログ量、ストレージ負荷に合わせて決めます。 スロークエリログ(英語) · mysqldumpslow のオプション(英語) · Percona Toolkit(英語)
3. 一般クエリログ
[mysqld]
log_output = FILE
general_log = 1
general_log_file = /var/log/mysql/general.log
一般クエリログは、クライアントの接続、切断、サーバーが受け取ったステートメントを記録します。アプリケーションが送った SQL の確認に使えますが、実行の成否やトランザクションのコミットは別の情報で確認します。SQL に機密情報が含まれることもあるため、出力へのアクセスは制限します。
例の設定は起動時にログを有効にします。本番で短時間だけ調べるなら、起動時は無効のままにし、権限のある担当者が出力先、空き容量、変更前の値を確認してから SET GLOBAL general_log = 'ON'; を実行し、調査後に元へ戻します。テーブル出力でも、調査期間と消去の管理は必要です。 一般クエリログ(英語) · 出力先の設定(英語)
4. バイナリログ
[mysqld]
log_bin = /var/log/mysql/mysql-bin
binlog_expire_logs_seconds = 604800
max_binlog_size = 1G
sync_binlog = 1
通常稼働の MySQL 8.x ではバイナリログが既定で有効ですが、対象の log_bin は確認してください。記録対象の変更はイベントとして書き込まれ、レプリカがそれを読み取ります。GTID の自動ポジショニングで未取得トランザクションを要求できるのは、必要なイベントをソースから取得できる場合です。
ポイントインタイムリカバリでは、整合性のあるバックアップを復元したうえで、対応する位置から復旧したい時点まで再生します。その区間のログがすべて必要です。ログのコピーは mysqlbinlog で確認できます。再生すると変更が適用されるため、まず隔離した環境で手順を検証します。
604800 秒は 7 日です。平均生成速度と保持期間から容量を概算し、急増や大きなトランザクションに備えます。1 トランザクションは複数のファイルに分割されないので、ファイルがローテーションのしきい値 max_binlog_size を超える場合があります。sync_binlog=1 はコミットグループのコミット前にバイナリログを同期します。InnoDB のコミットの耐久性には、innodb_flush_log_at_trx_commit やストレージの動作も関わります。 バイナリログ(英語) · GTID 自動ポジショニング(英語) · ポイントインタイムリカバリ(英語)
5. ほかに見ておきたい記録
InnoDB の redo はクラッシュリカバリに、undo はロールバックと一貫性読み取りに使います。クエリの調査では、Performance Schema の events_statements_summary_by_digest が、収集済みの実行統計をステートメントダイジェストごとにまとめます。個々は速くても呼び出しが多いクエリは集計に現れることがあります。記録された個別の実行はスロークエリログで確認します。
エラーとスロークエリを同じ時間軸で確認する
DataKit がファイルを読み取れる環境では、ログ収集の設定(英語)でそれぞれのパスを指定し、インスタンスとサービスのタグを残します。複数行の SQL は、既知の 1 件を取り込んで正しくまとまるか確認します。標準的なスローログは MySQL インテグレーション(英語)にある mysql.p を参照し、イベント時刻、query_time、lock_time、rows_examined を元のログと照合します。エラーログのパーサーは実際のテキストまたは JSON 形式に合わせます。
インスタンスと時間帯でエラーを絞り、同じ区間のクエリ時間と検査行数を確認します。フィールド抽出や SQL 原文の収集に加え、フィンガープリントには正規化の処理が必要です。通知したい症状は Guance のログ検知(英語)でフィルター、評価ウィンドウ、件数のしきい値を設定します。保存期間はエラーとスロークエリをそれぞれ何日前まで調べるかで決めます。
よくある質問
スロークエリログを有効にすると MySQL が遅くなりますか?
負荷は記録件数、出力先、ストレージによって変わります。long_query_time を下げたり、インデックスを使わない検索を含めたりすると、書き込み量が大きく増える場合があります。実際に近い負荷でログ量、ディスク I/O、クエリの遅延を比較してください。
一般クエリログを切り忘れたらどうなりますか?
ファイルやテーブルが短時間で大きくなることがあります。調査前に無効だったなら、権限のある担当者が SET GLOBAL general_log = 'OFF'; で元に戻します。起動設定も変更していた場合は、そちらも戻します。テーブル出力でも収集期間と削除の管理は必要です。
バイナリログでディスクが急に埋まったら?
まず書き込み速度の上昇、大きなトランザクション、保持期間を確認します。保持期間を短縮したり PURGE BINARY LOGS を実行したりする前に、バックアップから復旧できる範囲と、切断中のレプリカも含めた全レプリカの進捗を確認します。ソースはオフラインのレプリカが必要とするログも削除し得ます。削除にはサーバーが用意する手段を使い、大きなトランザクションの分割はアプリケーションが別々のコミットを許容できる場合に検討します。 バイナリログの削除仕様(英語)
マネージド MySQL でファイルを直接読めないときは?
プロバイダーのダウンロード、エクスポート、サブスクリプションなどを使い、取得形式に合わせて解析します。たとえば Amazon RDS for MySQL では、DB パラメータグループでスロークエリログや一般クエリログを有効にします。エクスポート方法が求める出力設定を確認してください。
