log_destination
(string
)
PostgreSQLは、stderr、csvlogおよびsyslogを含めて、サーバメッセージのログ取得に対し数種類の方法を提供します。
Windowsでは、eventlogも同時に提供します。
このパラメータを設定するには、コンマ区切りでお好みのログ出力先を記載します。
デフォルトでは、ログはstderrのみに出力されます。
このパラメータはpostgresql.conf
ファイル、または、サーバのコマンドラインでのみ設定されます。
csvlogがlog_destination
に含まれる場合、ログ項目はプログラムへの読み込みが簡便な「カンマ区切り値」書式(CSV)で出力されます。
詳細は19.8.4. CSV書式のログ出力の利用を参照してください。
CSV書式のログ出力を生成するためにはlogging_collectorを有効にする必要があります。
log_destination
でsyslogオプションを使用できるようにするために、ほとんどのUnixシステムではシステムのsyslogデーモンの設定を変更しなければならないでしょう。
PostgreSQLではログをLOCAL0
からLOCAL7
までのsyslogファシリティで記録することができます(syslog_facilityを参照してください)。
しかし、ほとんどのプラットフォームのデフォルトのsyslog設定ではこれらのメッセージはすべて破棄されます。
うまく動作させるためにsyslogデーモンの設定に以下のようなものを追加しなければならないでしょう。
local0.* /var/log/postgresql
Windowsでlog_destination
に対しeventlog
オプションを使用する場合、Windows Event Viewer がイベントログメッセージを手際良く表示できるよう、オペレーティングシステムでイベントソースとそのライブラリを登録しなければなりません。
詳細は18.11. WindowsにおけるEvent Logの登録を参照ください。
logging_collector
(boolean
)
このパラメータはログ収集機構を有効にします。
それはstderrに送られたログメッセージを捕捉し、ログファイルにリダイレクトするバックグラウンドプロセスです。
この手法はsyslogへのログよりもしばしば有用です。
メッセージの一部の種類がsyslogでは出力されない可能性があるためです。
(一般的な例として、ダイナミックリンカのエラーメッセージがあり、その他の例としてarchive_command
のようなスクリプトにより生成されたエラーメッセージが挙げられます)。
このパラメータはサーバ起動時のみ設定可能です。
ログ収集機構を使用せずにstderrのログを取ることは可能です。 ログメッセージはサーバのstderrが指し示すいかなる場所にも向かうだけです。 しかし、その方法はログファイルを巡回させる都合のよい方法を提供しないので、ログ容量が小さい場合のみに適しています。 同時に、ログ収集機構を使用しないいくつかのプラットフォームにおいては、ログ出力が失われたり、文字化けします。なぜなら、同一のログファイルに同時に書き込みを行うマルチプロセッサはそれぞれの出力を上書きできるからです。
ログ収集機構はメッセージを決して失わないために設計されています。 これは、極端に高い負荷の場合、サーバプロセスはコレクタが遅れをとった場合、追加のログメッセージを送信しようと試みる時に阻止される可能性があります。 それとは対象的にsyslogは、もし書き込みができなかったときメッセージの廃棄を選びます。 これらの場合にはいくつかのログメッセージを失うことになりますが、残ったシステムを阻止しません。
log_directory
(string
)
logging_collector
を有効と設定した場合、このパラメータはログファイルが作成されるディレクトリを確定します。
ディレクトリは、絶対パス、もしくはデータベースクラスタのディレクトリに対する相対パスで指定することができます。
このパラメータはpostgresql.conf
ファイル、またはサーバコマンドラインからのみ設定可能です。
デフォルトはpg_log
です。
log_filename
(string
)
logging_collector
が有効な場合、このパラメータは作成されたログファイルのファイル名を設定します。
値はstrftime
パターンとして扱われるため、%
エスケープを使用して、時刻によって変動するファイル名を指定することができます。
(時間帯に依存した%
エスケープが存在する場合、log_timezoneで指定された時間帯で計算が行われます。)
サポートされている%
-エスケープはstrftime 仕様によく似ています。
システムのstrftimeは直接使用されないので、プラットフォーム固有の(非標準)の拡張は動作しません。
デフォルトはpostgresql-%Y-%m-%d_%H%M%S.log
です。
エスケープすることなくファイル名を指定する場合、ディスク全体を使い切ってしまうことを防止するためにログローテーションを行うユーティリティを使用することを計画しなければなりません。
8.4より前のリリースのPostgreSQLでは、%
エスケープがなければ、新しいログファイルの生成時のエポック時刻を付与しますが、これはもはや当てはまりません。
CSV書式の出力がlog_destination
で有効な場合、タイムスタンプ付きのログファイル名に.csv
を付与し、最終的なCSV書式出力用のファイル名が作成されます。
(log_filenameが.log
で終わる場合は後置詞が置き換えられます。)
このパラメータはpostgresql.conf
か、サーバコマンドラインのみ設定可能です。
log_file_mode
(integer
)
Unixシステムにおいては、logging_collector
が有効になっている場合、このパラメータはログファイルのパーミッションを設定します。
(Microsoft Windowsではこのパラメータは無視されます。)
パラメータの値はchmod
および umask
システムコールで許容されるフォーマットで指定される数値モードであると期待されます。
(慣例的な8進数フォーマットを使用する場合、番号は0
(ゼロ)で始まらなければなりません。
デフォルトのパーミッションは0600
で、意味するところはサーバの所有者のみログファイルの読み書きが可能です。
そのほか一般的に実用的な設定は0640
で、所有者のグループはファイルを読み込めます。
しかし、これらの設定を活用するにはlog_directoryがクラスタデータディレクトリの外部のどこかにあるファイルを格納できるように変更する必要があります。
このパラメータはpostgresql.conf
ファイル、またはサーバコマンドラインからのみ設定可能です。
log_rotation_age
(integer
)
logging_collector
が有効な場合、このパラメータは個々のログファイルの最大寿命を決定します。
ここで指定した時間(分単位)経過すると、新しいログファイルが生成されます。
ゼロに設定することで、時間に基づいた新しいログファイルの生成は無効になります。
このパラメータは、postgresql.conf
ファイル、または、サーバのコマンドラインでのみで設定されます。
log_rotation_size
(integer
)
logging_collector
が有効な場合、このパラメータは個々のログファイルの最大容量を決定します。
ここで指定したキロバイト分ログファイルに出力された後、新しいログファイルが生成されます。
ゼロに設定することで、サイズに基づいた新しいログファイルの生成は無効になります。
このパラメータはpostgresql.conf
ファイル、または、サーバのコマンドラインでのみで設定されます。
log_truncate_on_rotation
(boolean
)
logging_collector
が有効な場合、このパラメータにより、PostgreSQLは既存の同名のファイルに追加するのではなく、そのファイルを切り詰める(上書きする)ようになります。
しかし、切り詰めは時間を基にしたローテーションのために新規にファイルが開かれた時にのみ発生し、サーバ起動時やサイズを基にしたローテーションでは発生しません。
偽の場合、全ての場合において既存のファイルは追記されます。
例えば、この設定をpostgresql-%H.log
のようなlog_filename
と組み合わせて使用すると、24個の時別のログファイルが生成され、それらは周期的に上書きされることになります。
このパラメータはpostgresql.conf
ファイル、または、サーバのコマンドラインで設定されます。
例:7日間のログを保存し、毎日のログを server_log.Mon
、server_log.Tue
、等とし、そして自動的に前週のログを今週のログで上書きするには以下のように設定します。
log_filename
を server_log.%a
とし、
log_truncate_on_rotation
を on
にし、そして
log_rotation_age
を 1440
に設定します。
例:24時間のログを保持、1時間おきに1つのログファイルを作成、ただし、ログファイルのサイズが1ギガバイトを超えた場合それより早く切り替えさせるには、
log_filename
を server_log.%H%M
にし、
log_truncate_on_rotation
を on
にし、
log_rotation_age
を 60
にし、そして
log_rotation_size
を 1000000
に設定します。
log_filename
に%M
を含めると、サイズを元にしたローテーションが時間毎の始めのファイル名とは異なる名前のファイルを選択するようにできます。
syslog_facility
(enum
)
syslogへのログ取得が有効な場合、このパラメータはsyslogの「facility」が使われるように確定します。
LOCAL0
、LOCAL1
、LOCAL2
、LOCAL3
、LOCAL4
、LOCAL5
、LOCAL6
、LOCAL7
の中から選んでください。
デフォルトはLOCAL0
です。
使用しているシステムのsyslogデーモンの文書を同時に参照してください。
このパラメータはpostgresql.conf
ファイル、または、サーバのコマンドラインでのみで設定されます。
syslog_ident
(string
)
syslogにログ取得が有効な場合、このパラメータはsyslogログ内のPostgreSQLメッセージを特定するのに使用するプログラム名を確定します。デフォルトはpostgres
です。
このパラメータは、postgresql.conf
ファイル、または、サーバのコマンドラインでのみで設定されます。
syslog_sequence_numbers
(boolean
)
syslogにログを出力している場合で、これがオン(デフォルト)であると、各メッセージには([2]
のような)増加する順序数が頭に追加されます。
これにより、多くのsyslogの実装がデフォルトで行う「--- last message repeated N times ---」による出力の抑止が回避されます。
より近代的なsyslogの実装では、繰り返されるメッセージの抑止は設定変更できるので(たとえば、rsyslog)における$RepeatedMsgReduction
)、この機能は必要ないかもしれません。
繰り返されるメッセージを抑止したい場合には、これをオフにできます。
このパラメータは、postgresql.conf
ファイル、または、サーバのコマンドラインでのみで設定されます。
syslog_split_messages
(boolean
)
syslogへのログ出力が有効な場合、このパラメータはメッセージがどのようにsyslogに送られるかを規定します。 オンなら(デフォルト)、メッセージは行に分割され、長い行は、伝統的なsyslog実装のサイズ上限でである1024バイト以内に分割されます。 オフならば、PostgreSQLサーバログメッセージは、そのままsyslogサービスに送られます。 大きなサイズになるかもしれないメッセージにどう対応するかは、syslogサービス次第となります。
もしsyslogが最終的にテキストファイルにログを出力するのであれば、どちらに設定しても効果は同じです。 設定値をオンにしておくのが最善です。 多くのsyslogの実装では、長いメッセージを扱えないか、長いメッセージを扱うための特別な設定が必要だからです。 しかし、syslogが最終的に他のメディアに書き込むのであれば、メッセージを論理的に一緒にしておくことが必要か、もしくは有用です。
このパラメータは、postgresql.conf
ファイル、または、サーバのコマンドラインでのみで設定されます。
event_source
(string
)
event logへのログ取得が有効になっていると、このパラメータはログ中のPostgreSQLメッセージを特定するのに使用されるプログラム名を決定します。デフォルトはPostgreSQL
です。このパラメータは、postgresql.conf
ファイル、または、サーバのコマンドラインでのみで設定されます。
client_min_messages
(enum
)
どのメッセージ階層をクライアントに送るかを管理します。有効な値は、DEBUG5
、
DEBUG4
、DEBUG3
、DEBUG2
、
DEBUG1
、LOG
、NOTICE
、
WARNING
、ERROR
、FATAL
、およびPANIC
です。それぞれの階層はそれに続く全ての階層を包含します。階層が後の方になるにつれ、より少ないメッセージが送られます。デフォルトはNOTICE
です。ここでのLOG
の優先順位がlog_min_messages
の場合と異なることに注意してください。
log_min_messages
(enum
)
どのメッセージ階層をサーバログに書き込むかを管理します。有効な値は
DEBUG5
、DEBUG4
、
DEBUG3
、DEBUG2
、DEBUG1
、
INFO
、NOTICE
、WARNING
、
ERROR
、LOG
、FATAL
、および
PANIC
です。それぞれの階層はその下の全ての階層を含みます。階層を低くする程、より少ないメッセージがログに送られます。デフォルトはWARNING
です。ここでのLOG
の優先順位がclient_min_messages
の場合と異なることに注意してください。スーパーユーザのみこの設定を変更できます。
log_min_error_statement
(enum
)
エラー条件の原因となったどのSQL文をサーバログに記録するかを制御します。
設定したレベル以上のメッセージについては現在のSQL文がログに記録されます。
有効な値は、DEBUG5
、DEBUG4
、DEBUG3
、DEBUG2
、DEBUG1
、INFO
、NOTICE
、WARNING
、ERROR
、LOG
、FATAL
、PANIC
です。
デフォルトはERROR
です。
エラー、ログメッセージ、致命的エラー、パニックを引き起こした文がログに記録されることを意味します。
失敗した文の記録を実質的に無効にするには、このパラメータをPANIC
に設定してください。
スーパーユーザのみがこのオプションを変更することができます。
log_min_duration_statement
(integer
)
文の実行に少なくとも指定したミリ秒数かかった場合、それぞれの文の実行に要した時間をログに記録します。
0に設定すれば、すべての文の実行時間が出力されます。
-1(デフォルト)は、文実行時間の記録を無効にします。
例えば、250ms
と設定した場合、250msもしくはそれ以上長くかかった全てのSQL文がログとして残ります。
このパラメータを有効にすることにより、アプリケーションで最適化されていない問い合わせを追跡するのが便利になります。
スーパーユーザのみこの設定を変更できます。
拡張問い合わせプロトコルを使用するクライアントでは、Parse、Bind、Executeそれぞれの段階で要した時間が独立して記録されます。
このオプションとlog_statementを一緒に使用する時、log_statement
によってログされるテキスト文は、実行時間のログには重複されません。
syslogを使用していなければ、プロセスIDとセッションIDを使用して、文メッセージと後の実行時間メッセージを関連付けできるように、log_line_prefixを使用してPIDまたはセッションIDをログに記録することを勧めます。
表19.1「メッセージ深刻度レベル」で、PostgreSQLで使用されるメッセージ深刻度レベルを説明します。 ログ出力がsyslogまたはWindowsのeventlogに送られる場合、この深刻度レベルは表で示すように変換されます。
表19.1 メッセージ深刻度レベル
深刻度 | 使用方法 | syslog | eventlog |
---|---|---|---|
DEBUG1..DEBUG5 | 開発者が使用する連続的かつより詳細な情報を提供します。 | DEBUG | INFORMATION |
INFO | VACUUM VERBOSE の出力などの、
ユーザによって暗黙的に要求された情報を提供します。 | INFO | INFORMATION |
NOTICE | 長い識別子の切り詰めに関する注意など、 ユーザの補助になる情報を提供します。 | NOTICE | INFORMATION |
WARNING | トランザクションブロック外でのCOMMIT の様な、
ユーザへの警告を提供します。 | NOTICE | WARNING |
ERROR | 現在のコマンドを中断させる原因となったエラーを報告します。 | WARNING | ERROR |
LOG | チェックポイントの活動の様な、 管理者に関心のある情報を報告します。 | INFO | INFORMATION |
FATAL | 現在のセッションを中断させる原因となったエラーを報告します。 | ERR | ERROR |
PANIC | 全てのデータベースセッションを中断させる原因となったエラーを報告します。 | CRIT | ERROR |
application_name
(string
)
application_name
はNAMEDATALEN
(標準構築では64)文字以下の任意の文字列を指定できます。
通常はサーバへの接続時にアプリケーションによって設定されます。
この名前は pg_stat_activity
ビューに表示され、CSVログに含まれます。
またlog_line_prefixパラメータにより通常のログ項目に含めることができます。
application_name
には表示可能なASCII文字のみ使用することができ、それ以外の文字は疑問符(?
)に置換されます。
debug_print_parse
(boolean
)
debug_print_rewritten
(boolean
)
debug_print_plan
(boolean
)
これらのパラメータは生成される各種デバッグ出力を有効にします。
設定すると実行された問い合わせそれぞれに対し、最終的な解析ツリー、問い合わせリライタの出力、実行計画を出力します。
これらのメッセージはLOG
メッセージレベルで出力されますので、デフォルトではサーバログに出力され、クライアントには渡されません。
client_min_messages、log_min_messagesまたはその両方を調整することで変更することができます。
デフォルトではこれらのパラメータは無効です。
debug_pretty_print
(boolean
)
設定された場合、debug_print_parse
、
debug_print_rewritten
、または
debug_print_plan
で生成されたメッセージを字下げします。設定されない場合の「コンパクト」形式よりもより見やすく、しかしより長いものとなります。デフォルトは有効です。
log_checkpoints
(boolean
)
チェックポイントおよびリスタートポイントをサーバログに記録するようにします。
書き出されたバッファ数や書き出しに要した時間など、いくつかの統計情報がこのログメッセージに含まれます。
このパラメータはpostgresql.conf
ファイルまたはサーバのコマンドラインでのみ設定可能です。
デフォルトはoffです。
log_connections
(boolean
)
これにより、クライアント認証の成功終了などのサーバへの接続試行がログに残ります。
スーパーユーザだけがセッション開始時にこのパラメータを変更でき、セッションが開始された後は変更できません。
デフォルトはoff
です。
psqlなどクライアントプログラムは、パスワードが要求されているかどうか確認するまで2回接続を試みるので、二重の「connection received」メッセージは必ずしも問題を示すものではありません。
log_disconnections
(boolean
)
セッションの終了をログします。
ログ出力の情報はlog_connections
と同様で、更にセッションの経過時間が追加されます。
スーパーユーザだけがセッション開始時にこのパラメータを変更でき、セッションが開始された後は変更できません。
デフォルトはoff
です。
log_duration
(boolean
)
すべての完了した文について、その経過時間をログするようにします。
デフォルトはoff
です。
スーパーユーザのみがこの設定を変更することができます。
拡張問い合わせプロトコルを使用するクライアントでは、Parse、Bind、Executeそれぞれの段階で要した時間が独立して記録されます。
このオプションとlog_min_duration_statementを0に設定する方法との違いは、log_min_duration_statement
を超えた場合、テキスト版の問い合わせが強制的に出力されるのに対して、このオプションでは出力されないという点です。
したがって、log_duration
がon
、かつ、log_min_duration_statement
が正の値を持つ場合、すべての経過時間がログに記録されますが、閾値を超えた文のみがテキスト版の問い合わせが含められるようになります。
この動作は、高負荷なインストレーションで統計情報を収集する際に有用です。
log_error_verbosity
(enum
)
ログ取得されるそれぞれのメッセージに対し、サーバログに書き込まれる詳細の量を制御します。
有効な値は、TERSE
、DEFAULT
、およびVERBOSE
で、それぞれは表示されるメッセージにより多くのフィールドを追加します。
TERSE
はDETAIL
、HINT
、QUERY
、およびCONTEXT
エラー情報を除外します。
VERBOSE
出力は、SQLSTATE
エラーコード(付録A PostgreSQLエラーコードも参照)、および、ソースコードファイル名、関数名、そしてエラーを生成した行番号を含みます。
スーパーユーザのみこの設定を変更できます。
log_hostname
(boolean
)
デフォルトでは、接続ログメッセージは接続元ホストのIPアドレスのみを表示します。
このパラメータを有効にすると、ホスト名もログに残るようになります。
ホスト名解決方法の設定に依存しますが、これが無視できないほどの性能劣化を起こす可能性があることに注意してください。
このパラメータはpostgresql.conf
ファイル内またはサーバのコマンドラインでのみ設定可能です。
log_line_prefix
(string
)
これは、各ログ行の先頭に出力するprintf
の書式文字列です。
%
から始まる「エスケープシーケンス」は、後述の通りのステータス情報で置き換えられます。
この他のエスケープは無視されます。
他の文字はそのままログ行に出力されます。
エスケープの中には、セッションプロセスによってのみ認識可能なものがあり、これらはメインサーバプロセスなどのバックグラウンドプロセスでは空文字として扱われます。
状態情報はオプション名の%の後か前に数字を指定することにより、左寄せまた右寄せにすることができます。
数字が負ならば状態情報を右側に空白を詰めて最小限の幅にし、正の値は左に空白を詰めます。
ログファイルではパディングは人間の視認性を向上させるので有用です。
このパラメータは、postgresql.conf
ファイル、または、サーバのコマンドラインでのみで設定することができます。
デフォルトは空文字列です。
エスケープ | 効果 | セッションのみ |
---|---|---|
%a | アプリケーション名 | ○ |
%u | ユーザ名 | ○ |
%d | データベース名 | ○ |
%r | 遠隔ホスト名、またはIPアドレス、およびポート番号 | ○ |
%h | 遠隔ホスト名、またはIPアドレス | ○ |
%p | プロセス識別子 | × |
%t | ミリ秒無しのタイムスタンプ | × |
%m | ミリ秒付きタイムスタンプ | × |
%n | ミリ秒付きタイムスタンプ(Unixエポックとして) | × |
%i | コマンドタグ。セッションの現在のコマンド種類 | ○ |
%e | SQLSTATE エラーコード | × |
%c | セッションID。下記参照 | × |
%l | 各セッションまたは各プロセスのログ行の番号。1から始まります。 | × |
%s | プロセスの開始タイムスタンプ | × |
%v | 仮想トランザクションID(backendID/localXID) | × |
%x | トランザクションID (未割り当ての場合は0) | × |
%q | 何も出力しません。 非セッションプロセスではこのエスケープ以降の出力を停止します。 セッションプロセスでは無視されます。 | × |
%% | % 文字そのもの | × |
%c
エスケープは、2つの4バイトの16進数(先頭のゼロは省略)をドットで区切った構成の、準一意なセッション識別子を表示します。
この数値はプロセスの起動時間とそのプロセスIDです。
したがって、%c
を使用して、これらの項目を出力するための文字数を省略することができます。例として、pg_stat_activity
からセッション識別子を生成するには以下の問い合わせを行ないます。
SELECT to_hex(trunc(EXTRACT(EPOCH FROM backend_start))::integer) || '.' || to_hex(pid) FROM pg_stat_activity;
log_line_prefix
に空白文字以外の値を設定する場合、通常、ログ行の残りとの区切りを明確にするために、その最後の文字を空白文字にすべきです。
句読点用の文字も使用できます。
Syslogは独自にタイムスタンプとプロセスID情報を生成します。 ですのでおそらく、Syslogにログを保管する場合は、こうしたエスケープを含めるとは考えないでしょう。
log_lock_waits
(boolean
)
セッションがロックの獲得までの間にdeadlock_timeoutより長く待機する場合にログメッセージを生成するかどうかを制御します。
これは、ロック待ちによって性能がでていないのかどうか確認する時に有用です。
デフォルトはoff
です。
スーパーユーザのみこの設定を変更できます。
log_statement
(enum
)
どのSQL文をログに記録するかを制御します。
有効な値は、none
(off)、ddl
、mod
、およびall
(全てのメッセージ)です。
ddl
は、CREATE
、ALTER
、およびDROP
文といった、データ定義文を全てログに記録します。
mod
は、全てのddl
文に加え、INSERT
、UPDATE
、DELETE
、TRUNCATE
、およびCOPY FROM
といった、データ変更文をログに記録します。
PREPARE
とEXPLAIN ANALYZE
コマンドも、そこに含まれるコマンドが適切な種類であればログが録られます。
拡張問い合わせプロトコルを使用するクライアントでは、Executeメッセージを受け取った時にBindパラメータの値が(すべての単一引用符が二重にされた状態で)含まれていた場合、ログに記録されます。
デフォルトはnone
です。スーパーユーザのみこの設定を変更できます。
ログメッセージの発行は、基本解析により文の種類が決まった後に行われますので、log_statement
= all
という設定を行ったとしても、単純な構文エラーを持つ文は記録されません。
拡張問い合わせプロトコルの場合も同様に、この設定ではExecute段階以前(つまり、解析や計画作成期間)に失敗した文は記録されません。
こうした文のログを記録するには、log_min_error_statement
をERROR
(以下)に設定してください。
log_replication_commands
(boolean
)
サーバログにレプリケーションコマンドを記録します。
レプリケーションコマンドの更なる情報は51.3. ストリーミングレプリケーションプロトコルをご覧ください。
デフォルト値はoff
です。
スーパーユーザだけがこの設定を変更できます。
log_temp_files
(integer
)
一時ファイルのファイル名とサイズのログ出力を制御します。 一時ファイルはソート処理やハッシュ処理、一時的な問い合わせの結果のために作成されます。 ログの項目はすべての一時ファイルそれぞれについて削除されたときに生成されます。 0を指定すると、すべての一時ファイル情報のログが残ります。 正の数を指定すると、指定した値のキロバイト以上の容量のファイルのみがログに残ります。 デフォルトの設定は-1で、このログ出力を無効にします。 スーパーユーザのみがこの設定を変更できます。
log_timezone
(string
)
サーバログに書き出す際に使用される時間帯を設定します。
TimeZoneと異なり、すべてのセッションで一貫性を持ってタイムスタンプが報告されるようにこの値はクラスタ全体に適用されます。
組み込まれているデフォルトはGMT
ですが、postgresql.conf
により通常は上書きされます。initdbによりこれらと関連した設定をシステム環境にインストールされます。
詳細は8.5.3. 時間帯を参照してください。
このパラメータはpostgresql.conf
内またはサーバのコマンドラインでのみ設定することができます。
log_destination
リストにcsvlog
を含めることは、ログファイルをデータベーステーブルにインポートする簡便な方法を提供します。このオプションはカンマ区切り値書式(CSV)で以下の列を含むログ行を生成します。
ミリ秒単位のtimestamp、
ユーザ名、
データベース名、
プロセス識別子、
クライアントホスト:ポート番号、
セッション識別子、
セッション前行番号、
コマンドタグ、
セッション開始時間、
仮想トランザクション識別子、
通常トランザクション識別子、
エラーの深刻度、
SQL状態コード、
エラーメッセージ、
詳細エラーメッセージ、
ヒント、
エラーとなった内部的な問い合わせ(もしあれば)、
内部問い合わせにおけるエラー位置の文字数、
エラーの文脈、
PostgreSQLソースコード上のエラー発生場所(log_error_verbosity
がverbose
に設定されているならば)
アプリケーション名。
以下にcsvlog出力を格納するためのテーブル定義のサンプルを示します。
CREATE TABLE postgres_log ( log_time timestamp(3) with time zone, user_name text, database_name text, process_id integer, connection_from text, session_id text, session_line_num bigint, command_tag text, session_start_time timestamp with time zone, virtual_transaction_id text, transaction_id bigint, error_severity text, sql_state_code text, message text, detail text, hint text, internal_query text, internal_query_pos integer, context text, query text, query_pos integer, location text, application_name text, PRIMARY KEY (session_id, session_line_num) );
このテーブルにインポートするためには、COPY FROM
コマンドを使用してください。
COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
CSVログファイルをインポートする作業を単純にするためにいくつか必要な作業があります。
一貫性があり、予測可能なログファイル命名機構を提供するために、log_filename
およびlog_rotation_age
を設定してください。
これによりどのようなファイル名になると、個々のログファイルが完了しインポートする準備が整ったかが推測できるようになります。
ログファイル名の予測が困難になりますので、log_rotation_size
を0にして容量を基にしたログの回転を無効にしてください。
同じファイルに古いログデータと新しいログデータが混在しないようにするために、log_truncate_on_rotate
をon
に設定してください。
上のテーブル定義には主キーの指定が含まれています。
これにより、同じ情報が2回インポートされる事故を防止するために有用です。
COPY
コマンドは、一度にインポートするすべてのデータをコミットしますので、何か1つでもエラーがあればインポート全体が失敗します。
ログファイルの一部をインポートし、そのファイルが完了した後に再度インポートしようとした場合、主キー違反によりインポートが失敗します。
インポートする前に、ログファイルの完了を待ち、閉じるまで待機してください。
この手順は、COPY
が失敗する原因となる、完全に書き込まれなかった欠落した行をインポートするという事故も防止します。
これらの設定項目は、ps
で見えるサーバプロセスの表題を変更します。
プロセスの表題は、典型的にはps、あるいはWindowsにおいてはProcess Explorerで見ることができます。
詳細については、28.1. 標準的なUnixツールを参照してください。
cluster_name
(string
)
このクラスタ内のすべてのサーバプロセス表題にクラスタ名を設定します。
クラスタ名はNAMEDATALEN
文字(標準のビルドでは64文字)より少ない文字列です。
表示可能なASCII文字だけがcluster_name
の値として設定できます。
他の文字は、疑問符(?
)に置き換えられます。
空文字''
(これがデフォルト値です)が設定されると、クラスタ名は表示されません。
このパラメータはサーバ起動時にのみ設定できます。
update_process_title
(boolean
)
サーバが新しいSQLコマンドを受け取る時に毎回、プロセスタイトルを更新できるようにします。
この設定値はたいていのプラットフォームでon
がデフォルトになっていますが、Windowsではプロセスタイトルを更新するオーバヘッドが大きいため、off
がデフォルトになっています。
スーパーユーザのみがこの設定を変更することができます。