首页/云/可观测性速查/指标命名与单位规范
本包目录(282 条)
监控体系与方法40 条
Prometheus 与采集64 条Grafana 与看板53 条日志平台52 条链路追踪23 条告警与响应50 条

指标命名与单位规范

Prometheus 社区约定:小写 snake_case、带单位后缀、Counter 以 _total 结尾、使用基本单位(秒、字节);统一命名才能让查询与看板可复用。

可观测性速查云更新于 2026-10-12

命名规则

规则正例反例
小写 snake_casehttp_request_duration_secondshttpRequestDuration
基本单位request_size_bytes、latency_secondsrequest_size_kb、latency_ms
Counter 后缀 _totalrequests_totalrequests_count
含义具体可组合node_network_receive_bytes_totaldata1、value

常用单位后缀约定

常用单位后缀约定
_seconds / _milliseconds     时间
_bytes                       大小
_total                       计数器累计值
_info                        静态元信息(值恒为 1)
_timestamp_seconds           时间点
指标名加子系统前缀(如 nginx_、mysqld_)便于按来源筛选,也降低重名概率。

易错点

  • 把毫秒、KB 写进指标名会带来换算负担,统一用秒与字节、由展示端做单位转换
  • 同一指标在不同版本更换单位(ms 与 s)会让看板数值差 1000 倍且难以察觉

数据来源与参考

  • Prometheus 文档 · Metric and label naming
  • Prometheus 文档 · Instrumentation 实践
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌