grafana-dashboard-design

# Grafana Dashboard 设计规范

## DataSource 确认（必须执行）

**重构/重画现有 Dashboard**：使用 `get_dashboard_by_uid` 读取原 Dashboard，提取 `datasource.uid`，询问用户是否保持一致。

**新增面板**：主动询问用户 DataSource（prometheus / cf-analysis /  其他）。

---

## 布局原则

**金字塔结构**：顶部概览 → 中部核心 → 底部详情

```
Row 1: 全局健康（6-8 个 Stat，背景色表示状态）
Row 2: 核心指标（Gauge + TimeSeries）
Row 3+: 按模块分组（左 Stat 组 + 右趋势图）
Row 底部: 详细数据（Table / PieChart / BarGauge）
```

**Row 命名**：使用 emoji 前缀

| Emoji | 用途 |
|-------|------|
| 🎯 | 全局概览 |
| ⚡ | 性能指标 |
| 🚀 | 服务监控 |
| 📱 | 用户体验 |
| 📊 | 业务数据 |
| 🔥 | 错误告警 |
| 💻 | 资源使用 |

---

## 配色规范

### 阈值色（红黄绿）

| 状态 | 色值 |
|------|------|
| 危险 | `#F2495C` |
| 警告 | `#FF9830` |
| 正常 | `#73BF69` |

### 服务主题色

| 色值 | 色名 |
|------|------|
| `#6ED0E0` | 青 |
| `#B877D9` | 紫 |
| `#5794F2` | 蓝 |
| `#FF9830` | 橙 |
| `#73BF69` | 绿 |
| `#FADE2A` | 黄 |
| `#F2495C` | 红 |
| `#8AB8FF` | 浅蓝 |

---

## 面板类型速查

| 场景 | 面板 |
|------|------|
| 单值指标 | stat |
| 百分比 | gauge |
| 时间趋势 | timeseries |
| 占比分布 | piechart (donut) |
| 排名对比 | bargauge |
| 详细数据 | table |
| 地理分布 | geomap |
| 状态时间线 | state-timeline |

---

## 效果关键配置

### Stat 面板
- `colorMode: background` - 背景色填充
- `graphMode: area` - 迷你趋势图

### TimeSeries 面板
- `fillOpacity: 20` - 半透明填充
- `gradientMode: opacity` - 渐变效果
- `lineInterpolation: smooth` - 平滑曲线
- `thresholdsStyle.mode: line+area` - 阈值线+区域

### Gauge 面板
- `showThresholdLabels: true` - 显示阈值标签
- `showThresholdMarkers: true` - 显示阈值标记

### PieChart 面板
- `pieType: donut` - 环形图
- `legend.displayMode: table` - 表格图例

### BarGauge 面板
- `displayMode: gradient` - 渐变填充
- `orientation: horizontal` - 水平排列

### 高级特效
- `stacking.mode: normal` - 堆叠区域图
- `custom.axisPlacement: right` - 双 Y 轴
- Repeat 变量 - 多实例自动复制
- offset 查询 - 同比/环比对比

---

## 最佳实践

- 刷新间隔：实时 5-10s，常规 30s