18.8. 错误报告和日志

PostgreSQL支持多种记录服务器日志的方法，包括stderr, csvlog和 syslog。 在Windows里，还支持eventlog。把这个选项设置为一个逗号分隔的日志目标的列表。 缺省是只记录到stderr。这个选项只能在postgresql.conf文件 或者服务器命令行设置。

如果csvlog包含在log_destination中， 日志项是用"逗号分隔"(CSV)格式的输出，这便于加载日志到程序。参见第 18.8.4 节获取更多详情。 logging_collector必须能够产生CSV格式的日志输出。

这个参数启动日志收集， 这是一个后台进程，抓取发送到stderr的日志消息，并会将他们重定向到日志文件。 这个方法通常比记录到syslog更有用， 因为有些消息类型可能不会出现在syslog输出中 (一个常见的例子是动态连接失败的消息；另外一个是通过脚本比如archive_command 产生的错误消息。） 这个值只能在服务器启动的时候设置。

在打开了logging_collector的时候，这个选项判断日志文件在哪个目录里创建。 它可以声明成绝对路径，或者是与集群的数据目录相对的路径。 这个选项只能在postgresql.conf文件里或者服务器命令行设置。 缺省是pg_log。

在打开了logging_collector的时候，这个选项设置所创建的日志文件的文件名。 这个数值将被当作strftime模式看待。因此可以用%转义声明随时间而变的文件名。 （注意，如果有任何时区相关%转义，由log_timezone声明的时区进行计算。） 支持的%转义类似于Open Group上的strftime规范列表中的。 注意，不直接使用这个系统的strftime，所以特定平台的（非标准）扩展不起作用。 缺省是postgresql-%Y-%m-%d_%H%M%S.log。

如果您没有转义指定文件名，你应该计划使用日志旋转程序以避免最终填充 整个磁盘。在8.4之前的版本中，如果没有%的转义符出现， PostgreSQL将追加新日志文件创建时间的时间戳， 但是不再是这种情况了。

如果启用log_destination中的CSV格式输出， .csv将追加时间戳日志文件名来创建CSV格式输出的文件名。 （如果log_filename以.log为结束，后缀代替）。 在上面的例子情况下，CSV文件名是server_log.1093827753.csv。

这个参数只能在postgresql.conf文件里或者服务器命令行上设置。

在Unix系统上，当logging_collector已启用时（在Microsoft Windows上将忽略此参数）， 此参数用于设置日志文件的权限。 该参数值预期为通过chmod和umask 系统调用接受的格式指定的数字模式。 （为了使用习惯八进制格式的数字必须以0(zero)开始）。

默认的权限0600，只意味着 服务器拥有者可以读取或写入日志文件。其他较普遍 有用的设置是0640，让拥有者组成员来读取文件。 但是请注意，为了充分使用这种设置，你需要改变log_directory到集群数据目录之外的 某处存储这些文件。无论如何，使日志文件全局可读是不明智的，因为它们可能包含敏感数据。

这个参数可以在postgresql.conf文件或者服务器命令行上设置。

在打开了logging_collector的时候，这个选项设置一个独立日志文件的最大生存期。 在数值指定的分钟过去之后，将创建一个新的日志文件。设置为零可以关闭以时间为基础的新日志文件的创建。 这个选项只能在postgresql.conf文件里或者服务器命令行设置。

在打开了logging_collector的时候，这个选项设置一个独立的日志文件的最大尺寸。 在数值指定的千字节写入日志文件之后，将会创建一个新的日志文件。 设置为零可以关闭以尺寸为基础的新日志文件的创建。 这个选项只能在postgresql.conf文件里或者服务器命令行上设置。

在打开了logging_collector的时候，这个选项将导致PostgreSQL 覆盖而不是附加到任何同名的现有日志文件上。 不过，覆盖只是发生在基于时间滚动而创建的新文件上，而不是在服务器启动的时候或者以尺寸为基础的滚动上。 如果为 off ，将始终向已存在的文件结尾追加。比如， 使用这个选项和类似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 小时的日志，每小时一个日志，但是如果日志文件尺寸大于 1GB 也旋转日志。 把log_filename设置为server_log.%H%M, log_truncate_on_rotation设置为on, log_rotation_age设置为60并且把 log_rotation_size设置为1000000。 在log_filename里包含%M 允许任何尺寸驱动的旋转选取一个和开始的文件名同小时数但是名字不同的文件。

如果向syslog进行记录，那么这个选项判断要使用的syslog"设施"。 你可以从LOCAL0, LOCAL1, LOCAL2, LOCAL3, LOCAL4, LOCAL5, LOCAL6, LOCAL7中选择。缺省是LOCAL0。 又见你的系统的syslog守护进程文档。 这个选项只能在postgresql.conf文件里或者服务器启动的时候设置。

如果向syslog进行记录，这个选项决定用于在syslog日志中标识PostgreSQL的程序名。 缺省是postgres。这个选项只能在postgresql.conf文件里或者服务器启动的时候设置。

当启用记录event log时，此参数 确定用于识别PostgreSQL消息日志的程序名称。 缺省是PostgreSQL。 该参数只能在postgresql.conf文件或者服务器命令行上设置。

这个选项控制哪些级别的消息发送到客户端。 有效的数值是DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, LOG, NOTICE, WARNING, ERROR, FATAL, 和PANIC。 每个级别包含所有它后面的级别，级别越靠后，发送的消息越少。缺省是NOTICE。 需要注意的是这里的LOG和log_min_messages里的级别不同。

控制写到服务器日志里的消息的详细程度。 有效值是DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL和 PANIC。 每个级别都包含它后面的级别。越靠后的数值发往服务器日志的消息越少。缺省是WARNING。 需要注意的是这里的LOG和client_min_messages里的级别不同。只有超级用户可以修改这个设置。

控制在服务器日志里输出哪一条导致错误条件的SQL语句。 所有导致一个特定级别(或者更高级别)错误的 SQL 语句都要被记录。 有效的值有DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL和PANIC。 缺省是ERROR， 表示所有导致错误、日志信息，致命错误、恐慌的SQL语句都将被记录。 设置为PANIC表示把这个特性关闭。只有超级用户可以改变这个设置。

如果某个语句的持续时间大于或者等于这个毫秒数，那么在日志行上记录该语句及其持续时间。 设置为零将打印所有查询和他们的持续时间。设置为-1(缺省值)关闭这个功能。比如， 如果你把它设置为250ms，那么所有运行时间等于或者超过 250ms 的 SQL 语句都会被记录。 打开这个选项可以很方便地跟踪需要优化的查询。只有超级用户可以改变这个设置。

对于使用扩展查询协议的客户端，语法分析、邦定、执行每一步所花时间都分别记录。

该application_name可以是小于NAMEDATALEN字符 （标准构建64个字符）的任何字符串。它通常是由应用程序连接到服务器设置。 该名称将显示在pg_stat_activity视图中 并包含在CSV格式的日志项中。它也可以被包括在 通过log_line_prefix参数的常规日志项中。 只有可打印的ASCII字符可能用在application_name值中。其它字符会 用问号(?)代替。

这些选项打开各种调试输出。当设置，它们打印生成的解析树，查询重写输出， 或每个执行查询的执行计划。 这些消息在LOG消息级别发出的， 所以默认情况下它们会出现在服务器日志中，但不会被发送到客户端。 您可以通过调整client_min_messages和/或 log_min_messages改变。这些参数缺省都是关闭的。

当设置时，debug_pretty_print缩进debug_print_parse, debug_print_rewritten或者debug_print_plan产生的消息， 这样更加可读，但是，当关闭它时，比"紧凑型"格式更长的输出，缺省是打开的。

导致检查点和重启点被记录在服务器日志中。 一些统计都包含在日志消息中，包括缓冲区写入数量和编写它们的花费的时间。 这些参数只能在postgresql.conf文件或者服务器命令行上设置，缺省是off。

导致记录到服务器的每个尝试连接，以及成功完成客户端认证。 该参数在会话开始之后不能改变，缺省是off。

这个选项类似log_connections，但是在会话结束的时候在服务器日志里输出一行。 并且包含会话持续时间。 缺省是关闭的。这个参数在会话开始之后不能被改变。

记录每个已完成语句的持续时间。默认值是off。只有超级用户可以改变这个设置。

对于使用扩展查询协议的客户端，语法分析、邦定、执行每一步所花时间都分别记录。

控制记录的每条消息写到服务器日志里的详细程度。 有效的值是TERSE,DEFAULT和VERBOSE， 逐个向显示的消息里增加更多的字段。TERSE包含 DETAIL的记录, HINT,QUERY和CONTEXT错误消息。 VERBOSE输出包含SQLSTATE错误代码 (参见附录 A)以及源代码文件名称，函数名称，以及产生错误的行数。 只有超级用户可以改变这个设置。

缺省时，连接日志只记录所连接主机的IP地址。打开这个选项导致同时记录主机名。 请注意，这样有可能带来一些不可忽略的性能损失(取决于你的名字解析的设置)。 这个选项只能在postgresql.conf文件里或者服务器命令行设置。

这是一个printf风格的字符串，在日志的每行开头输出。 %字符开始"转义序列"被如下所述状态信息替换。 无法识别的转义被忽略。其它字符都直接拷贝到日志行中。 有些转义只被会话进程识别，被后端进程看做空，比如主服务器进程。 通过在%之后该选项之前声明有一个数字文字，状态信息可以左对齐或者右对齐。 负值将会使得该状态信息在右侧补齐空白到最小宽度， 正直将在左侧补齐空白。补齐可以有助于帮助人们读取日志文件。 这个选项只能在postgresql.conf文件里或者服务器命令行设置。 缺省是空字符串。

SELECT to_hex(EXTRACT(EPOCH FROM backend_start)::integer) || '.' ||
       to_hex(pid)
FROM pg_stat_activity;

当会话等待比deadlock_timeout获得锁更长的时间时，控制是否产生一个日志消息。 决定如果锁等待造成很差的性能，这是很有用处的。默认是off。

控制记录哪些SQL语句。有效的值是none (off), ddl, mod和 all (所有语句)。ddl记录所有数据定义命令，比如CREATE, ALTER和DROP语句。 mod记录所有ddl语句， 加上数据修改语句INSERT,UPDATE, DELETE, TRUNCATE, 和COPY FROM。如果所包含的命令类型吻合，那么PREPARE, EXECUTE和 EXPLAIN ANALYZE语句也同样被记录。 对于使用扩展查询协议的客户端，记录发生在接受到扩展信息并包含邦定参数(内置单引号要双写)的时候。

缺省是none。只有超级用户可以改变这个设置。

控件的临时文件名称和大小。临时文件可以创建的分类，哈希，和临时的查询结果。 当它被删除时，一个日志项有利于每个临时文件。 零值记录所有临时文件的信息， 同时正值记录文件大小大于或等于千字节指定数量。 默认设置是-1，禁用这样的日志。只有超级用户可以更改此设置。

设置用于写入服务器日志的时间戳的时区。不像TimeZone，这个值是簇范围， 因此，所有会话将持续报告时间戳。默认值GMT，但这通常被 postgresql.conf覆盖；initdb 将安装与其系统环境一致的设置。参见第 8.5.3 节获取更多信息。 这个参数只能在postgresql.conf文件或者服务器命令行上进行。