跳转到主要内容

pig pe

使用 legacy pig pe 快捷命令访问默认 pg_exporter HTTP 端点

pig pe(别名:pgexppgexporter)是运行中 pg_exporter 的 legacy 便利包装。 它读取默认指标与统计端点,也可以请求配置重载,但不是一套通用或版本化的 pg_exporter 客户端。

pig pe get                     # 输出 pg_ 指标
pig pe list                    # 从 HELP 行列出指标族
pig pe stat                    # 输出 exporter 统计信息
pig pe reload                  # 请求配置重载

端点选择

默认端点是 http://127.0.0.1:9630。使用持久选项选择其它 exporter:

选项 默认值 用途
--host 127.0.0.1 pg_exporter 主机名或 IPv4 地址
-p, --port 9630 pg_exporter HTTP 端口
pig pe --host pg-meta -p 9630 stat
pig pe --host 10.10.10.10 get

命令直接把 host 与 port 拼成普通 HTTP URL,并假定使用标准 /metrics/stat/reload 路径。它不支持自定义 telemetry path、HTTPS、认证、客户端证书或 base URL; 这些场景应直接使用 curl、Prometheus 工具或安全反向代理。

pe get

读取 /metrics 并输出 PostgreSQL 指标族。命令保留名称以 pg_ 开头的指标样本, 以及对应的 Prometheus HELPTYPE 行。

pig pe get
pig pe --host pg-meta get

如果需要包含非 pg_ 进程与运行时指标在内的完整端点,请使用通用 Prometheus 客户端或 curl

pe list

读取 /metrics,并为每个观察到的 pg_ 指标族输出一条 HELP 声明。

pig pe list
pig pe --host pg-meta list

这是当前 exporter 配置的发现结果,不是内置在 PIG 中的静态列表。

pe stat

读取并输出 pg_exporter 的 /stat 响应。

pig pe stat

响应的具体格式由已安装的 pg_exporter 版本拥有。

pe reload

请求 /reload 并输出响应。

pig pe reload

Reload 会改变运行中 exporter 的配置状态。执行前应确认 exporter 配置已经校验,且选中的端点就是目标实例。

Legacy 限制与输出

PIG 使用带连接阶段超时的共享 HTTP transport,但这个 legacy 包装不会解释 HTTP 状态码, 也不限制响应正文大小。网络或正文读取失败会返回非零;除此之外,非 2xx 正文仍按普通响应处理。 需要严格 HTTP 语义时应直接访问 exporter 端点。

该命令族使用 PIG 的旧命令结构化适配器支持 -o json|yaml。 结果会捕获操作与端点产生的文本;Prometheus exposition format 本身仍是 pg_exporter 拥有的文本格式。

该命令族不读取 ~/.pig/config.yml;即使该文件格式错误仍可使用,端点选择只来自命令参数与默认值。

操作边界

pig pe 不会启动 pg_exporter、编辑其配置文件、持续抓取指标或充当 Prometheus 服务器。 PIG 通过软件包目录安装 pg-exporter,而 daemon 配置与 HTTP 协议由 pg_exporter 自己拥有。 该命令只是默认本地部署的兼容性快捷入口,不代表 PIG 新增了一套客户端子系统。