Struct Summary 

pub struct Summary { /* private fields */ }

Summary 指标，基于排序数组计算分位数。

与 Prometheus Summary 类似，记录所有观测值并按需计算分位数。 适合样本量可控的场景；超大规模样本应考虑 T-Digest 近似算法。

Implementations

impl Summary

pub fn new( name: impl Into<String>, help: impl Into<String>, quantiles: Vec<f64>, ) -> Self

创建新的 Summary 指标

参数

• name：指标名（如 request_duration_seconds）
• help：帮助文本
• quantiles：要计算的分位数列表（如 [0.5, 0.9, 0.99]）

pub fn observe(&self, value: f64)

观测一个值

pub fn quantile(&self, q: f64) -> Option<f64>

计算指定分位数的值（0.0..=1.0）

使用最近排名法（Nearest Rank）：rank = ceil(p * n)，至少为 1。 返回 None 表示无样本或分位数超出范围。

pub fn quantiles(&self) -> Vec<(f64, Option<f64>)>

计算所有预配置分位数，返回 (分位数, 值) 列表

pub fn count(&self) -> u64

样本计数

pub fn sum(&self) -> f64

样本总和

pub fn name(&self) -> &str

指标名

pub fn render(&self) -> String

渲染为 Prometheus 文本格式

pub fn reset(&self)

重置所有样本