Gauge 与 Bar gauge 是什么
两种进度型可视化：Gauge 用弧形表盘显示单个数值在区间中的位置，Bar gauge 用横向或纵向条并列比较多个对象。两者都依赖阈值着色与 min/max 设定，min/max 若交给数据自动缩放，刻度会随数据变化，容易产生视觉误导。
基本信息
| Gauge 形态 | 弧形表盘，适合单值占比 |
|---|---|
| Bar gauge 形态 | 条状并列，适合多对象比较 |
| 必需设置 | Min / Max 与阈值着色 |
| 归约方式 | Last / Mean / Max 等 |
| 显示模式 | Bar gauge 支持 Gradient / LCD |
| 适用量纲 | 百分比、容量占比、进度 |
典型使用场景
- 展示资源使用率（CPU、内存、磁盘）的百分比水位
- 巡检 N 台机器时用 Bar gauge 并排比较，异常一眼可见
- 展示服务可用性目标达成度
- 展示队列消费进度或批处理完成百分比
- 把容量水位与阈值绑定颜色，接近上限时自动变红
- 用表盘替代数字，在值班大屏上更醒目
表盘查询与配置
表盘查询与配置
# 各实例 CPU 使用率（百分比 0-100）
100 - avg by (instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100
# 磁盘使用率
100 * (1 - node_filesystem_avail_bytes{fstype!~"tmpfs|overlay"}
/ node_filesystem_size_bytes{fstype!~"tmpfs|overlay"})
# Gauge：Min 0 / Max 100，Calc 选 Last
# Bar gauge：Display mode 选 Gradient/LCD，适合 N 台机器并排巡检配置项
| 配置项 | 作用 | 建议 |
|---|---|---|
| Min / Max | 刻度边界 | 固定为量纲边界（如 0-100） |
| Thresholds | 阈值着色 | 与告警阈值保持一致 |
| Calc / Reduce | 取值方式 | 巡检用 Last 或 Mean |
| Display mode | Bar gauge 样式 | 机器多时用 LCD 更省空间 |
| Unit | 单位 | 百分数用 percent |
Gauge 的 min/max 建议固定为量纲边界（如 0-100），避免刻度随数据自动缩放产生视觉误导。
不同量纲的指标放同一面板会让刻度失去意义，按单位分组，百分比与绝对数不要混排。
Calc 选 Max 会把瞬时抖动放大成满格，巡检场景更常用 Last 或 Mean，告警场景才用 Max。
Bar gauge 适合「同一指标、多对象」的横向比较；对象数量很多时建议先 topk 或分组，否则条形过密难以阅读。
Gauge 显示的是归约后的单值，多序列输入会变成一排小表盘；对象多时改用 Bar gauge 或先聚合，版面更清晰。
阈值分档建议与告警阈值对齐（如 70% 警告、90% 严重），让看板变红与收到告警表达同一件事。