pgBadger 13.2 中文文档

pgBadger 是一款使用 Perl 编写的高性能独立 PostgreSQL 日志分析器。它可以读取 PostgreSQL 或 PgBouncer 日志，并生成 HTML、文本、二进制、JSON 或原始 CSV 输出。HTML 报告自带全部资源，图表可交互、缩放并保存为 PNG，只需浏览器即可查看。

为什么使用 pgBadger

pgBadger 面向大规模日志与日常运维场景设计：

• 单个 Perl 程序，不强制依赖非核心 Perl 模块；
• 自动识别 stderr、syslog、csvlog、jsonlog、RDS、Cloud SQL、logplex、Redshift 与 PgBouncer 日志；
• 可读取本地文件、标准输入、SSH 远程文件，以及 HTTP、FTP 或 SFTP URL；
• 支持 gzip、bzip2、lz4、xz、zip 与 zstd 压缩输入；
• 可并行分析一个大文件，或同时处理多个小文件；
• 自动生成每日、每周报告，并按需生成月度累计报告；
• 可按时间、数据库、用户、客户端、应用、进程、会话和查询模式过滤。

报告包含什么

PostgreSQL 报告覆盖：

• 整体活动与查询统计；
• 最慢、最频繁、总耗时最高、等待与被取消的查询；
• 临时文件、检查点、锁、会话与连接；
• 按表统计的 autovacuum 与 autoanalyze 活动；
• 按严重级别和类别汇总的错误与事件；
• 按数据库、用户、客户端、应用与语句类型展示的分布。

分析 PgBouncer 日志时，还会生成吞吐量、平均查询耗时、并发会话、连接与会话分布、保留连接池使用情况，以及高频错误/事件报告。

文档阅读顺序

可以按以下顺序阅读，也可以从侧边栏直接进入所需主题：

1. 下载并安装 pgBadger 与可选模块。
2. 查阅完整的命令行参考 。
3. 配置带有可解析前缀的 PostgreSQL 日志 。
4. 为日志规模选择合适的并行处理 模式。
5. 安全构建增量报告 。
6. 选择输出格式 ，并查看本地示例 。
7. 跟踪版本历史 ，了解支持渠道 与许可证 。

上游链接

• 项目网站
• 源代码
• 版本发布
• 问题追踪