MySQL/MariaDB クエリログを有効にする方法

この短くてわかりやすいガイドでは、MySQL/MariaDB クエリのログを有効にしてクエリをファイルに保存する方法について説明します。

データベースを使用するとき、開発者は、トラブルシューティング、パフォーマンスの調整、純粋な好奇心など、舞台裏で何が起こっているのかを知りたいと思うことがよくあります。

一般的なクエリログは、依然として MySQL/MariaDB データベースで最も一般的な監査および診断情報ソースの 1 つです。ログ記録が有効になると、データベースサーバーはクライアントの接続または切断時に情報をログファイルに書き込み、各 SQL ステートメントを記録します。

ただし、一般的なクエリログを有効にすると、MySQL/MariaDB のパフォーマンスに影響することに注意してください。これにより、スループットが約 13% 減少し、MySQL/MariaDB サーバーからの応答時間が約 17% 増加します。

プロセスは非常に簡単なので、さっそく始めましょう。

MySQL/MariaDB の一般的なクエリのログを有効にする

MySQL/MariaDB では、一般的なクエリログはデフォルトで無効になっています。

1. MySQL/MariaDB サーバーのコマンドラインツールに root として入力します。

mysql -u root -p

2. 以下のクエリを実行して、一般ログファイルのパスを /var/logs/mysql/general-query.log に設定します。

SET GLOBAL general_log_file='/var/log/mysql/general-query.log';

一般的なクエリログは、データベースサブディレクトリを保持する同じデータディレクトリ (通常は /var/lib/mysql) に書き込まれ、ログファイル名はデフォルトでホスト名になります。ただし、ご覧のとおり、これは変更できます。

3. サーバーの一般ログを有効にします。

SET GLOBAL general_log = 1;

MySQL/MariaDB の一般的なクエリログのステータスをもう一度確認してみましょう。

SHOW VARIABLES LIKE "general_log%";

それでおしまい。コマンドラインから general-query.log ファイルに対して sudo tail -f と同様の操作を実行して、状況を監視できます。

関連: Linux の先頭コマンドと末尾コマンドを例で説明する

検査が完了したら、次のようにして MySQL/MariaDB クエリのログを無効にできます。

SET GLOBAL general_log = 0;

運用サーバーでログを有効にすることは確かに望ましくありません。したがって、これには注意してください。ログファイルはすぐに大きくなる可能性があります。

クエリを直接実行したくないとします。その場合でも、MySQL/MariaDB 構成ファイルを直接変更することで MySQL/MariaDB クエリログを有効にすることができますが、この方法ではデータベースサーバーの再起動が必要になることに注意してください。

クライアントのエラーが疑われ、クライアントがデータベースに何を送信したかを正確に知りたい場合は、一般的な MySQL/MariaDB クエリログが役立つことがあります。

したがって、データベースに問題がある場合、それをトラブルシューティングする 1 つの方法は、クエリログを有効にして何が起こっているかを観察することです。

一般的な MySQL/MariaDB クエリログの有効化について詳しくは、こことここを参照してください。