PostgreSQL 錯誤報告和日志

PostgreSQL支持多種方法來記錄服務器消息，包括stderr、csvlog和syslog。在 Windows 上還支持eventlog。設置這個參數(shù)為一個由想要的日志目的地的列表，之間用逗號分隔。默認值是只記錄到 stderr。這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

如果csvlog被包括在log_destination中，日志項會以“逗號分隔值”（CSV）格式被輸出，這樣可以很方便地把日志載入到程序中。詳見本文中第 19.8.4 節(jié)。要產(chǎn)生 CSV 格式的日志輸出，必須啟用?logging_collector?。

當包括有stderr或csvlog時，會創(chuàng)建文件current_logfiles來記錄當前正在被日志收集器使用的日志文件的位置以及相關的日志目的地。這提供了一種查找實例當前使用的日志的便利手段。這里是該文件內容的一個例子：

stderr log/postgresql.log
csvlog log/postgresql.csv

當由于輪轉效應創(chuàng)建一個新的日志文件時以及log_destination被重載時，current_logfiles文件會被重建。當log_destination中不包括stderr和csvlog時以及當日志收集器被禁用時，這個文件會被刪除。

local0.*    /var/log/postgresql

這個參數(shù)啟用日志收集器，它是一個捕捉被發(fā)送到stderr的日志消息的后臺進程，并且它會將這些消息重定向到日志文件中。這種方法比記錄到syslog通常更有用，因為某些類型的消息不會在syslog輸出中出現(xiàn)（一個常見的例子是動態(tài)鏈接器錯誤消息；另一個例子是由 archive_command等腳本產(chǎn)生的錯誤消息）。這個參數(shù)只能在服務器啟動時設置。

當logging_collector被啟用時，這個參數(shù)決定日志文件將被在哪個目錄下創(chuàng)建。它可以被指定為一個絕對路徑，也可以被指定為一個相對于集簇數(shù)據(jù)目錄的相對路徑。這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。 默認是log。

當logging_collector被啟用時，這個參數(shù)設置被創(chuàng)建的日志文件的文件名。 該值被視為一種strftime模式，因此%轉義可以被用來指定根據(jù)時間變化的文件名（注意如果有任何時區(qū)獨立的%轉義，計算將在由?log_timezone?指定的時區(qū)中完成）。 被支持的%轉義和開放組織的strftime說明中列舉的類似。 注意系統(tǒng)的strftime不會被直接使用，因此平臺相關（非標準）的擴展無法工作。 默認是 postgresql-%Y-%m-%d_%H%M%S.log。

如果你不使用轉義來指定一個文件名，你應該計劃使用一個日志輪轉工具來避免最終填滿整個磁盤。在 8.4 發(fā)行之前，如果不存在%轉義，PostgreSQL將追加新日志文件創(chuàng)建時間的紀元，但是現(xiàn)在已經(jīng)不再這樣做了。

如果在log_destination中啟用了 CSV 格式輸出，.csv將會被追加到時間戳日志文件名中來創(chuàng)建 CSV 格式輸出（如果log_filename以.log結尾，該后綴會被替換）。

這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

在 Unix 系統(tǒng)上，當logging_collector被啟用時，這個參數(shù)設置日志文件的權限（在微軟 Windows 上這個參數(shù)將被忽略）。這個參數(shù)值應當是一個數(shù)字形式的模式，它可以被chmod和umask系統(tǒng)調用接受（要使用通常的十進制格式，該數(shù)字必須以一個0（零）開始）。

默認的權限是0600，表示只有服務器擁有者才能讀取或寫入日志文件。其他常用的設置是0640，它允許擁有者的組成員讀取文件。不過要注意你需要修改?log_directory?為將文件存儲在集簇數(shù)據(jù)目錄之外的某個位置，才能利用這個設置。在任何情況下，讓日志文件變成任何人都可讀是不明智的，因為日志文件中可能包含敏感數(shù)據(jù)。

這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

當logging_collector被啟用時，這個參數(shù)決定使用一個單個日志文件的最大時間量，之后將創(chuàng)立一個新的日志文件。 如果指定值時沒有單位，則以分鐘為單位。默認為24小時。 將這個參數(shù)設置為零將禁用基于時間的新日志文件創(chuàng)建。這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

當logging_collector被啟用時，這個參數(shù)決定一個個體日志文件的最大尺寸。 當這些數(shù)據(jù)量被發(fā)送到一個日志文件后，將創(chuàng)建一個新的日志文件。 如果指定值的時候沒有單位，則以千字節(jié)為單位。默認值是10兆字節(jié)。設置為零時將禁用基于大小創(chuàng)建新的日志文件。 這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

當logging_collector被啟用時，這個參數(shù)將導致PostgreSQL截斷（覆蓋而不是追加）任何已有的同名日志文件。不過，截斷只在一個新文件由于基于時間的輪轉被打開時發(fā)生，在服務器啟動或基于尺寸的輪轉時不會發(fā)生。如果被關閉，在所有情況下以前存在的文件將被追加。例如，使用這個設置和一個類似postgresql-%H.log的 log_filename將導致產(chǎn)生 24 個每小時的日志文件，并且循環(huán)地覆蓋它們。這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

例子：要保留 7 天的日志，每天的一個日志文件被命令為server_log.Mon、server_log.Tue等等，并且自動用本周的日志覆蓋上一周的日志?？梢赃@樣做：將log_filename設置為server_log.%a、將log_truncate_on_rotation設置為 on并且將log_rotation_age設置為1440。

例子：要保留 24 小時的日志，每個小時一個日志文件，但是在日志文件尺寸超過 1GB 時輪轉。可以這樣做：將log_filename設置為server_log.%H%M、 將log_truncate_on_rotation設置為on、 將log_rotation_age設置為 60并且 將log_rotation_size設置為1000000。 在log_filename中包括%M允許發(fā)生任何尺寸驅動的輪轉來選擇一個不同于每個小時的初始文件名的新文件名。

當啟用了向syslog記錄時，這個參數(shù)決定要使用的syslog“設備”。你可以在LOCAL0、LOCAL1、LOCAL2、 LOCAL3、LOCAL4、 LOCAL5、LOCAL6、LOCAL7中選擇，默認值是LOCAL0。還請參閱系統(tǒng)的syslog守護進程的文檔。這個參數(shù)只能在 postgresql.conf文件中或在服務器命令行上設置。

當啟用了向syslog記錄時，這個參數(shù)決定用來標識syslog中的PostgreSQL消息的程序名。默認值是postgres。這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

當日志被記錄到syslog并且這個設置為 on （默認）時，每一個消息會被加上一個增長的序號作為前綴（例如[2]）。這種行為避開了很多 syslog 實現(xiàn)默認采用的“--- 上一個消息重復 N 次 ---”形式。在現(xiàn)代 syslog 實現(xiàn)中，抑制重復消息是可以配置的（例如 rsyslog中的$RepeatedMsgReduction），因此這個參數(shù)可能不是必需的。此外，如果你真的想抑制重復消息，你可以把這個參數(shù)設置為 off。

這個參數(shù)只能在postgresql.conf文件或者服務器命令行上設置。

當啟用把日志記錄到syslog時，這個參數(shù)決定消息如何送達 syslog。當設置為 on（默認）時，消息會被分成行，并且長的行也會被劃分以便能夠放到 1024 字節(jié)中，這是傳統(tǒng) syslog 實現(xiàn)一種典型的尺寸限制。當設置為 off 時，PostgreSQL 服務器日志消息會被原樣送達 syslog 服務，而處理可能的大體量消息的任務由 syslog 服務負責。

如果 syslog 最終被記錄到一個文本文件中，那么兩種設置的效果是一樣的，但最好設置為 on，因為大部分 syslog 實現(xiàn)要么不能處理大型消息，要么需要做特殊的配置以處理大型消息。但是如果 syslog 最終寫入到某種其他媒介，有必要讓消息保持邏輯上的整體性（也更加有用）。

這個參數(shù)只能在postgresql.conf文件或者服務器命令行上設置。

當啟用了向事件日志記錄時，這個參數(shù)決定用來標識日志中PostgreSQL消息的程序名。默認值是PostgreSQL。這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

控制哪些消息級別（本文中表19.2 消息嚴重級別中可以查閱） 被寫入到服務器日志。有效值是DEBUG5、DEBUG4、 DEBUG3、 DEBUG2、DEBUG1、 INFO、NOTICE、WARNING、 ERROR、LOG、FATAL和 PANIC。每個級別都包括以后的所有級別。級別越靠后，被發(fā)送的消息越少。默認值是WARNING。注意LOG在這里有與client_min_messages中不同的排名。只有超級用戶可以改變這個設置。

控制哪些導致一個錯誤情況的 SQL 語句被記錄在服務器日志中。任何指定 嚴重級別（本文中表19.2 消息嚴重級別中可以查閱） 或更高級別的消息的當前 SQL 語句將被包括在日志項中。有效值是DEBUG5、 DEBUG4、 DEBUG3、 DEBUG2、DEBUG1、 INFO、NOTICE、 WARNING、ERROR、 LOG、 FATAL和PANIC。默認值是ERROR，它表示導致錯誤、日志消息、致命錯誤或恐慌錯誤的語句將被記錄在日志中。要有效地關閉記錄失敗語句，將這個參數(shù)設置為PANIC。只有超級用戶可以改變這個設置。

如果語句運行至少指定的時間量，將導致記錄每一個這種完成的語句的持續(xù)時間。 例如，如果你設置它為250ms，那么所有運行 250ms 或更久的 SQL 語句將被記錄。 啟用這個參數(shù)可以有助于追蹤應用中未優(yōu)化的查詢。如果指定值時沒有單位，則以毫秒為單位。將這個參數(shù)設置為零將打印所有語句的執(zhí)行時間。 設置為 -1（默認值）將停止記錄語句持續(xù)時間。只有超級用戶可以改變這個設置。

這會覆蓋?log_min_duration_sample?，意味著持續(xù)時間超過此設置的查詢不進行抽樣，并且始終被記錄。

對于使用擴展查詢協(xié)議的客戶端，解析、綁定和執(zhí)行步驟的持續(xù)時間將被獨立記錄。

允許對最少運行了指定時間的已完成語句的持續(xù)時間進行抽樣。 這將生成與?log_min_duration_statement ?相同的日志條目，但僅適用于已執(zhí)行語句的子集，采樣率由 ?log_statement_sample_rate ?控制。 例如，如果將它設置為 100ms則所有運行 100ms 或更長的 SQL 語句都將被采樣。 當流量過高而無法記錄所有查詢時，啟用此參數(shù)會很有幫助。如果指定此值時沒有單位，則以毫秒為單位。 設置為零將采樣所有語句持續(xù)時間。-1（默認值）禁用采樣語句持續(xù)時間。只有超級用戶可以更改此設置。

此設置的優(yōu)先級低于 log_min_duration_statement，意味著持續(xù)時間超過 log_min_duration_statement 的語句不被采樣，并且始終被記錄。

log_min_duration_statement的其他注釋也適用于此設置。

確定持續(xù)時間超過 ?log_min_duration_sample?的語句的部分。 采樣是隨機的，例如0.5意味著從統(tǒng)計學上講，任何給定語句都有1/2的概率將被記錄。 默認值為 1.0，意味著要記錄所有采樣語句。 設置為零將禁用采樣語句持續(xù)時間日志，與將 log_min_duration_sample設為 -1 相同。 只有超級用戶可以更改此設置。

設置所有語句都被記錄的交易的部分，以及由于其他原因而記錄的語句。它適用于每個新事務，而不考慮其語句的持續(xù)時間。 采樣是隨機的，例如 0.1意味著從統(tǒng)計學上講，任何給定事務都有十分之一的機會將被記錄。 log_transaction_sample_rate 有助于構建一個事務示例. 默認值為 0，表示不記錄任何額外事務的語句。 設置這個為 1將記錄所有交易的所有語句。只有超級用戶可以更改此設置。

application_name可以是任意小于NAMEDATALEN個字符（標準編譯中是 64 個字符）的字符串。這通常由一個應用通過到服務器的連接設置。該名稱將被顯示在pg_stat_activity視圖中并被包括在 CSV 日志項中。它也會被通過?log_line_prefix?包括在普通日志項中。只有可打印 ASCII 字符能被使用在application_name之中。其他字符將被替換為問號（?）。

這個參數(shù)啟用發(fā)出各種調試輸出。當設置時，會打印生成的解析樹， 查詢重寫輸出，或執(zhí)行的每個查詢的執(zhí)行計劃。這些信息是在LOG 信息級別發(fā)出，因此默認的，它們會出現(xiàn)在服務器日志中，但不會發(fā)送給客戶端。 可以通過 client_min_messages和/或log_min_messages 來設置。這些參數(shù)缺省是off。 這些參數(shù)將會讓多種調試輸出被發(fā)出。當被設置時，它們?yōu)槊恳粋€被執(zhí)行的查詢打印結果分析樹、查詢重寫器輸出或執(zhí)行計劃。這些消息在LOG消息級別上被發(fā)出，因此默認情況下它們將出現(xiàn)在服務器日志中但不會被發(fā)送到客戶端。你可以通過調整 client_min_messages和/或?log_min_messages?來改變這種情況。這些參數(shù)默認是關閉的。

當被設置時，debug_pretty_print會縮進由debug_print_parse、 debug_print_rewritten或 debug_print_plan產(chǎn)生的輸出。這將導致比關閉參數(shù)時使用的“緊湊”模式可讀性更強但是更長的輸出。它默認是打開的。

導致檢查點和重啟點被記錄在服務器日志中。一些統(tǒng)計信息也被包括在日志消息中，包括寫入緩沖區(qū)的數(shù)據(jù)和寫它們所花的時間。這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。默認值是關閉。

導致每一次嘗試對服務器的連接被記錄，客戶端認證的成功完成也會被記錄。 只有超級用戶能在會話開始時更改這個參數(shù)，在會話中它不能被更改。默認 為off。

導致會話終止被記錄。日志輸出提供的信息類似于 log_connections，不過還外加會話的持續(xù)時間。 只有超級用戶能在會話開始時更改這個參數(shù)，在會話中它不能被更改。默認 為off。

導致每一個完成的語句的持續(xù)時間被記錄。默認值是off。只有超級用戶可以改變這個設置。

對于使用擴展查詢協(xié)議的客戶端，解析、綁定和執(zhí)行步驟的持續(xù)時間將被獨立記錄。

控制為每一個被記錄的消息要寫入到服務器日志的細節(jié)量。有效值是TERSE、DEFAULT和VERBOSE，每一個都為顯示的消息增加更多域。TERSE排除記錄DETAIL、HINT、 QUERY和CONTEXT錯誤信息。VERBOSE輸出包括SQLSTATE錯誤碼（見附錄 A）以及產(chǎn)生錯誤的源代碼文件名、函數(shù)名和行號。只有超級用戶能夠更改這個設置。

默認情況下，連接日志消息只顯示連接主機的 IP 地址。打開這個參數(shù)將導致也記錄主機名。注意根據(jù)你的主機名解析設置，這可能會導致很微小的性能損失。這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

這是一個printf風格的字符串，它在每個日志行的開頭輸出。 %字符開始“轉義序列”，它將被按照下文描述的替換成狀態(tài)信息。 未識別的轉義被忽略。其他字符被直接復制到日志行。某些轉義只被會話進程識別并且被主服務器進程等后臺進程當作空。 通過指定一個在%之后和該選項之前的數(shù)字可以讓狀態(tài)信息左對齊或右對齊。 負值將導致在右邊用空格填充狀態(tài)信息已達到最小寬度，而正值則在左邊填充。填充對于日志文件的人類可讀性大有幫助。

這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。默認值是'%m [%p] '，它記錄時間戳和進程ID。

后端類型對應視圖 pg_stat_activity 中的backend_type列。 但是其他類型可能會出現(xiàn)在日志中而不顯示在該視圖中。

%c轉義打印一個準唯一的會話標識符，它由兩個 4 字節(jié)的十六進制數(shù)（不帶先導零）組成，以點號分隔。 這些數(shù)字是進程啟動時間和進程 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 = '%m [%p] %q%u@%d/%a '

控制當一個會話為獲得一個鎖等到超過deadlock_timeout時，是否要產(chǎn)生一個日志消息。這有助于決定是否所等待造成了性能低下。默認值是off。只有超級用戶可以更改這個設置。

如果大于零，則使用非錯誤語句日志消息記錄的每個綁定參數(shù)值都被裁剪為這么多字節(jié)。 零禁用非錯誤語句日志的綁定參數(shù)日志。-1（默認值）允許綁定參數(shù)被完整登錄。 如果指定此值時沒有單位，則將其作為字節(jié)。只有超級用戶可以更改此設置。

此設置僅影響作為結果打印的日志消息?log_statement?,?log_duration?, 和相關的設置。 該設置的非零值會增加一些開銷，特別是當參數(shù)以二進制形式發(fā)送時，因為需要轉換為文本。

如果大于零，則錯誤消息中報告的每個綁定參數(shù)值都將裁剪為這么多字節(jié)。 零(默認值)禁止在錯誤消息中包含綁定參數(shù)。-1允許打印完整綁定參數(shù)。 如果指定此值時沒有單位，則將其作為字節(jié)。

該設置的非零值會增加開銷，由于PostgreSQL需要在每條語句的開始處將參數(shù)值的文本表示存儲在內存中，無論最終是否會發(fā)生錯誤。 當綁定參數(shù)以二進制形式發(fā)送時，開銷比以文本形式發(fā)送時更大，因為前者需要數(shù)據(jù)轉換，而后者只需要復制字符串。

控制哪些 SQL 語句被記錄。有效值是 none (off)、ddl、mod和 all（所有語句）。ddl記錄所有數(shù)據(jù)定義語句，例如CREATE、 ALTER和 DROP語句。mod記錄所有ddl語句，外加數(shù)據(jù)修改語句例如INSERT, UPDATE、DELETE、TRUNCATE, 和COPY FROM。 如果PREPARE、EXECUTE和 EXPLAIN ANALYZE包含合適類型的命令，它們也會被記錄。對于使用擴展查詢協(xié)議的客戶端，當收到一個執(zhí)行消息時會產(chǎn)生日志并且會包括綁定參數(shù)的值（任何內嵌的單引號會被雙寫）。

默認值是none。只有超級用戶可以改變這個設置。

導致每一個復制命令都被記錄在服務器日志中。關于復制命令的詳細信息請見 第 52.4 節(jié)。默認值是off。只有 超級用戶可以更改這個設置。

控制記錄臨時文件名和尺寸。臨時文件可以被創(chuàng)建用來排序、哈希和存儲臨時查詢結果。 如果啟用這個設置，當每一個臨時文件被刪除時都會產(chǎn)生一個日志項。 一個零值記錄所有臨時文件信息，而正值只記錄尺寸大于或等于指定數(shù)據(jù)量的文件。如果指定值時沒有單位，則以千字節(jié)為單位。默認設置為 -1，它禁用這種記錄。只有超級用戶可以更改這個設置。

設置在服務器日志中寫入的時間戳的時區(qū)。和TimeZone不同，這個值是集簇范圍的，因此所有會話將報告一致的時間戳。內建默認值是GMT，但是通常會被在postgresql.conf中覆蓋。initdb將安裝一個對應于其系統(tǒng)環(huán)境的設置。詳見 第 8.5.3 節(jié)。這個參數(shù)只能在postgresql.conf文件中或在服務器命令行上設置。

為不同目的設置標識這個數(shù)據(jù)庫集群(實例)的名稱。此集群名稱出現(xiàn)在該集群中所有服務器進程的進程標題中。 此外，它還是備用連接的默認應用名稱。(參見 synchronous_standby_names.)

這個名稱可以是任何長度不超過NAMEDATALEN個字符（在標準編譯中是 64字符）的任何字符串。只有可打印的 ASCII 字符能被用在cluster_name值中。其他字符將被替換為問號（?）。如果這個參數(shù)被設置為空字符串''（也是默認值），將不會顯示名稱。這個參數(shù)只能在服務器啟動時設置。

啟用進程標題更新，每次服務器接收到一個新的 SQL 命令時都更新進程標題。在大部分平臺上這個設置默認為on，但是由于 Windows 上更新進程標題的開銷更大，所以在 Windows 這個設置默認為off。只有超級用戶能更改這個設置。