Grafana 是什么
Grafana 是开源的可视化与看板平台：接入多种数据源后，通过查询、转换与可视化三类配置把原始数据组织成图表。它同时承担看板分享、变量联动与统一查询入口的角色，是监控体系中面向人的那一层。
四级组织模型
Grafana 用四级模型组织内容：组织是租户边界，文件夹用于归类与权限管理，看板是分享与订阅的单位，面板是看板里的单个图表。理清这四级，权限规划与目录规划都会变得容易，也能避免看板越积越乱。
它不存监控数据
Grafana 本身只保存看板定义、数据源配置与用户信息，监控数据仍在 Prometheus、日志库或时序数据库中。因此看板异常时要先判断是数据源问题还是展示问题，这两类故障的排查路径完全不同。
基本信息
| 默认端口 | 3000 |
|---|---|
| 初始账号 | 管理员账号首次登录会强制修改密码 |
| 核心对象 | 数据源、文件夹、看板、面板 |
| 配置文件 | 主配置文件，支持用环境变量覆盖同名设置 |
| 版本差异 | 看板模型带版本号，导入旧版本看板会自动迁移 |
典型使用场景
- 统一监控入口：把指标、日志与链路查询集中在同一处
- 看板模板化：配合变量让同一张看板适配多环境与多实例
- 告警入口：对指标与日志查询配置规则并送达通知渠道
- 分享与订阅：按看板分享链接，或定期推送快照
- 权限管理：按文件夹划分团队的可见范围
- 临时探索：在探索区验证查询思路，不必固化成看板
层级关系
层级关系
Organization 组织
└── Folder 文件夹（权限与归类边界）
└── Dashboard 看板（时间范围 + 变量 + 面板集合）
└── Panel 面板（查询 + 转换 + 可视化）
└── Query 查询（数据源 + 表达式）核心概念
| 概念 | 作用 | 注意 |
|---|---|---|
| 数据源 | 定义数据从哪里取 | 连接信息与权限是取数的基础 |
| 文件夹 | 归类与权限边界 | 按团队或业务划分 |
| 看板 | 分享与订阅的单位 | 一个看板描述一个主题 |
| 面板 | 看板里的单个图表 | 由查询、转换与可视化组成 |
| 变量 | 让看板适配多个目标 | 取值来源与基数要可控 |
常见搭配
| 数据源 | 典型用途 | 查询语言 |
|---|---|---|
| Prometheus | 指标与告警 | PromQL |
| Loki | 日志检索与统计 | LogQL |
| Elasticsearch | 全文检索与聚合 | 查询 DSL 与 KQL |
| 关系型数据库 | 业务报表 | SQL |
上手顺序
- 先接入一个数据源并验证连通性，确保能取到数
- 用现成看板或模板起步，再按需改造面板
- 把重复出现的查询抽成变量，减少看板数量
- 为关键看板设置合理的默认时间范围与自动刷新
看板与文件夹分开规划：先按团队或业务建文件夹，再在文件夹内组织看板，权限与查找成本都会明显降低。
把 Grafana 当时序库来用会踩坑：它不保存指标，删掉看板不影响数据，删掉数据源则所有相关面板同时失效。
看板维护的常见约定
- 命名带业务前缀：查找与权限归类都依赖命名
- 统一默认时间范围：同一主题的看板保持一致，便于横向对比
- 变量带默认值：打开即呈现有意义的内容
- 关键看板加说明：把口径与负责人写在面板描述里
看板定义可以导出为文本并纳入版本管理：这样重构与回滚都有据可依，也能通过评审发现口径被悄悄改动。