普贤教程 › 包参考

metrics 包

Prometheus 指标（文本格式）

项	值
包名	`metrics`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`metrics.px`
分类	`可观测与测试`
文件数 / 行数	`1 / 167`

安装与引入

bash

pxpkg init          # 首次
pxpkg add metrics@0.2.0
pxpkg install

import metrics

所属分类教程：可观测与测试

公开接口

函数	参数
`m_registry`
`m_counter`	`reg, name, help`
`m_gauge`	`reg, name, help`
`m_inc`	`reg, name, value=1, labels=null`
`m_set`	`reg, name, value, labels=null`
`m_render`	`reg`

其余 11 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`m_label_key`	`labels`
`m_label_escape`	`v`
`m_num`	`v`
`m_float`	`v`
`m_histogram`	`reg, name, help, buckets=[0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0]`
`m_observe`	`reg, name, value`
`m_summary`	`reg, name, help`
`m_observe_summary`	`reg, name, value`
`m_timer_start`
`m_timer_stop`	`timer`
`m_format_prometheus`	`reg`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/metrics —— Prometheus 指标（文本格式）
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
var reg = m_registry()
m_counter(reg, "http_requests_total", "HTTP requests")
m_inc(reg, "http_requests_total", 1, {"path": "/api"})
m_gauge(reg, "temp_c", "temperature")
m_set(reg, "temp_c", 36.5)
print(m_render(reg))
输出：Prometheus 文本格式（# HELP / # TYPE / 样本行）。
说明：
- 指标注册表由调用方持有（写库规范：无全局状态）
- labels 为 dict{str:str}；渲染时键排序（确定性）
============================================================