---
name: dashboard-builder
description: 为 Grafana、SigNoz 等平台构建能够回答实际运维人员问题的监控仪表板。适用于将指标转化为可用的仪表板，而非华而不实的展示板。
origin: ECC direct-port adaptation
version: "1.0.0"
---

# 仪表盘构建器

当任务需要构建一个可供操作人员使用的仪表盘时使用此方案。

目标不是"展示所有指标"，而是回答以下问题：

* 系统健康吗？
* 瓶颈在哪里？
* 发生了什么变化？
* 应该采取什么行动？

## 使用场景

* "构建一个Kafka监控仪表盘"
* "为Elasticsearch创建一个Grafana仪表盘"
* "为这个服务制作一个SigNoz仪表盘"
* "将这个指标列表转化为真正的运维仪表盘"

## 约束条件

* 不要从视觉布局开始；要从操作人员的问题出发
* 不要仅仅因为指标存在就包含所有可用指标
* 不要在没有结构的情况下混合健康、吞吐量和资源面板
* 不要发布没有标题、单位和合理阈值的面板

## 工作流程

### 1. 定义操作问题

围绕以下方面组织：

* 健康/可用性
* 延迟/性能
* 吞吐量/容量
* 饱和度/资源
* 服务特定风险

### 2. 研究目标平台架构

首先检查现有仪表盘：

* JSON结构
* 查询语言
* 变量
* 阈值样式
* 分区布局

### 3. 构建最小可用面板

推荐结构：

1. 概览
2. 性能
3. 资源
4. 服务特定分区

### 4. 剔除装饰性面板

每个面板都应回答一个真实问题。如果不能，则移除。

## 示例面板集

### Elasticsearch

* 集群健康
* 分片分配
* 搜索延迟
* 索引速率
* JVM堆/GC

### Kafka

* 代理数量
* 副本不足的分区
* 消息流入/流出
* 消费者滞后
* 磁盘和网络压力

### API网关/入口

* 请求速率
* p50/p95/p99延迟
* 错误率
* 上游健康
* 活跃连接数

## 质量检查清单

* \[ ] 有效的仪表盘JSON
* \[ ] 清晰的分区分组
* \[ ] 包含标题和单位
* \[ ] 阈值/状态颜色有意义
* \[ ] 存在常用过滤器的变量
* \[ ] 默认时间范围和刷新频率合理
* \[ ] 没有对操作人员无价值的装饰性面板

## 相关技能

* `research-ops`
* `backend-patterns`
* `terminal-ops`