使用说明
术语按主题分组，括号内为英文原名；中文译名以官方界面常用写法为准。每条只给一句话，深入解释请顺着「下一步」回到对应文章。
实例、组织与权限
| 术语 | 一句话解释 |
|---|---|
| 实例（Instance） | 一个运行中的 Grafana 服务进程及其背后的数据库 |
| 组织（Organization） | 实例内的租户边界，数据源、仪表盘、用户在组织间相互隔离 |
| 用户（User） | 登录实例的人或服务账号，归属于一个或多个组织 |
| 团队（Team） | 组织内的用户分组，权限与仪表盘分发常按团队授予 |
| 角色（Role） | Viewer 只读、Editor 可写、Admin 可管理，组织内的三档基本权限 |
| RBAC | 基于角色的访问控制（Role-Based Access Control），可按文件夹、数据源等资源细粒度授权，多用于 Enterprise/Cloud |
| 服务账号（Service Account） | 供 API 与自动化使用的机器身份，可授予角色并签发 Token |
| API Key | 旧版接口凭据，新项目一律改用服务账号 Token |
数据源与查询
| 术语 | 一句话解释 |
|---|---|
| 数据源（Data Source） | Grafana 连接的外部数据库或 API，连接与凭据配置都挂在它身上 |
| 查询（Query） | 向数据源发出的取数请求，使用各自语言：PromQL、LogQL、SQL 等 |
| 即时查询（Instant Query） | 只取某一时刻的单个数值，日志告警等场景要求返回数值序列的查询即属此类 |
| 范围查询（Range Query） | 取一段时间内的序列，图表绘制的基本形式 |
| 代理模式（Server-side） | 查询由 Grafana 服务端转发到数据源，免浏览器跨域，与 Direct Connect 相对 |
| 指标（Metric） | 可聚合的数值型时间序列，回答「多少」 |
| 日志（Logs） | 带时间戳的文本事件流，回答「发生了什么」 |
| 链路（Traces） | 一次请求在分布式服务间的完整调用路径，回答「慢在哪」 |
| LGTM 栈 | Grafana 系的开源可观测组合：Loki（日志）+ Grafana（可视化）+ Tempo（链路）+ Mimir（指标） |
仪表盘与可视化
| 术语 | 一句话解释 |
|---|---|
| 面板（Panel） | 一块带标题、查询与可视化类型的最小展示单元 |
| 仪表盘（Dashboard） | 共享时间范围与变量的一组面板，本质是一份可导入导出的 JSON |
| 文件夹（Folder） | 仪表盘与告警规则的组织容器，也是权限授予的常见边界 |
| 模板变量（Variable） | 仪表盘顶部的下拉框，让一份仪表盘服务所有环境与主机 |
| 字段配置（Field Config） | 对查询结果字段的单位、阈值、配色等呈现规则设置 |
| 覆盖项（Overrides） | 针对特定面板或特定字段的字段配置例外规则 |
| 数据变换（Transformation） | 查询结果进入面板前的加工步骤：合并、透视、格式化、数学运算等 |
| 标注（Annotation） | 叠加在图上的事件竖线，用来解释「这个尖峰那天发生了什么」 |
| 链接（Link） | 仪表盘到仪表盘、面板到外部系统的跳转入口 |
| 快照（Snapshot） | 把仪表盘连数据定格成可分享页面的轻量发布方式 |
告警与通知
| 术语 | 一句话解释 |
|---|---|
| 统一告警（Unified Alerting） | 全数据源共用的一套告警引擎：规则、状态机、内置 Alertmanager、通知链路 |
| 告警规则（Alert Rule） | 查询加条件的组合，持续评估产生告警实例，本身不直接发通知 |
| 告警实例（Alert Instance） | 规则按标签展开出的每个序列各自的状态，状态机以实例为单位 |
| Pending / Firing | 实例状态：条件成立但未熬过 for 时长为 Pending，越过后正式触发为 Firing |
| 评估组（Evaluation Group） | 同文件夹内共用评估间隔与重试配置的一批规则 |
| 联系点（Contact Point） | 通知出口：一个目的地加一套凭据，如 Slack 频道、Webhook URL |
| 通知策略 / 路由树（Notification Policy） | 按标签匹配把告警分发到联系点的树状规则，根节点为默认策略 |
| 分组（Grouping） | 把同组告警合并为一条通知，由 group_by 与三个等待间隔控制节奏 |
| 静默（Silence） | 在有效期内按标签匹配拦截通知，规则评估不受影响 |
| 静音时段（Mute Timing） | 按日历时间窗口屏蔽整条策略分支的通知，如下班时间不吵 warning |
| 抑制（Inhibition） | 高级别告警存在时自动压掉其派生的低级别告警 |
| 通知模板（Template） | 用 Go template 语法定制通知文案的机制，决定消息长什么样 |
配置与生态
| 术语 | 一句话解释 |
|---|---|
| grafana.ini | 主配置文件，控制服务器、安全、数据库等全部设置项 |
| 环境变量覆盖 | 以 GF_ 前缀的环境变量覆盖 ini 任意配置，容器部署首选 |
| Provisioning | 用 YAML 文件声明数据源、仪表盘、告警，配置即代码，文件优先于界面 |
| 插件（Plugin） | 扩展 Grafana 的三种形态：数据源、面板、应用，走签名校验加载 |
| HTTP API | 实例内置的 REST 接口，界面能做的事件几乎都有端点可调用 |
| Grafana Cloud | 官方托管服务，含免费层，与自管实例共享同一套代码基 |
| 服务日志（Server Log） | 排障第一现场，位于 data/log 或容器标准输出 |
提示： 表中未收录的小众术语（如 Correlations、Data Links），多数只在对应专题文章里出现，按文章内解释理解即可，不必背。
下一步
- 概念全景回看核心概念地图。
- 数据源相关术语展开讲，见数据源概念与管理。
- 告警术语的机制背景，读Grafana 告警体系总览。
- 遇到问题直接跳故障排查手册。