Struct PushgatewayExporter 

pub struct PushgatewayExporter { /* private fields */ }

Pushgateway 导出器。

将指标推送到 Prometheus Pushgateway。

两种模式

• 内存模式（默认）：push 仅记录到内存 Vec，不发起网络请求。用于单元测试。
• 真实 HTTP PUT 模式：启用 push-gateway feature 后，push 会向 config.endpoint 发起 HTTP PUT 请求，推送指标文本到 Pushgateway。

Feature 切换

[dependencies]
sz-orm-observability = { version = "1.2", features = ["push-gateway"] }

Implementations

impl PushgatewayExporter

pub fn new(config: PushgatewayConfig) -> Self

创建新的 Pushgateway 导出器

pub fn push(&self, metrics_text: impl Into<String>) -> Result<(), String>

推送指标到 Pushgateway

行为

• 内存模式（默认）：将指标文本记录到内存 Vec，不发起网络请求。
• HTTP PUT 模式（push-gateway feature）：向 config.endpoint 发起 HTTP PUT 请求，URL 格式为 {endpoint}/metrics/job/{job}[/instance/{instance}]。 请求体为 Prometheus exposition format 文本。

错误

HTTP 模式下，网络错误或非 2xx 响应码会返回 Err。 内存模式永远返回 Ok。

pub fn push_from_registry( &self, registry: &MetricsRegistry, ) -> Result<(), String>

从 MetricsRegistry 渲染并推送

pub fn snapshots(&self) -> Vec<PushSnapshot>

获取推送历史快照

pub fn push_count(&self) -> usize

获取推送次数

pub fn clear(&self)

清空推送历史

pub fn config(&self) -> &PushgatewayConfig

获取配置引用