本篇目录5 节

01认识 GrafanaIntroduction

核心概念地图

数据源、面板、仪表盘、文件夹、组织、用户与团队——用一张概念地图串起 Grafana 的全部基本术语,读文档不迷路。

约 2 分钟/655 字/GRAFANA 12.X

为什么要先建立概念地图

Grafana 的功能很多,但几乎所有操作都围绕同一组基本概念展开。把这组概念放进一张图里,后面读任何章节都会有「锚点」可依。

一条数据视角的主线

从数据流过的方向看,Grafana 的世界由这几层组成:

  1. 数据源(DataSource) —— Grafana 连接的外部数据库,如 Prometheus、Loki、MySQL。它保存连接地址、认证方式等配置。
  2. 查询(Query) —— 向数据源发出的取数请求,使用各自的语言(PromQL、LogQL、SQL……)。
  3. 面板(Panel) —— 一块有标题、有查询、有可视化类型的「画布」。折线图、仪表盘、表格、日志列表都是面板。
  4. 仪表盘(Dashboard) —— 一组面板的集合,共享时间范围、模板变量与刷新频率。它是一份 JSON 文档,可导入导出。
  5. 标注(Annotation) —— 叠加在图上的事件线,如部署记录,用来解释「这个尖峰发生了什么」。

提示: 时间范围与变量属于仪表盘级别——这就是为什么同一个面板在不同时间窗口下呈现完全不同的曲线。

组织视角的四层结构

数据之上是「谁能看到什么」:

概念 英文 一句话解释
服务器实例 Instance 一个运行中的 Grafana,由管理员配置数据源与用户
组织 Organization 实例内的租户边界,数据在组织间隔离
团队 Team 组织内的用户分组,权限分配的基本单位
用户 User 登录的人或服务账号,通过角色获得权限

角色的详细矩阵见角色与权限;组织的日常操作见组织

界面导航速记

登录后左侧栏的核心入口:

  • Dashboards(仪表盘):查看与管理所有仪表盘。
  • Explore(探索):即席查询,不保存面板,适合排障时「先看一眼」。
  • Alerting(告警):告警规则、联系点与通知策略都在这里。
  • Connections(连接):数据源与插件的安装入口。
  • Administration(管理):组织、用户、团队、服务器设置。

注意: 官方文档 2025 年改版后,不同小版本的菜单名称可能略有差异;以你实例中实际界面为准。

概念之间怎么连

一个最典型的工作流:管理员配置数据源 → 工程师用 Explore 试查询 → 满意后把查询固化成面板 → 面板拼成仪表盘 → 仪表盘放进文件夹 → 通过团队与角色控制谁能看到 → 在关键面板上配告警规则 → 出问题时经由联系点通知到 Slack 或 PagerDuty。

下一步建议:五分钟快速上手,把这条链路亲手走一遍。

本页为学习整理的中文改写,依据Grafana 官方文档最新版本编写(以 Grafana 12.x 为基准),操作路径请以实际产品界面为准。

Introduction