5.7. エラー報告とログ取得

Pgpool-IIは、Pgpool-IIのメッセージのログ出力先を2種類サポートします。 複数のログ出力先を使用したい場合は、希望するログ出力先をカンマで区切ったリストをパラメータに設定することができます。

#for example to log on both syslog and stderr
log_destination = 'syslog,stderr'
      

デフォルトではstderrのみにログ出力します。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

このパラメータはログ収集機構を有効にします。 それはstderrに送られたログメッセージを捕捉し、ログファイルにリダイレクトするバックグラウンドプロセスです。

このパラメータはサーバ起動時のみ設定可能です。

logging_collectorはPgpool-II V4.2以降でのみ使用可能です。

logging_collectorを有効と設定した場合、このパラメータはログファイルが作成されるディレクトリを確定します。

デフォルトは/tmp/pgpool_logsです。

このパラメータはPgpool-II起動時のみ設定可能です。

logging_collectorが有効な場合、このパラメータは作成されたログファイルのファイル名を設定します。 値はstrftimeパターンとして扱われるため、%エスケープを使用して、時刻によって変動するファイル名を指定することができます。 サポートされている%-エスケープはstrftime 仕様によく似ています。

エスケープすることなくファイル名を指定する場合、ディスク全体を使い切ってしまうことを防止するためにログローテーションを行うユーティリティを使用することを計画するべきです。

デフォルトはpgpool-%Y-%m-%d_%H%M%S.logです。

このパラメータはPgpool-II起動時のみ設定可能です。

logging_collectorが有効になっている場合、このパラメータはログファイルのパーミッションを設定します。 パラメータの値はchmod および umaskシステムコールで許容されるフォーマットで指定される数値モードであると期待されます。

このパラメータはPgpool-II起動時のみ設定可能です。

logging_collectorが有効な場合、このパラメータは個々のログファイルの最大寿命を決定します。 この値が単位なしで指定された場合は、分単位であるとみなします。 デフォルトは24時間です。

ゼロに設定することで、寿命に基づいた新しいログファイルの生成は無効になります。

このパラメータはPgpool-II起動時のみ設定可能です。

logging_collectorが有効な場合、このパラメータは個々のログファイルの最大容量を決定します。 ここでキロバイト単位で指定したデータ量がログファイルに出力された後、新しいログファイルが生成されます。

ゼロに設定することで、サイズに基づいた新しいログファイルの生成は無効になります。

このパラメータはPgpool-II起動時のみ設定可能です。

logging_collectorが有効な場合、PostgreSQLは既存の同名のファイルに追加するのではなく、そのファイルを切り詰める（上書きする）ようになります。 しかし、切り詰めは時間を基にしたローテーションのために新規にファイルが開かれた時にのみ発生し、サーバ起動時やサイズを基にしたローテーションでは発生しません。 オフの場合、全ての場合において既存のファイルに追記されます。 例えば、この設定をpgpool-%H.logのようなlog_filenameと組み合わせて使用すると、24個の時別のログファイルが生成され、それらは周期的に上書きされることになります。

このパラメータはPgpool-II起動時のみ設定可能です。

syslogへのログ取得が有効な場合、このパラメータは使用されるsyslogの「facility」を決定します。 LOCAL0、LOCAL1、LOCAL2、LOCAL3、LOCAL4、LOCAL5、LOCAL6、LOCAL7の中から選んでください。 デフォルトはLOCAL0です。 使用しているシステムのsyslogデーモンの文書を同時に参照してください。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

syslogへのログ取得が有効な場合、このパラメータはsyslogログ内のPgpool-IIメッセージを特定するのに使用するプログラム名を確定します。 デフォルトはpgpoolです。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

どのメッセージ階層をクライアントに送るかを管理します。 有効な値は、DEBUG5、DEBUG4、DEBUG3、DEBUG2、DEBUG1、LOG、NOTICE、WARNING、およびERRORです。 それぞれの階層はそれに続く全ての階層を包含します。 デフォルトはNOTICEです。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。 現在のセッションでのパラメータ値は、PGPOOL SETコマンドで変更することもできます。

どのメッセージ階層をサーバログに書き込むかを管理します。有効な値はDEBUG5、DEBUG4、DEBUG3、DEBUG2、DEBUG1、INFO、NOTICE、WARNING、ERROR、LOG、FATAL、およびPANICです。 それぞれの階層はその下の全ての階層を含みます。 デフォルトはWARNINGです。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。 現在のセッションでのパラメータ値は、PGPOOL SETコマンドで変更することもできます。

onに設定されている場合、全てのSQL文をログ出力します。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。 現在のセッションでのパラメータ値は、PGPOOL SETコマンドで変更することもできます。

log_statementと似ていますが、DBノード単位でログが出力されます。 レプリケーションや負荷分散が動いていることを確認するのに便利です。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。 現在のセッションでのパラメータ値は、PGPOOL SETコマンドで変更することもできます。

onに設定されている場合、クライアントメッセージをログ出力します。

このパラメータは、Pgpool-IIの設定を再読み込みすることで変更可能です。 現在のセッションでのパラメータ値は、PGPOOL SETコマンドで変更することもできます。

onに設定されている場合、psコマンドの結果、および（log_connectionsがonの場合には）接続時のログに、IPアドレスではなくホスト名を表示します。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

onに設定されている場合、全てのクライアント接続をログへ出力します。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

onに設定されている場合、全てのクライアント接続終了をログへ出力します。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

ログ取得されるそれぞれのメッセージに対し、サーバログに書き込まれる詳細の量を制御します。 有効な値は、TERSE、DEFAULT、およびVERBOSEで、それぞれは表示されるメッセージにより多くのフィールドを追加します。 TERSEはDETAIL、HINT、QUERY、およびCONTEXTエラー情報を除外します。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。 現在のセッションでのパラメータ値は、PGPOOL SETコマンドで変更することもできます。

これは、各ログ行の先頭に出力するprintfの書式文字列です。 %から始まる"エスケープシーケンス"は、後述の通りのステータス情報で置き換えられます。 認識できないエスケープは無視されます。 他の文字はそのままログ行に出力されます。 デフォルトは '%m: %a pid %p: 'で、タイムスタンプ、アプリケーション名、プロセスIDを印字します。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。