首页/云/可观测性速查/单位与数值格式
Grafana 与看板53 条

单位与数值格式

单位设置决定坐标轴刻度与 tooltip 的呈现:字节用 bytes(IEC) 或 decbytes,比例小数用 percentunit,比例整数用 percent,时长用 s/ms。

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

单位与数值格式是什么

单位设置决定坐标轴刻度、图例与 tooltip 的呈现方式:字节用 bytes(IEC) 或 decbytes,比例小数用 percentunit,比例整数用 percent,时长用 s 或 ms。单位配错比数值算错更隐蔽——数字是对的,但读者会得出完全不同的结论。

基本信息

字节(二进制)bytes(IEC) → KiB / MiB / GiB
字节(十进制)decbytes → KB / MB / GB
比例小数percentunit(0.42 → 42%)
比例整数percent(0-100 直接显示)
时间s / ms / dtdurations
速率reqps / ops / Bps

典型使用场景

  • 把字节数显示为 GiB,让容量看板一眼可读
  • 把 0-1 的比例正确显示为百分比
  • 延迟用 ms 展示,避免图上出现一堆小数
  • 吞吐用每秒请求数展示,与业务口径一致
  • 同一面板内多个指标统一单位,避免读者做心算换算
  • 修正历史看板里单位缺失导致的天书数字

常用单位对照

常用单位对照
bytes(IEC)      → KiB / MiB / GiB(二进制换算)
decbytes        → KB / MB / GB(十进制换算)
percentunit     → 0.42 显示为 42%
percent         → 直接按 0-100 显示
s / ms          → 秒 / 毫秒
reqps / ops     → 每秒请求数 / 每秒操作数
bps / Bps       → 比特 / 字节每秒(注意大小写)

常见坑对照

写法含义后果
percentunit0-1 视为比例0.42 显示为 42%
percent0-100 直接显示0.42 显示为 0.42%
bytes(IEC)1024 进制12 GiB 级数字可读
decbytes1000 进制与 IEC 结果略有差异
无单位原样显示12884901888 难以解读
单位配错比数值算错更隐蔽:12884901888 用 bytes 显示为 12 GiB,用无单位则是一串天书数字。
percentunit 与 percent 差 100 倍,混用会让同一面板两组数看起来都「差不多」,实际差了两个数量级。
跨单位对比(延迟 ms 与吞吐 rps)时用双轴面板要明确标注,否则自动缩放会让两条曲线看起来互相印证。
十进制(GB)与二进制(GiB)在不同场景都有使用惯例:磁盘厂商常用十进制,操作系统常用二进制,看板要写明采用哪一种。
小数位设置同样是可读性的一部分:延迟保留 1-2 位小数即可,位数过多会让提示框变得难读且无信息增益。
同一看板里同类指标统一单位,是评审时最容易忽略也最容易修正的问题:改一次设置,整块看板的可读性都会提升。

易错点

  • percentunit 与 percent 差 100 倍,混用会让同一面板两组数看起来都「差不多」
  • 跨单位对比(延迟 ms 与吞吐 rps)时用双轴面板要明确标注,否则缩放会误导
  • 无单位展示大数字让读者心算,是看板可读性最容易被忽视的问题
  • GB 与 GiB 混用会在容量核对时产生百分之几的差异,口径要统一并写明
  • 速率单位与窗口不匹配(按秒算却标成每分钟)会让数值差 60 倍
  • 小数位留得过多会让提示框被数字淹没,关键信息反而看不见

数据来源与参考

  • Grafana 官方文档 · Standard options · Unit
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌