PostgreSQL のログ設定:スロークエリ、ロック待ち、監査
PostgreSQL の stderr、CSV、JSON の出力設定と、スロークエリ、ロック待ち、監査の記録方法を解説します。DataKit での収集も確認できます。
デプロイのあと、データベースのダッシュボードで応答時間が跳ね上がったとします。クエリ自体が遅いのか、ロックの解放を待っているのかは、PostgreSQL のログで切り分けられます。まず確認するのは、その記録がどこに届いているかです。コンテナならランタイムが取り込んだ標準エラー出力、セルフマネージドなら PostgreSQL が管理する JSON ファイルかもしれません。
設定例は PostgreSQL 15〜18 を対象にしています。変更前にメジャーバージョンと、現在のログの経路を確認してください。
調べたいことに合わせて設定を選ぶ
| 確認したいこと | 関連する設定 | 読み取れること |
|---|---|---|
| サーバーログの場所 | log_destination、logging_collector |
ランタイムやサービスの stderr、または current_logfiles にあるファイル |
| 遅かった処理 | log_min_duration_statement |
完了したステートメントや拡張プロトコルの処理段階がしきい値に達した |
| ロック待ち | log_lock_waits |
deadlock_timeout を超える待機があった。デッドロックの確定には別の証拠が必要 |
| 監査対象の SQL | log_statement または pgAudit |
必要な監査範囲と、対象となる文の分類、オブジェクト、ロールの対応 |
1. ログの出力先を決める
# postgresql.conf
logging_collector = on
log_destination = 'jsonlog'
log_directory = 'log'
log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'
log_rotation_age = 1d
log_rotation_size = 100MB
log_truncate_on_rotation = off
logging_collector の変更には再起動が必要です。すでに有効なら、log_destination の変更は設定の再読み込みで反映できます。csvlog と jsonlog はいずれもコレクターが必要で、JSON 出力は PostgreSQL 15 から使えます。相対パスの log はデータディレクトリの下にあります。同じデータディレクトリ内の current_logfiles で、コレクターが現在書き込んでいるファイルを確認できます。
時間とサイズの設定はローテーションを開始する条件です。100 MB は上限ではなく目安となるしきい値で、ローテーションだけでは古いファイルは消えません。ファイル名に時刻を入れておくと、同じ日でもサイズをきっかけに別名のファイルへ切り替えられます。ランタイムやサービスマネージャーが stderr を収集して保持期間も管理しているなら、その経路を使い続けられます。 PostgreSQL のログ設定(英語) · PostgreSQL 15 リリースノート(英語)
2. テキストログに必要な情報を付ける
log_line_prefix = '%m [%p] %c %q%u@%d %a '
%m はミリ秒付きの時刻、%p はプロセス ID、%c はセッション識別子です。%s はプロセスの開始時刻を表します。%q の位置で非セッションプロセスの接頭辞が終わるため、その後ろのユーザー、データベース、アプリケーション名はセッションの記録に付きます。必要に応じて %e の SQLSTATE や %i のコマンドタグも使えます。
SQL 本文と実行時間が別々の行に出た場合、セッション識別子が対応付けに役立ちます。CSV や JSON を使う場合は、形式に含まれるフィールドを直接読み取ります。
3. 遅い処理とロック待ちを記録する
log_min_duration_statement = 500ms
log_lock_waits = on
log_checkpoints = on
log_temp_files = 0
500 ms は調整値の一例です。しきい値以上かかった完了済みステートメントを記録し、-1 で無効、0 で完了済みステートメントの実行時間をすべて記録します。拡張クエリプロトコルでは Parse、Bind、Execute を別々に計測します。トラフィックが多いときは log_min_duration_sample と log_statement_sample_rate で抽出できます。全件記録のしきい値に達した処理にはサンプリングがかかりません。
log_lock_waits は deadlock_timeout を超えるロック待ちを記録します。チェックポイントのログではバッファー書き込み数や所要時間を確認できます。log_temp_files=0 は、一時ファイルの削除時に名前とサイズを記録します。ソートやハッシュがディスクに退避した手がかりになります。
実行計画が必要なら、権限のあるセッションで auto_explain をロードするか、必要な範囲でプリロードし、別のしきい値 auto_explain.log_min_duration を設定します。実行統計やノードごとの計測を有効にすると負荷が増えることがあります。 auto_explain(英語)
4. SQL と接続の記録範囲を絞る
log_statement = 'ddl'
log_connections = on
log_disconnections = on
log_hostname = off
log_statement は none、ddl、mod、all から選びます。mod は DDL に加えて対象となるデータ変更文を記録します。all でも、基本的な構文エラーや、拡張プロトコルで Execute より前に失敗した文は対象外です。そのような文を調べるときは log_min_error_statement を確認します。
接続と切断のログは、短時間の接続が頻繁に作られていないかを見るのに役立ちます。PostgreSQL 15〜17 の log_connections は真偽値です。18 では項目リストに変わりましたが、互換性のため on も使えます。この場合は接続の受け付け、認証、認可が対象で、setup_durations は含まれません。切断ログにはセッション継続時間が入ります。SQL 本文とバインド値に機密情報が含まれる可能性があるため、記録期間、閲覧権限、保持期間を絞ります。 PostgreSQL 17 のログ設定(英語) · PostgreSQL 18 のログ設定(英語)
5. エラーに必要な詳細を残す
log_error_verbosity = default
log_min_error_statement = error
log_error_verbosity で出力の詳細度を選びます。verbose には SQLSTATE とソース上の位置が含まれます。log_min_error_statement は失敗した SQL 本文を付ける条件で、サーバーメッセージ自体のしきい値は log_min_messages で決まります。エラーを数えるなら、実際に検証した重大度や SQLSTATE で絞ります。ERROR で失敗したクエリと、FATAL で終了したセッションでは意味が違います。
スロークエリのサンプルで収集を確認する
テスト環境で識別しやすく、しきい値に達する無害なクエリを使い、出力された 1 件を確認します。DataKit のファイル収集(英語)には実際のパスを指定し、読み取り権限を用意します。PostgreSQL インテグレーション(英語)にもファイル収集の設定があります。組み込みパーサーの例は特定のテキスト形式向けなので、JSON や CSV を使う場合は形式に合うパーサーを用意します。
データベース名、ユーザー、時刻、重大度を元のレコードと照合します。JSON では実行時間が message 内にあり、statement が存在しない場合があります。抽出と機微情報の扱いを確認し、データベースの記録から検証できたフィールドを使って Guance のログ検知(英語)を設定します。
よくある質問
csvlog と jsonlog のどちらを選びますか?
PostgreSQL 15 以降では 1 行ごとの JSON を使えます。省略されるフィールドやタイムゾーンを確認してください。既存の CSV 処理系を使うなら、サーバーバージョンごとの列順、引用符、複数行の値を扱えることを確認します。stderr がすでに収集されていれば、テキスト形式も選べます。
log_statement=all はどのくらい有効にしておけますか?
調査は短時間に絞り、ディスク容量と I/O を見ます。ログ量はトラフィック、文の長さ、パラメーターによって変わります。分類やリレーション単位の監査が必要なら、メジャーバージョンに合う pgAudit(英語)を検討します。プリロードが必要です。DDL のオブジェクト情報も記録するには、拡張を作成してから pgaudit.log を設定し、監査する分類、ロール、リレーションを確認します。
FATAL: remaining connection slots は何を示しますか?
通常のロールが使える接続枠がなくなっています。権限によって使える予約枠が残っている場合があります。データベース、ロール、アプリケーションごとに、接続数やプールの利用状況、未終了のトランザクションを確認してください。アイドル表示だけで切断を判断しないようにします。max_connections の変更は再起動が必要で、サーバーのリソース割り当てにも影響します。 接続設定(英語)
コンテナの PostgreSQL ログをどう収集しますか?
PostgreSQL が stderr に出力する場合は、ランタイムや Kubernetes に合う DataKit の収集を有効にし、ログへアクセスできるようにします。コンテナ内でファイルに出力する場合は、ファイル収集から読める場所にログディレクトリをマウントします。重複を防ぐには、同じ出力を二つの経路で収集しないようにします。
