Pie chart 是什么
Pie chart 面板用扇区表达占比构成，适合分类数量少的场景：按系列取归约值（通常是即时聚合的结果）画出各分类的比例。它回答的是「总量里各部分各占多少」，而不是「随时间怎么变化」。类别超过七八个时扇区会难以分辨，应该改用条形图或把长尾合并成其他；颜色按语义固定（错误类用红色）比按数值动态分配更利于阅读。
基本信息
| 适用平台 | Grafana 8+ 内置面板类型 |
|---|---|
| 数据要求 | 即时查询或归约之后的单值序列 |
| 关键选项 | Legend 显示、扇区排序、颜色、单位 |
| 适用规模 | 分类数控制在七到八个以内 |
| 权限要求 | 看板 Editor |
典型使用场景
- 状态码占比：各状态码在总量中的比例，一眼看出服务端错误占比
- 错误类型构成：按错误类型分组看主要来源，决定修复优先级
- 流量来源分布：按来源或渠道拆分请求量占比
- 容量构成：磁盘或带宽在不同业务之间的占用比例
- 资源归属：实例数或节点数在不同环境之间的分布
使用要点
- 时间序列直接丢进饼图会失去意义，必须先做即时聚合或归约
- 类别过多时把长尾合并成其他，否则图例比图形本身还长
- 颜色按语义固定，跨看板保持一致，避免同一含义颜色不同
- 设置单位与小数位，占比类用百分比表达更直观
- 饼图适合放在总览角落，配合链接下钻到明细表
占比查询
占比查询
# 近 1 小时各状态码占比（即时聚合）
sum by (status) (increase(http_requests_total[1h]))
# 面板侧：Legend 显示 {{status}}，切片按值降序排列
# 超过 7 到 8 类时改用 Bar chart，或把小类合并为 Other
# 单位设为 percent 时注意分母是当前返回值之和图表选择对照
| 需求 | 合适图表 | 不合适的原因 |
|---|---|---|
| 占比构成 | Pie chart | 类别多时难以分辨 |
| 随时间变化 | Time series | 饼图没有时间维度 |
| 多类别比较 | Bar chart | 扇区角度不易精确比较 |
| 单值状态 | Stat 面板 | 饼图适合构成而非单值 |
| 精确对账 | Table | 图形会做取值归约 |
占比的分子与分母要来自同一时间窗口和同一过滤口径，否则图形看起来合理，数值却经不起核对。