pig pe
pig pe(别名:pgexp、pgexporter)是运行中
pg_exporter 的 legacy 便利包装。
它读取默认指标与统计端点,也可以请求配置重载,但不是一套通用或版本化的 pg_exporter 客户端。
端点选择
默认端点是 http://127.0.0.1:9630。使用持久选项选择其它 exporter:
| 选项 | 默认值 | 用途 |
|---|---|---|
--host |
127.0.0.1 |
pg_exporter 主机名或 IPv4 地址 |
-p, --port |
9630 |
pg_exporter HTTP 端口 |
命令直接把 host 与 port 拼成普通 HTTP URL,并假定使用标准 /metrics、/stat 与
/reload 路径。它不支持自定义 telemetry path、HTTPS、认证、客户端证书或 base URL;
这些场景应直接使用 curl、Prometheus 工具或安全反向代理。
pe get
读取 /metrics 并输出 PostgreSQL 指标族。命令保留名称以 pg_ 开头的指标样本,
以及对应的 Prometheus HELP 和 TYPE 行。
如果需要包含非 pg_ 进程与运行时指标在内的完整端点,请使用通用 Prometheus 客户端或 curl。
pe list
读取 /metrics,并为每个观察到的 pg_ 指标族输出一条 HELP 声明。
这是当前 exporter 配置的发现结果,不是内置在 PIG 中的静态列表。
pe stat
读取并输出 pg_exporter 的 /stat 响应。
响应的具体格式由已安装的 pg_exporter 版本拥有。
pe reload
请求 /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 新增了一套客户端子系统。