本篇目录6 节

05数据源Data Sources

数据源概念与管理

Grafana 自己不存数据,一切可视化都从数据源开始。本文讲数据源的类型划分、添加与体检流程、代理与直连的区别,以及默认源、重命名与 UID 等维护要点。

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

数据源是什么

数据源(DataSource)是 Grafana 连接外部数据库的一份配置:地址、认证方式、查询参数都在里面。它由对应的插件提供——内置的如 Prometheus、Loki、Elasticsearch,市场里还有数百种第三方数据源。一个实例里可以配任意多个数据源,同一个面板也能混合使用它们。

类型速查

类别 典型代表 典型用途
指标 Prometheus、InfluxDB、CloudWatch 时间序列曲线、容量与 SLO
日志 Loki、Elasticsearch、Cloud Logging 排障检索、日志告警
链路 Tempo、Jaeger、Zipkin 请求级调用链分析
SQL/NoSQL MySQL、PostgreSQL、Graphite、Infinity 业务表、任意 JSON/CSV 接口

按信号类别浏览用法,可先读探索指标探索日志

添加数据源

  1. 打开 Connections → Data sources,点击 Add data source(菜单名随版本略有差异,以实际界面为准)。
  2. 在列表中选择类型;未安装的数据源会提示先安装插件,见插件机制:安装与管理
  3. 填写连接信息,最常见的是 URL——注意填「Grafana 服务器可达」的地址。
  4. 按需配置鉴权(Basic、Bearer、TLS 证书等)。
  5. 点击 Save & test,看到绿色成功提示即完成体检。

Save & test 就是数据源的健康检查:Grafana 后端向目标地址发一次真实请求。告警系统也会周期性检查各数据源健康状态,异常的数据源会在列表中给出黄色或红色标记。

代理还是直连

模式 路径 优缺点
Server(代理,默认) 浏览器 → Grafana 后端 → 数据源 凭证不进浏览器、无跨域问题、可复用缓存;多一跳
Browser(直连) 浏览器 → 数据源 少一跳;要求数据源对办公网可达且配好 CORS,凭证暴露给前端

除非明确知道直连的收益与风险,保持代理模式。Prometheus 类数据源的 Direct connect 选项在连接 Prometheus里另有展开。

日常维护:默认、重命名与 UID

  • 默认数据源:打开某个数据源的 Default 开关后,新建面板未指定来源时用它;改动只影响未来操作。
  • 重命名:仪表盘里的查询通常按 UID 引用数据源,界面上改名一般不影响已有面板;但引用了「名称」的老仪表盘、数据源类型变量与告警规则可能受影响,改名后建议抽查。
  • 删除:引用它的面板会直接报错,删除前先在仪表盘里迁移引用。

生产环境推荐用文件方式管理数据源,显式固定 UID,避免「改名即失联」:

apiVersion: 1
datasources:
  - name: Prometheus-prod
    uid: prom-prod
    type: prometheus
    access: proxy
    url: http://prometheus:9090
    isDefault: true

完整机制见Provisioning:配置即代码

下一步

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

Data Sources