背景

PG 的日志模块是一个相对独立的模块，主要功能就是打印用户的操作日志以及一些异常报错信息。本文仅讲述 logging_collector 参数开启的情况。

日志模块原理

PG 有各种各样的进程，其中 syslogger 进程专门用于打印日志信息。
而其余进程打印日志的方法如出一辙：将需要打印的信息发送给 syslogger 进程，由其统一负责打印。
在这里插入图片描述

syslogger 的大体逻辑如下图所示：
在这里插入图片描述

postmaster 进程在 SysLogger_Start 函数完成部分初始化；
由 postmaster 进程 fork 出 syslogger 进程；
进入 syslogger 的主逻辑函数 SysLoggerMain 中，大循环监听其他进程发送来的日志消息，处理打印逻辑。在大循环中同时也根据时间和大小，来判断是否进行日志轮转。

PG 的其余进程如果有需要打印的日志，通常会调用 elog 或者 ereport 来打印。而这两个函数会将日志消息分成若干个 chunk 发送给 syslogger 进程，每个 chunk 的结构可参考下图（源码中的 PipeProtoChunk 结构）
在这里插入图片描述

开头两个 \0 ，表示是日志开头
length：用于记录当前 chunk 的长度
pid：发送该 chunk 的进程号
is_last：是否是本条日志消息的最后一个 chunk；
data：具体的日志消息。
chunk 大小：PIPE_CHUNK_SIZE ，源码 define 出的一个值，由 OS 的 PIPE_BUF 决定。具体细节可参考这部分定义的代码。
注： PG 15 在 pipe 协议格式中做了一些变化，由 flags 代替 is_last 标记。

syslogger 在接收到日志消息后，将其按照 pid 进行分组，相同的 pid 说明日志消息来源于同一进程，将其组装起来，当收到包含 is_last 标记的最后一个 chunk 后，将整条日志消息打印到日志文件。

所谓日志轮转，指的就是不想继续写当前日志文件了，需要新找一个日志文件继续写日志。

PG 的日志轮转是一个坑非常多的地方，因为它由下面四个参数同时控制：

log_filename ：日志文件格式，我们以其设定为 postgres_%d_%h 为例，某个月 14 号 15 点的日志文件名就是 postgres_14_15.log
log_rotation_age：如果距离当前日志文件已经超过设定的时间，那么就新开一个日志文件；
log_rotation_size：如果距离当前日志文件还没有超过 log_rotation_age 设定的时间，但是已经超过了 log_rotation_size 设定的大小，那么就新开一个日志文件；
log_truncate_on_rotation：是否在按时间轮转后做截断。即如果下一个日志文件的同名文件已经存在了，是否直接清空该文件并从头开始写；

这几个参数的具体使用可参考 PG 官方文档。看完上面的介绍，想必大家已经精通日志参数设置了，那么接下来做几道题检验自己的学习成果。

假如，我们按照以下值设定日志相关参数

log_filename='postgres_%d_%h.log'
log_rotation_age = 2h
log_rotation_size = 10MB
log_truncate_on_rotation = on

Q：此时时间刚到 14 号下午 17 点，日志文件为 postgres_14_16.log，且大小为 5MB，请问接下来要写的日志文件是什么？
A：postgres_14_16.log 。因为此时距离 15 点仅过了 1h，没有超过 log_rotation_age；大小并没有超过 log_rotation_size ，所以并不发生轮转。

Q：此时时间为 14 号下午 16 点 30 分，日志文件为 postgres_14_16.log，且大小刚刚超过 10MB 到达 10.9MB，请问接下来要写的日志文件是什么？
A：postgres_14_16.log 。因为 log_filename 参数的最小精度值就到小时，哪怕当前日志文件大小变成 1TB 也只会继续追加写这个文件。