为什么要先建立概念地图
Grafana 的功能很多,但几乎所有操作都围绕同一组基本概念展开。把这组概念放进一张图里,后面读任何章节都会有「锚点」可依。
一条数据视角的主线
从数据流过的方向看,Grafana 的世界由这几层组成:
- 数据源(DataSource) —— Grafana 连接的外部数据库,如 Prometheus、Loki、MySQL。它保存连接地址、认证方式等配置。
- 查询(Query) —— 向数据源发出的取数请求,使用各自的语言(PromQL、LogQL、SQL……)。
- 面板(Panel) —— 一块有标题、有查询、有可视化类型的「画布」。折线图、仪表盘、表格、日志列表都是面板。
- 仪表盘(Dashboard) —— 一组面板的集合,共享时间范围、模板变量与刷新频率。它是一份 JSON 文档,可导入导出。
- 标注(Annotation) —— 叠加在图上的事件线,如部署记录,用来解释「这个尖峰发生了什么」。
提示: 时间范围与变量属于仪表盘级别——这就是为什么同一个面板在不同时间窗口下呈现完全不同的曲线。
组织视角的四层结构
数据之上是「谁能看到什么」:
| 概念 | 英文 | 一句话解释 |
|---|---|---|
| 服务器实例 | Instance | 一个运行中的 Grafana,由管理员配置数据源与用户 |
| 组织 | Organization | 实例内的租户边界,数据在组织间隔离 |
| 团队 | Team | 组织内的用户分组,权限分配的基本单位 |
| 用户 | User | 登录的人或服务账号,通过角色获得权限 |
界面导航速记
登录后左侧栏的核心入口:
- Dashboards(仪表盘):查看与管理所有仪表盘。
- Explore(探索):即席查询,不保存面板,适合排障时「先看一眼」。
- Alerting(告警):告警规则、联系点与通知策略都在这里。
- Connections(连接):数据源与插件的安装入口。
- Administration(管理):组织、用户、团队、服务器设置。
注意: 官方文档 2025 年改版后,不同小版本的菜单名称可能略有差异;以你实例中实际界面为准。
概念之间怎么连
一个最典型的工作流:管理员配置数据源 → 工程师用 Explore 试查询 → 满意后把查询固化成面板 → 面板拼成仪表盘 → 仪表盘放进文件夹 → 通过团队与角色控制谁能看到 → 在关键面板上配告警规则 → 出问题时经由联系点通知到 Slack 或 PagerDuty。
下一步建议:五分钟快速上手,把这条链路亲手走一遍。