https://exp.pgsty.com/zh/categories/%E5%8F%82%E8%80%83/ Recent content in 参考 on PG Exporter Hugo zh-CN https://exp.pgsty.com/zh/start/ Mon, 01 Jan 0001 00:00:00 +0000 https://exp.pgsty.com/zh/start/ <p>本页是一条最短路径：安装 <code>pg_exporter</code>，连上一个 PostgreSQL 实例，确认指标产出，接入 Prometheus。</p> <p>你需要准备的东西只有两样：一个可访问的 PostgreSQL 10-19+（或 pgBouncer 1.8+）实例，以及在其中创建用户的权限。更老的 PostgreSQL 9.1-9.6 实例请参阅 <a href="https://exp.pgsty.com/zh/compatibility/">兼容性说明</a>。</p> https://exp.pgsty.com/zh/install/ Mon, 01 Jan 0001 00:00:00 +0000 https://exp.pgsty.com/zh/install/ <p><code>pg_exporter</code> 可以通过 Pigsty、YUM/APT 仓库、GitHub 发布包（RPM/DEB/Tarball）、Docker 镜像或源码构建安装，按你的基础设施任选一种即可。</p> https://exp.pgsty.com/zh/compatibility/ Mon, 01 Jan 0001 00:00:00 +0000 https://exp.pgsty.com/zh/compatibility/ <p>兼容性分为三个独立层面：exporter 二进制必须能在宿主机运行，动态规划必须能为目标服务器选出匹配的采集器分支，可选 SQL 对象或扩展还必须真实存在。因此，“进程能够启动”不等于所有采集器都满足准入条件。</p> https://exp.pgsty.com/zh/deploy/ Mon, 01 Jan 0001 00:00:00 +0000 https://exp.pgsty.com/zh/deploy/ <p>本页覆盖把 <code>pg_exporter</code> 放进生产环境要做的事：进程参数与环境变量、监控用户与凭据管理、systemd / Docker / Kubernetes 三种部署形态、pgBouncer 与自动发现，以及 Prometheus 侧的抓取与告警配置。</p> https://exp.pgsty.com/zh/config/ Mon, 01 Jan 0001 00:00:00 +0000 https://exp.pgsty.com/zh/config/ <p><code>pg_exporter</code> 的所有业务指标都由 YAML <strong>采集器</strong>（Collector）定义驱动：每个采集器就是一条 SQL 查询，外加它的执行条件（版本、角色、标签、谓词）与运行控制（缓存、超时）。本页是采集器定义的完整参考。</p> https://exp.pgsty.com/zh/collectors/ Mon, 01 Jan 0001 00:00:00 +0000 https://exp.pgsty.com/zh/collectors/ <p>PG Exporter v1.4.1 在 <a href="https://github.com/pgsty/pg_exporter/tree/main/config"><code>config/</code></a> 中提供 <strong>58 个采集器定义文件</strong>，<code>make conf</code> 按文件名顺序将它们合并为默认的 <a href="https://github.com/pgsty/pg_exporter/blob/main/pg_exporter.yml"><code>pg_exporter.yml</code></a>。</p> <p>文件名前缀只负责排序，并不是指标名。一个文件可以为同一指标命名空间定义多个版本或角色分支。PG Exporter 启动时根据目标实例事实只安装符合条件的分支；对真实目标访问 <a href="https://exp.pgsty.com/zh/api/#get-explain"><code>GET /explain</code></a>，即可查看最终执行计划。</p> https://exp.pgsty.com/zh/api/ Mon, 01 Jan 0001 00:00:00 +0000 https://exp.pgsty.com/zh/api/ <p><code>pg_exporter</code> 在监听端口（默认 <code>:9630</code>）上暴露四类 HTTP 端点：指标、健康检查、流量路由与运维管理。全部端点如下：</p> <table class="full-width"> <thead> <tr> <th>端点</th> <th>方法</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td><a href="https://exp.pgsty.com/zh/api/#get-metrics"><code>/metrics</code></a></td> <td>GET</td> <td>Prometheus 指标端点（路径可经 <code>--web.telemetry-path</code> 修改）</td> </tr> <tr> <td><a href="https://exp.pgsty.com/zh/api/#%e5%81%a5%e5%ba%b7%e6%a3%80%e6%9f%a5"><code>/up</code></a></td> <td>GET</td> <td>存活检查；别名 <code>/health</code>、<code>/liveness</code>、<code>/readiness</code>、<code>/read</code></td> </tr> <tr> <td><a href="https://exp.pgsty.com/zh/api/#%e6%b5%81%e9%87%8f%e8%b7%af%e7%94%b1"><code>/primary</code></a></td> <td>GET</td> <td>主库检查；别名 <code>/leader</code>、<code>/master</code>、<code>/read-write</code>、<code>/rw</code></td> </tr> <tr> <td><a href="https://exp.pgsty.com/zh/api/#%e6%b5%81%e9%87%8f%e8%b7%af%e7%94%b1"><code>/replica</code></a></td> <td>GET</td> <td>从库检查；别名 <code>/standby</code>、<code>/slave</code>、<code>/read-only</code>、<code>/ro</code></td> </tr> <tr> <td><a href="https://exp.pgsty.com/zh/api/#%e8%bf%90%e7%bb%b4%e7%ab%af%e7%82%b9"><code>/reload</code></a></td> <td>GET/POST</td> <td>热重载采集器配置</td> </tr> <tr> <td><a href="https://exp.pgsty.com/zh/api/#%e8%bf%90%e7%bb%b4%e7%ab%af%e7%82%b9"><code>/explain</code></a></td> <td>GET</td> <td>展示各采集器的规划裁决结果</td> </tr> <tr> <td><a href="https://exp.pgsty.com/zh/api/#%e8%bf%90%e7%bb%b4%e7%ab%af%e7%82%b9"><code>/stat</code></a></td> <td>GET</td> <td>各采集器的运行统计（命中/错误/耗时）</td> </tr> <tr> <td><code>/version</code></td> <td>GET</td> <td>版本与构建信息（文本）</td> </tr> <tr> <td><code>/</code></td> <td>GET</td> <td>落地页，链接到指标端点</td> </tr> </tbody> </table> <p>健康与路由端点的判定基于后台探测缓存的角色状态（<code>primary</code> / <code>replica</code> / <code>down</code> / <code>starting</code> / <code>unknown</code>），不会在每次 HTTP 请求时同步查询数据库——探针风暴不会穿透到数据库。</p>