# pgBadger 13.2 中文文档

> 快速分析 PostgreSQL 与 PgBouncer 日志，生成完整且可独立浏览的报告

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

![pgBadger 标志](/img/docs/pgbadger/logo.png "pgBadger")

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

## 为什么使用 pgBadger {#why-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 压缩输入；
- 可并行分析一个大文件，或同时处理多个小文件；
- 自动生成每日、每周报告，并按需生成月度累计报告；
- 可按时间、数据库、用户、客户端、应用、进程、会话和查询模式过滤。

## 报告包含什么 {#report-coverage}

PostgreSQL 报告覆盖：

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

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

## 文档阅读顺序 {#documentation-map}

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

1. [下载并安装](/zh/docs/pgbadger/download/) pgBadger 与可选模块。
2. 查阅完整的[命令行参考](/zh/docs/pgbadger/command-line/)。
3. 配置带有可解析前缀的 [PostgreSQL 日志](/zh/docs/pgbadger/postgresql-logging/)。
4. 为日志规模选择合适的[并行处理](/zh/docs/pgbadger/parallel-processing/)模式。
5. 安全构建[增量报告](/zh/docs/pgbadger/incremental-reports/)。
6. 选择[输出格式](/zh/docs/pgbadger/output-formats/)，并查看[本地示例](/zh/docs/pgbadger/sample-reports/)。
7. 跟踪[版本历史](/zh/docs/pgbadger/releases/)，了解[支持渠道](/zh/docs/pgbadger/support/)与[许可证](/zh/docs/pgbadger/license/)。

## 上游链接 {#upstream-links}

- [项目网站](https://pgbadger.darold.net/)
- [源代码](https://github.com/darold/pgbadger)
- [版本发布](https://github.com/darold/pgbadger/releases)
- [问题追踪](https://github.com/darold/pgbadger/issues)

---

本节页面：

- [下载与安装](/zh/docs/pgbadger/download/): 官方发布、系统软件包、运行要求与源码安装方法
- [命令行参考](/zh/docs/pgbadger/command-line/): 完整的 pgBadger 命令语法、选项、远程输入、返回码与示例
- [PostgreSQL 日志配置](/zh/docs/pgbadger/postgresql-logging/): 为 pgBadger 配置查询日志、log_line_prefix、消息语言与运行统计
- [并行处理](/zh/docs/pgbadger/parallel-processing/): 在单个日志分块并行与多个日志并行之间做出选择
- [增量报告](/zh/docs/pgbadger/incremental-reports/): 生成每日与每周报告，控制保留期，重建输出并添加月度汇总
- [输出格式](/zh/docs/pgbadger/output-formats/): 选择 HTML、文本、二进制、JSON 或原始 CSV 输出，并合并中间数据文件
- [报告示例](/zh/docs/pgbadger/sample-reports/): 从本地站点快照打开完整、仅错误与增量 pgBadger 报告
- [版本历史](/zh/docs/pgbadger/releases/): 根据上游 ChangeLog 规范整理的 pgBadger 9.x 至 13.x 完整变更历史
- [支持与贡献](/zh/docs/pgbadger/support/): 报告缺陷、提出功能需求、贡献补丁并寻找 PostgreSQL 专业支持
- [许可证与致谢](/zh/docs/pgbadger/license/): PostgreSQL License 条款、作者信息与内嵌第三方组件

---

反链：

- [归属声明](/zh/attribution/)
- [文档](/zh/docs/)