Aurora MySQL データベースログの概要
次の種類の Aurora MySQL ログファイルをモニタリングできます。
-
エラーログ
-
スロークエリログ
-
全般ログ
-
[監査ログ]
-
インスタンスログ
-
IAM データベース認証エラーログ
Aurora MySQL のエラーログはデフォルトで生成されます。DB パラメータグループにパラメータを設定することで、低速クエリと一般ログを生成できます。
トピック
Aurora MySQL エラーログ
Aurora MySQL は mysql-error.log ファイルにエラーを書き込みます。各ログファイルには、それぞれ生成された時間 (UTC) がファイル名に付加されます。ログファイルには、タイムスタンプも付加され、ログエントリがいつ書き込まれたかを調べるために役立ちます。
Aurora MySQL では起動時、シャットダウン時、およびエラー検出時にのみ、エラーログへの書き込みが行われます。DB インスタンスでは、新しいエントリがエラーログに書き込まれないまま、数時間または数日が経過することがあります。最近のエントリがない場合、それは、サーバーにログエントリになり得るエラーが発生しなかったためです。
設計上、エラーログはフィルタリングされ、エラーなどの予期しないイベントのみが表示されます。ただし、エラーログには、クエリの進行状況など、表示されない追加のデータベース情報も含まれています。したがって、実際のエラーがなくても、継続的なデータベースアクティビティのためにエラーログのサイズが増加する可能性があります。また、AWS Management Console のエラーログには特定のサイズがバイト単位またはキロバイト単位で表示されている場合がありますが、ダウンロードすると 0 バイトになる場合があります。
Aurora MySQL は 5 分ごとに mysql-error.log をディスクに書き込みます。ログの内容が mysql-error-running.log に追加されます。
Aurora MySQL は mysql-error-running.log ファイルを 1 時間ごとにローテーションします。
注記
ログの保持期間は、Amazon RDS と Aurora で異なります。
Aurora MySQL のスロークエリと一般ログ
Aurora MySQL のスロークエリログと一般ログを、ファイルまたはデータベーステーブルに書き込めます。このためには、DB パラメータグループにパラメータを設定します。DB パラメータグループの作成と変更の詳細については、「Amazon Aurora のパラメータグループ」を参照してください。Amazon RDS コンソール、Amazon RDS API、Amazon RDS CLI、または AWS SDK を使用して、スロークエリログまたは一般ログを表示する前に、以下のパラメータを設定する必要があります。
以下のリストに示すパラメータを使用して Aurora MySQL のログ記録を制御できます。
-
slow_query_log: スロークエリログを作成するには、1 に設定します。デフォルトは 0 です。 -
general_log: 一般ログを作成するには、1 に設定します。デフォルトは 0 です。 -
long_query_time: ファストクエリがスロークエリログに記録されないようにするために、ログに記録されるクエリの最短実行時間の値を秒単位で指定します。デフォルトは 10 秒で、最小値は 0 です。log_output = FILE の場合は、マイクロ秒の精度になるように、浮動小数点値を指定できます。log_output = TABLE の場合は、秒の精度になるように、整数値を指定する必要があります。実行時間がlong_query_timeの値を超えたクエリのみがログに記録されます。例えば、long_query_timeを 0.1 に設定すると、実行時間が 100 ミリ秒未満のすべてのクエリはログに記録されなくなります。 -
log_queries_not_using_indexes: インデックスを使用しないすべてのクエリをスロークエリログに記録するには、1 に設定します。インデックスを使用しないクエリは、その実行時間がlong_query_timeパラメータの値未満であってもログに記録されます。デフォルトは 0 です。 -
log_output:optionlog_outputパラメータに指定できるオプションは、次のとおりです。-
TABLE - 一般クエリを
mysql.general_logテーブルに、スロークエリをmysql.slow_logテーブルに書き込みます。 -
FILE - 一般クエリログとスロークエリログの両方をファイルシステムに書き込みます。
-
NONE - ログ記録を無効にします。
Aurora MySQL バージョン 2 の場合、
log_outputのデフォルトはFILEです。 -
スロークエリデータを Amazon CloudWatch Logs に表示するには、次の条件を満たす必要があります。
スロークエリログを含むように CloudWatch Logs を設定する必要があります。
slow_query_logを有効にする必要があります。log_outputをFILEに設定する必要があります。クエリに要する時間が、
long_query_timeに設定された時間よりも長い必要があります。
スロークエリと一般ログの詳細については、MySQL ドキュメントの以下のトピックを参照してください。
Aurora MySQL の監査ログ
Aurora MySQL の監査ログは、高度な監査と呼ばれます。高度な監査を有効にするには、特定の DB クラスターパラメータを設定します。詳細については、「Amazon Aurora MySQL DB クラスターでのアドバンストな監査の使用」を参照してください。
Aurora MySQL インスタンスログ
Aurora は、自動一時停止が有効になっている DB インスタンスに対して別のログファイルを作成します。この instance.log ファイルは、これらの DB インスタンスが想定どおりに一時停止できなかった理由を記録します。インスタンスログファイルの動作と Aurora の自動一時停止機能の詳細については、「Aurora Serverless v2 の一時停止と再開アクティビティのモニタリング」を参照してください。
Aurora MySQL のログのローテーションと保持
ログ記録が有効になっている場合、Amazon Aurora は、ログファイルの削除を定期的に実行します。これは、ログファイルが大きくなることでデータベースが使用できなくなったりパフォーマンスに影響する可能性を低く抑えるための予防措置です。Aurora MySQL は、次のようにローテーションと削除を処理します。
-
Aurora MySQL エラーログファイルのサイズは、DB インスタンスのローカルストレージの 15 パーセント以下に制約されます。このしきい値を維持するために、ログは 1 時間ごとに自動的にローテーションされます。Aurora MySQL は 30 日後、またはディスク領域の 15 % が使用されると、ログを削除します。古いログファイルを削除した後、ログファイルの合計サイズがしきい値を超えている場合、ログファイルのサイズがしきい値以下になるまで、最も古いログファイルから順に削除されます。
-
Aurora MySQL は、24 時間後、またはストレージの 15% が消費されると、監査、一般、および低速クエリログを削除します。
-
FILEログ記録が有効になっている場合、一般ログとスロークエリログファイルの検査が 1 時間ごとに実行され、作成後 24 時間を超えた古いログファイルは削除されます。場合によっては、削除後の残りのログファイルの合計サイズが、DB インスタンスのローカル領域のしきい値である 15 % を超えることがあります。この場合、ログファイルのサイズがしきい値以下になるまで、最も古いログファイルから順に削除されます。 -
TABLEログ記録が有効化されている場合、ログテーブルはローテーションまたは削除されません。結合されたすべてのログのサイズが大きすぎると、ログテーブルは切り捨てられます。low storageイベントカテゴリにサブスクライブして、ログテーブルが手動でローテーションされたり削除されたりして領域が解放されたときに通知を受け取ることができます。詳細については、「Amazon RDS イベント通知の操作」を参照してください。mysql.general_logテーブルの手動ローテーションは、mysql.rds_rotate_general_logプロシージャを呼び出すことで実行できます。mysql.slow_logテーブルのローテーションは、mysql.rds_rotate_slow_logプロシージャを呼び出すことで実行できます。ログテーブルをローテーションすると、現在のログテーブルがバックアップのログテーブルにコピーされ、現在のログテーブル内にあるエントリは削除されます。バックアップのログテーブルが既に存在する場合は、現在のログテーブルをバックアップにコピーする前に、削除されます。バックアップのログテーブルは、必要に応じて照会することができます。
mysql.general_logテーブルに対するバックアップのログテーブルは、mysql.general_log_backupという名前になります。mysql.slow_logテーブルに対するバックアップのログテーブルは、mysql.slow_log_backupという名前になります。 -
Aurora MySQL 監査ログは、ファイルサイズが 100 MB に達するとローテーションされ、24 時間後に削除されます。
Amazon RDS は、10 MB を超える IAM データベース認証エラーログファイルをローテーションします。Amazon RDS は、5 日以上経過しているか、100 MB を超える IAM データベース認証エラーログファイルを削除します。
Amazon RDS コンソール、Amazon RDS API、Amazon RDS CLI、または AWS SDK からログを使用するには、log_output パラメータを FILE に設定します。Aurora MySQL エラーログと同様、これらのログファイルは 1 時間ごとにローテーションされます。直前 24 時間以内に生成されたログファイルが保持されます。Amazon RDS と Aurora で保持期間が異なる点に注意してください。
Amazon CloudWatch Logs への Aurora MySQL ログの発行
Aurora MySQL DB クラスターを設定して、ログデータを Amazon CloudWatch Logs のロググループに発行することができます。CloudWatch Logs を使用すると、ログデータのリアルタイム分析や、CloudWatch を使用したアラームの作成、メトリクスの表示を行うことができます。CloudWatch Logs を使用して、耐久性の高いストレージにログレコードを格納できます。詳しくは、「Amazon CloudWatch Logs への Amazon Aurora MySQL ログの発行」を参照してください。
