Grafana 基础回顾：数据源、仪表板、面板、变量、告警

在深入跨环境同步之前，必须统一对 Grafana 核心概念的理解。本章将围绕五个基础构件展开：数据源、仪表板、面板、变量和告警。这些概念是后续模板标准化与同步策略的基石。

1. 核心概念总览

下表从定义、作用与跨环境同步关注点三个维度，快速对齐五个概念。

2. 数据源：仪表板的“数据管道”

数据源是 Grafana 与后端存储之间的桥梁。每个面板必须绑定一个数据源才能执行查询。在跨环境同步中，数据源是第一个需要解耦的要素。

• 类型：Prometheus、Loki、CloudWatch、Graphite、InfluxDB 等。
• 关键属性：名称（Name）、类型（Type）、URL、访问模式（Server/Browser）、认证信息。
• 同步策略：通过 Provisioning 配置文件或环境变量注入，避免在仪表板 JSON 中硬编码数据源 UID。

3. 仪表板与面板：可视化核心

仪表板是 Grafana 的顶层实体，以 JSON 格式存储。面板是仪表板内的可视化单元，每个面板包含查询、可视化类型、样式与交互配置。

以下是一个简化面板 JSON 结构示例：

{
  "title": "CPU 使用率",
  "type": "timeseries",
  "datasource": {
    "type": "prometheus",
    "uid": "PXXXXXXXXX"
  },
  "targets": [
    {
      "expr": "100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)",
      "legendFormat": "{{ instance }}"
    }
  ],
  "fieldConfig": {
    "defaults": {
      "unit": "percent",
      "thresholds": { "steps": [ { "value": null, "color": "green" }, { "value": 80, "color": "red" } ] }
    }
  }
}

4. 变量：让仪表板“活”起来

变量是仪表板的动态参数，允许用户通过下拉菜单、输入框或自动查询来改变面板展示的内容。变量在跨环境同步中扮演适配器角色。

常见变量类型：

5. 告警：从可视化到主动通知

Grafana 告警系统支持基于面板查询结果定义规则，并通过通知渠道（邮件、Slack、PagerDuty 等）发送告警。在跨环境同步中，告警规则需要谨慎处理。

• 规则定义：表达式、评估频率、条件、持续时间。
• 通知策略：路由、分组、静默、重复。
• 同步挑战：开发环境的告警阈值通常比生产环境宽松；通知渠道配置（如 Slack Webhook URL）是环境敏感的。

6. 概念关系图

下图展示了五个核心概念之间的依赖与数据流向：

7. 同步视角下的关键差异

下表从同步操作的角度，对比五个概念在“源环境”与“目标环境”之间的典型差异：