MySQLにおける４つのログファイルの設定と確認方法

１．１　ログファイルの種類

MySQL Server 5.7のログファイルには、次の４種類があります。

このうち「スロークエリの発生ログ」と「エラーログ」については、デフォルトで記録が設定されています。残りの「一般クエリの実行ログ」と「バイナリログ」については、設定の追加が必要です。

ログファイルの設定については、共通の設定ファイルに記述されています。設定ファイルの場所については、後ほどログファイルの保存場所にてご紹介します。

１．２　ログファイルの保存場所

ログファイルの保存場所は、設定ファイル中の「datadir」で定義されています。

図はWindows版設定ファイルの例です。デフォルトでは次の場所になっています。

上の黄色くマークされているところにログファイルの出力場所が記載されており、下の赤く囲んでいるところにロギングの設定が記述されています。

なおUNIX／Linux系の場合、「datadir」のデフォルトは次の通りです。

１．３　ログ監視や解析のメリット

MySQLだけでなくデータベース共通にいえることですが、ログ監視を行うことでセキュリティの強化（外部からの攻撃、内部からの不正操作や、情報漏洩などの対応）を図ることができます。

またシステム障害が起こった際には、エラーの発生原因究明などに役立ちます。

さらにMySQLの場合、最悪データベースが破損してしまってもバイナリログからデータを復旧することが可能というメリットがあります。

２．１　一般クエリログとは

一般クエリログとは、実行したSQLクエリの履歴が全て記録されていくログです。サイズが大きくなりやすいためデフォルトでは出力しない設定となっていますが、障害対応などで重要な役割を果たすことも多く、システムが稼働する際にはよほどでなければ出力するケースが多いようです。

２．２　一般クエリログの出力設定

一般クエリログの出力設定は、下図の場所で行います。

設定が可能な項目は、３つあります。

■log-output

この項目では、ログの出力方法を設定します。設定可能な出力方法は、次の３つです。

特に設定しなかった場合、デフォルトではFILEになります。

これは一般クエリログだけでなく、同項目で設定するスロークエリログにも反映されます。

■general-log

これはログ出力の有無を設定する項目であり、次の２つの値を設定可能です。

デフォルトでは、「0（出力しない）」が設定されています。

■general_log_file

出力するログファイルの、ファイル名を設定します。

２．３　一般クエリログの確認と読み方

「datadir」に設定したディレクトリに「general_log_file」に設定した名称で、図のような内容のテキストファイルが作成されました。

■ログ１行目：MySQLバージョン情報など、開始情報が出力されます。

■ログ２行目：ポート番号やパイプ名などが出力されます。

■ログ３行目：ログ本文の項目見出しが出力されます。

■ログ４行目以降：ログ本文が出力されます。
左から、日時、コマンドのID、実行内容が出力されます。

３．１　スロークエリログとは

スロークエリログとは、実行に時間のかかったクエリがあった際に記録されるログです。パフォーマンス向上のための原因分析の場面などで役立ちます。

３．２　スロークエリログの出力設定

先ほどの一般クエリログと同じ項目の後半部分が、スロークエリログの設定箇所です。

設定が可能な項目は、４つあります。

■log-output

一般クエリログと共通です。

■slow-query-log

一般クエリログと同じく、ログ出力の有無を設定する項目です。
デフォルトでは、「1（出力する）」が設定されています。

■slow_query_log_file

こちらも同じく、出力ファイルのファイル名を設定します。

■long_query_time

ここで設定した値（単位：秒）よりも処理に時間がかかったクエリを、出力対象にします。
デフォルトでは10秒が設定されています。

３．３　スロークエリログの確認と読み方

「datadir」に設定したディレクトリに「slow_query_log_file」に設定した名称で、図のような内容のテキストファイルが作成されました。

■ログ１行目：MySQLバージョン情報など、開始情報が出力されます。

■ログ２行目：ポート番号やパイプ名などが出力されます。

■ログ３行目：クエリの実行時間、テーブル等がロックされていた時間、処理対象の行数などが出力されます。

■ログ４行目以降：実行されたクエリの内容（SQL文）が出力されます。

サンプルの図では特に問題が発生していないため、エラーは出力されずに毎回のサーバスタート情報が並んでいる状態となっています。

４．１　バイナリログとは

バイナリログはバックアップログとも呼ばれ、データ変更の情報をバイナリ情報で記録しています。いざという時はバイナリログからデータを復元できる内容となっており、レプリケーションにも使用されています。

４．２　バイナリログの出力設定

バイナリログの出力については、一般クエリログやスロークエリログの次にある「Binary Logging」に設定します。

設定が可能な項目は、４つあります。

■log-bin

一般クエリログなどと同じくログ出力の有無を設定する項目ですが、こちらでは数値ではなくファイル名を指定することで、ログの出力が開始されます。
デフォルトでは、項目自体がコメントアウトされています。

■log_bin_index

バイナリログを管理するためのインデックスファイルの名前を指定します。

■max_binlog_size

ログファイルの最大サイズを指定します。

■expire_logs_days

ログファイルを保存しておく期間（単位：日）を設定します。

４．３　バイナリログの確認と読み方

バイナリログはその名の通り中身はバイナリファイルです。簡単に読み解けない状態となっているため、今回は割愛します。

５．１　エラーログとは

エラーログとはサーバの起動や停止の情報と合わせて、発生したエラーや警告の履歴が出力されるログファイルです。

５．２　エラーログの出力設定

バイナリログの出力については、一般クエリログやスロークエリログの次にある「Binary Logging」に設定します。

設定を行う項目は、１つです。

■log-error

エラーログのファイル名を設定します。

５．３　エラーログの確認と読み方

「datadir」に設定したディレクトリに「log-bin」に設定した名称で、図のような内容のテキストファイルが作成されました。

左から、日時、コマンドのID、警告レベル、内容が出力されます。

警告レベルには、次の３つがあります。

サンプルの図ではエラーは発生しておらず、警告と注意が発生しています。

ログは障害対応だけでなくチューニングなどの場面でも重要な資料となっており、見る機会も多いかと思います。この機会に、ぜひどこにどんな情報があるのかチェックしてみて下さい。