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