https://pig.center/zh/docs/pgbadger/Recent content in pgBadger 13.2 中文文档 on PIG.CENTERHugozh-CNTue, 08 Sep 2026 21:29:01 +0800https://pig.center/zh/docs/pgbadger/download/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/pgbadger/download/<h2 id="distribution-channels">选择分发渠道 </h2> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">渠道</th> <th scope="col">适用场景</th> <th scope="col">地址</th> </tr> </thead> <tbody> <tr> <td>官方发布</td> <td>源码归档与版本说明</td> <td><a href="https://github.com/darold/pgbadger/releases">GitHub Releases</a> </td> </tr> <tr> <td>RPM 软件包</td> <td>基于 RPM 的 Linux 发行版</td> <td><a href="https://yum.postgresql.org/packages/">PostgreSQL Yum 仓库</a> </td> </tr> <tr> <td>Debian/Ubuntu 软件包</td> <td>基于 APT 的 Linux 发行版</td> <td><a href="https://wiki.postgresql.org/wiki/Apt">PostgreSQL Apt 仓库</a> </td> </tr> <tr> <td>开发源码</td> <td>尚未正式发布的最新代码</td> <td><a href="https://github.com/darold/pgbadger">darold/pgbadger</a> </td> </tr> </tbody> </table> </div> <p>本站文档快照基于 13.2 源码树。下载前始终应查看发布页面：本地快照为了可复现而固定，上游版本仍会继续更新。</p>https://pig.center/zh/docs/pgbadger/command-line/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/pgbadger/command-line/<p>本页保留固定上游源码生成的完整命令参考。为了能与 <code>pgbadger --help</code> 逐项核对，参数名、帮助文字和命令示例均保留英文原文。</p> <h2 id="usage-and-options">用法与选项 </h2> <p>Usage: pgbadger [options] logfile [&hellip;]</p>https://pig.center/zh/docs/pgbadger/postgresql-logging/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/pgbadger/postgresql-logging/<p>pgBadger 只能报告 PostgreSQL 实际写入日志的信息。应先确定可解析的日志前缀与清晰的语句记录策略，再按需要加入检查点、锁、临时文件和自动清理等运行事件。</p> <h2 id="minimum-query-logging">最小查询日志配置 </h2> <p>若报告需要查询文本与执行耗时，请启用按时长记录语句：</p>https://pig.center/zh/docs/pgbadger/parallel-processing/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/pgbadger/parallel-processing/<p>pgBadger 提供两种互补的多进程模式。选择时应关注输入日志的形态，而不只是 CPU 数量。</p> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">选项</th> <th scope="col">并行单位</th> <th scope="col">最适合</th> <th scope="col">主要限制</th> </tr> </thead> <tbody> <tr> <td><code>-j N</code> / <code>--jobs N</code></td> <td>一个日志文件的多个分块</td> <td>单个可定位的大日志</td> <td>分块边界可能重复或漏掉少量查询</td> </tr> <tr> <td><code>-J N</code> / <code>--Jobs N</code></td> <td>完整日志文件</td> <td>大量相互独立的日志</td> <td>只有文件数量足以填满工作进程时才有明显收益</td> </tr> </tbody> </table> </div> <h2 id="single-file-jobs">使用 <code>-j</code> 拆分单个大文件 </h2> <div class="td-code td-code--untitled" id="td-code-d7dd9c7b-fence-0" data-td-code data-td-code-auto-id data-td-language="console" data-td-line-count="1"> <div class="td-code__viewport" id="td-code-d7dd9c7b-fence-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-console" data-lang="console"><span class="line"><span class="cl"><span class="gp">$</span> pgbadger -j <span class="m">8</span> /var/log/postgresql/postgresql.log </span></span></code></pre></div></div> </div> <p>上游算法把每个文件分成 <code>N</code> 个字节区间，为每个区间 fork 一个解析进程，把统计结果写入临时二进制文件，最后合并生成报告。</p>https://pig.center/zh/docs/pgbadger/incremental-reports/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/pgbadger/incremental-reports/<p>增量模式先以二进制形式保存解析统计，再生成每日 HTML 报告、每周累计报告，以及把它们组织起来的日历式索引。它适合反复处理轮转日志，同时避免重复统计相同记录。</p>https://pig.center/zh/docs/pgbadger/output-formats/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/pgbadger/output-formats/<p>pgBadger 会根据输出文件扩展名，或 <code>-x</code> / <code>--extension</code> 选项选择格式。同一次解析可多次使用 <code>-o</code> / <code>--outfile</code>，同时生成多种格式。</p> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">格式</th> <th scope="col">常用扩展名</th> <th scope="col">最适合</th> </tr> </thead> <tbody> <tr> <td>HTML</td> <td><code>.html</code></td> <td>带图表的交互式人类可读报告</td> </tr> <tr> <td>文本</td> <td><code>.txt</code></td> <td>终端查看与纯文本归档</td> </tr> <tr> <td>二进制</td> <td><code>.bin</code></td> <td>可合并的中间统计数据与报告重建</td> </tr> <tr> <td>JSON</td> <td><code>.json</code></td> <td>与其他软件集成；需要 <code>JSON::XS</code></td> </tr> <tr> <td>原始 CSV</td> <td>自选输出文件</td> <td>使用 <code>--dump-raw-csv</code> 导出逐行数据</td> </tr> </tbody> </table> </div> <h2 id="html-and-text">HTML 与文本 </h2> <p>默认输出为 <code>out.html</code>：</p>https://pig.center/zh/docs/pgbadger/sample-reports/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/pgbadger/sample-reports/<p>示例内容由 pgBadger 11.8 于 2022 年 5 月生成。原始示例已与本站一起保存，因此即使无法访问上游服务器，也能继续使用报告导航、图表、样式与脚本。</p> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">示例</th> <th scope="col">展示内容</th> <th scope="col">本地副本</th> </tr> </thead> <tbody> <tr> <td>完整报告</td> <td>PostgreSQL 活动与 PgBouncer 统计</td> <td><a href="https://pig.center/third_party/pgbadger/examples/sample.html">打开完整报告</a> </td> </tr> <tr> <td>增量报告</td> <td>日历索引、每周累计与每日页面</td> <td><a href="https://pig.center/third_party/pgbadger/examples/report/index.html">打开增量索引</a> </td> </tr> <tr> <td>错误与事件</td> <td>仅包含错误和运行事件的报告</td> <td><a href="https://pig.center/third_party/pgbadger/examples/errors.html">打开错误报告</a> </td> </tr> </tbody> </table> </div> <h2 id="complete-report">完整报告 </h2> <p>完整报告是一份自包含 HTML 文档。可通过顶部导航查看全局统计、查询、会话、连接、临时文件、检查点、自动清理、锁，以及 PgBouncer 专用图表。</p>https://pig.center/zh/docs/pgbadger/support/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/pgbadger/support/<p>pgBadger 是一个开放维护的项目。缺陷报告、功能建议、文档修复与代码补丁都通过上游 GitHub 仓库处理。</p> <h2 id="bugs-and-features">缺陷与功能需求 </h2> <ol> <li>升级到最新正式版本，确认问题仍然存在。</li> <li>搜索<a href="https://github.com/darold/pgbadger/issues">开放问题</a> 与<a href="https://github.com/darold/pgbadger/issues?q=is%3Aissue&#43;is%3Aclosed">已关闭问题</a> ，查看是否已有答案。</li> <li>把问题缩减为仍能复现的最小安全日志样本与命令行。</li> <li>删除凭据、敏感 SQL、绑定值、主机名、地址与业务数据。</li> <li>创建<a href="https://github.com/darold/pgbadger/issues/new">新问题</a> ，写明 pgBadger 版本、操作系统、输入格式、完整选项、实际结果与预期结果。</li> </ol> <p>对于崩溃或解析错误，只应附上复现边界所需的最少脱敏日志。完整生产日志或生成报告通常不适合放在公开问题中。</p>https://pig.center/zh/docs/pgbadger/license/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/pgbadger/license/<p>pgBadger 是以 PostgreSQL License 发布的自由开源软件。只要保留版权与许可证声明，就可以免费使用、复制、修改与分发。</p> <h2 id="postgresql-license">PostgreSQL License 原文 </h2> <p>Copyright (c) 2012-2026, Gilles Darold</p>