通用 Grafana Dashboard 设计说明

这份说明用于指导 AI 设计 Grafana Dashboard。优先展示用户要看的图，不增加用户没要求的指标、筛选器和说明模块。

1. 📐 固定排版

从上往下按重要性排列：

实时信息 → 平均信息 → 累计信息 → 采集截止 → 说明文档。

不适用的部分省略；后两项只有确实影响使用时才保留。

⚡ 实时信息
当前状态、剩余量、使用率
紧凑图表或进度条，数值随图标注

📈 平均信息
所选时间内的变化趋势
图例注明均值，按需补充峰值

📊 累计统计
所选范围的总量
排名、占比或分类比较

🕒 采集截止（可省略）
一行必要的时间信息，不默认单独建面板

📖 使用说明（可省略）
简短链接或折叠说明，不占首屏

实时信息优先，不等于大数字优先。禁止用大数字卡替代图表。 当前值、均值和峰值放在图内、图例或进度条旁，不另占一张卡。
普通图两列，主要趋势可全宽；同排等高，移动面板后重新对齐，不留大块空白。
同一指标不重复做卡片、仪表盘和表格。均值没有意义就不建平均模块，不能为排版硬算平均。
正常采集信息不必反复展示；数据过期或失败时，在受影响的图旁提示，不能藏到页尾。

2. 🏷️ 标题说人话

一个相关 emoji，加一个日常使用的短名称。 标题直接说这张图是什么，不写长句，不堆术语。

用「⚡ 当前负载」「📈 响应时间」「📊 请求总量」「💾 剩余空间」。
不用「覆盖与可信度」「多维资源画像」这类需要读者猜含义的词。
不写「覆盖与可信度 · 用量不含缓存读取」这样的标题。统计使用量，就叫「📊 使用量」；计算范围放悬停说明，单位放坐标轴或数值旁。
时间范围已有统一选择器，不在每张标题里重复。确有不同周期时，才补「今日」「本月」等必要区别。
用自然的人话，不写口号、不编概念，也不故作俏皮。

3. 🎛️ 不擅加筛选

打开就有完整的默认视图，不先让用户做选择题。 保留正常的时间选择器，不自动增加主机、环境、来源、状态等顶部下拉框。

只有用户明确需要切换范围时才增加筛选器。能直接同图比较的对象，不要求先选一个才能查看。
不为了图好看擅自增加 Top N、隐藏零值、只看成功或排除未知等条件；这些做法会漏掉信息。
查询仍需限定正确的目标和时间。后台查询条件不必变成页面筛选器。

4. 📊 先图后表

先判断能否用图讲清楚，再考虑表格。

变化用折线，排名用条形，少量分类的占比用环图，有明确上下界的余量用进度条。数值随图展示。

只有需要逐行核对名称、时间或精确值时才用表格，只保留必需的列，不铺十几列。
不因为数据里有记录时间、检查时间、来源、状态，就把它们全塞进顶部。补充信息按需放副文字、悬停提示或后面的明细。
表格列宽自适应、数值易比较，不让用户拖动半天才找到重点。能画成趋势或排名的内容，不改成宽表。
小占比图不独占整行；分类过多、数值接近时用排序条形图。
并列柱用于分类对比，堆叠用于看总量组成，不能混用。

5. 🎨 颜色和线条

同一对象跨图同色，不同对象一眼能分开。 色值不同但全是相近蓝紫色，仍是不合格的配色。

同一个成员、服务或设备，在所有相关图中固定同色，不随排序变化；新增对象不能打乱原有颜色。
选择区别明显的色相，保留文字图例。不能只检查色值有没有重复，要看线条和相邻扇区是否真的容易区分。
默认使用清楚的折线和圆点，可采用 3 px 线宽、5 px 圆点，每个绘制点都可见。点太密时先检查采样粒度，不直接退回细线、无点。
线性连接，不平滑突变；填充要淡，不让多个区域叠成一团。
对象颜色不表示告警等级，异常另用明确文字提示。

6. 🔢 数字不能画错

不偷换指标。 使用率不是累计量，已用不是剩余。先核实字段和单位再写查询，不能只改标题。来源没有的周期和指标，不从模板照搬。
不混算。 最新值、均值、累计值各算各的；重复记录先去重，百分比不能简单累加，累计计数器应求区间增量。
无事件按约定补零。 使用量约定无记录为 0 时，按完整对象清单和时间点补齐，空闲对象也保留零线；同范围补零前后总量不变。
缺测不能伪造为零。 采集失败不代表没有使用。区分真实零值与未知；“空值显示 0”不能代替补齐缺失时间点。
时间写准确。 页面刷新不是数据更新，最近检查也不一定是采集成功。只展示有用的时间，不为解释时间堆出多列表格。
默认范围写进配置。 按需求保存最近几小时、最近 7 天或今天，再从不带 from/to 的链接打开验证，不能只改访问链接。

7. ✅ 做完看一遍

保存后重新读取配置、运行查询，再打开整页检查：

是否按实时、平均、累计排序？有没有大数字卡或多余筛选器抢占首屏？
标题是否短、自然、带合适的 emoji？说明是否放在悬停或页尾，而不是塞进标题？
是否图优先、表格少而必要？有没有重复图、宽表或占整行的小饼图？
同对象是否同色，不同对象是否易辨？线条、圆点、零值和异常是否看得清？
指标含义、单位、默认时间和查询结果是否正确？

接口保存成功，不等于页面做好了。 必须实际看图；没有完成视觉检查就明确说明。修改现有 Dashboard 时保留 UID 和无关功能，不顺手改采集服务。

📚 参考

参考文章的结构与布局方法，不机械照搬其中的数字卡、细线、隐藏点或蓝紫配色。具体配置按目标 Grafana 和插件版本核实。