pgBadger 12.x 版本记录

v12.4 · 2023-12-25

这是维护版本，修复了上一版本发布后用户报告的问题。

• 修复 PgBouncer 1.21 的报告。感谢 Ales Zeleny 提供补丁。
• 防止按文件并行处理的进程数超过文件数。感谢 maliangzhu 报告。
• 修复自 v12.3 起损坏的回归测试。感谢 ieshin 报告。
• 修复 LOG 记录被计入 ERROR 级别记录的情况。感谢 Matti Linnanvuori 报告。

v12.3 · 2023-11-27

这是维护版本，修复了上一版本发布后用户报告的问题，并增加了以下功能：

• 添加 --include-pid 选项，只报告指定会话 PID（%p）的事件，可多次指定。感谢 Henrietta Dombrovskaya 提出需求。
• 添加 --include-session 选项，只报告指定会话 ID（%c）的事件，可多次指定。感谢 Henrietta Dombrovskaya 提出需求。
• 添加 --dump-raw-csv 选项，只解析日志并将信息导出为 CSV，不再进一步处理，也不生成报告。感谢 Henrietta Dombrovskaya 提出需求。

完整变更与致谢如下：

• 将 pgFormatter 更新到 5.5。
• 修复 jsonlog 格式的解析结束日期。感谢 jw1u1 报告。
• 修正“按应用统计会话”标签中的拼写错误。感谢 fairyfar 提供补丁。
• 修复 INSERT/UPDATE/DELETE 流量图表的缺陷。感谢 fairyfar 提供补丁。
• 修复 bind 查询中孤立日志行的解析。感谢 youxq 报告。
• 修复新版 PostgreSQL 的按表统计 analyze 报告。感谢 Jean-Christophe Arnu 提供补丁。
• 修复 syslog 时间戳包含毫秒时的记录解析。感谢 Pavel Rabel 报告。

v12.2 · 2023-08-20

这是维护版本，修复了上一版本发布后用户报告的问题，并增加了两个功能：

• 支持 autovacuum 耗时的最大值、平均值和最小值。感谢 Francisco Reinolds 提供补丁。
• 支持 PgBouncer 的平均等待时间。感谢 Francisco Reinolds 提供补丁。

完整变更与致谢如下：

• 修复应用名称包含 <...> 时损坏的 HTML 输出。感谢 Fabio Geiss 报告。
• 修复按数据库过滤时孤立日志行关联错误的问题。感谢 jcasanov 报告。
• 修复 logplex 前缀的解析。
• 修复 logplex 孤立日志行的检测。
• 修复 autovacuum 的 system usage: CPU: ... 行解析。感谢 Francisco Reinolds 提供补丁。
• 输出到标准输出时，不再添加输出目录前缀。
• 统一“平均查询耗时”标签。感谢 Francisco Reinolds 提供补丁。
• 更新新增 pgBadger 选项的文档。感谢 Francisco Reinolds 提供补丁。
• 修复无法打开任何文件句柄时未中止解析的情况。感谢 vp 报告。
• 在帮助中补入 %p / %t 必需占位符的日志要求。感谢 Christophe Courtois 提供补丁。
• 修复 --retention 参数。感谢 Bertrand Bourgier 提供补丁。
• 修复设置 HTML 输出目录时，提交 0e5c7d5 移除的输出目录清理功能。感谢 Bertrand Bourgier 报告。
• 修复目标目录包含需要在正则表达式中转义的字符时的输出扩展名。感谢 Bertrand Bourgier 提供补丁。
• 在 Windows 移植版中，用 localtime 调用替换 POSIX::strftime("%s", ....)。感谢 Bertrand Bourgier 提供补丁。
• 修复 HTML 输出目录的清理。感谢 Bertrand Bourgier 提供补丁。
• 默认使用 HTTPS 执行计划 URL。感谢 Philipp Trulson 提供补丁。

v12.1 · 2023-03-20

这是维护版本，修复了过去六个月用户报告的问题。

完整变更与致谢如下：

• 修复多行参数的解析。感谢 Bekir Niyaz 报告。
• 修复包含 ::tsrange 的查询无法归一化的问题。感谢 Philippe Griboval 报告。
• 在事件报告中加入逻辑解码一致性点与复制槽启动的日志记录。
• 处理时间戳中其他纳秒加时区的格式。感谢 Ronan Dunklau 报告。
• 修复使用 T 分隔日期和时间时的 %m 检测。感谢 Ronan Dunklau 报告。
• 添加对 CloudNativePG 生成日志的解析。感谢 codrut panea 提供补丁。
• 修复生成报告时 --outdir 选项未生效的问题。感谢 Frederic Guiet 报告。
• 根据最近的文档改动更新 README。感谢 Manisankar 报告。
• 修正 pgBadger 示例中的拼写错误。感谢 Shinichi Hashiba 提供补丁。

v12.0 · 2022-09-13

这个主要版本修复了过去五个月用户报告的一些问题，并增加了新功能和改进：

• 移除 Tsung 输出支持。
• 改善需要替换数百个绑定参数时的性能。
• 移除 -n | --nohighlight 选项；升级到 pgFormatter 4 后已不再使用该选项。
• 使用 POST 方法向 explain.depesz.com 提交 auto_explain 执行计划，避免 GET 参数长度限制。
• 将 --exclude-query 和 --include-query 应用于 bind/parse 记录。
• 在文档中添加 pgBadger 报告示例的链接。

完整变更与致谢如下：

• 修复月报因 log file ... must exists 报错而生成失败的问题。感谢 Jaume Sabater 报告。
• 修复从标准输入读取 PgBouncer 日志时的解析启动调试消息。感谢 aleszeleny 报告。
• 移除 Tsung 输出支持。
• 大幅改善绑定参数替换的性能；数百个参数曾可能导致程序无限运行。感谢 Monty Mobile 报告。
• 修正返回码文档，并修复部分位置的错误返回码。感谢 Jaume Sabater 报告。
• 修正多处拼写错误。感谢 David Gilman 提供补丁。
• 移除升级到 pgFormatter 4 后不再使用的 -n | --nohighlight 选项。感谢 Elena Indrupskaya 报告。
• 修复多处文档问题。感谢 Postgres Pro 的 Elena Indrupskay 提供补丁。
• 允许 --log-timezone 和 --timezone 使用半小时时差，值可以是整数（例如 2）或小数（例如 2.5）。感谢 Mujjamil-K 提出需求。
• 允许 --exclude-app 和 --exclude-client 使用正则表达式。感谢 rdnkrkmz 提出需求。
• 配合上一项相关提交允许使用 --explain-url，并恢复只支持文本格式执行计划的限制。
• 使用 POST 方法向 explain.depesz.com 提交 auto_explain 执行计划，避免 GET 参数长度限制。感谢 hvisage 报告。
• 将 --exclude-query 和 --include-query 应用于 bind/parse 记录。感谢 Alec Lazarescu 报告。
• 修复 RDS 日志中 autovacuum 统计信息的解析。感谢 David Gilman 报告。
• 修复解析远程日志时日志格式的传递。感谢 spookypeanut 报告。
• 在文档中添加 pgBadger 报告示例的链接。
• 修复按用户统计会话的报告。感谢 vitalca 报告。
• 修复 PostgreSQL 15 输出的 jsonlog 解析。
• 修复文本格式的错误/事件报告。感谢 Michael Banck 提供补丁。
• 修正 normalize_error() 中正则表达式的拼写错误。感谢 Michael Banck 提供补丁。