数据源是什么
数据源(DataSource)是 Grafana 连接外部数据库的一份配置:地址、认证方式、查询参数都在里面。它由对应的插件提供——内置的如 Prometheus、Loki、Elasticsearch,市场里还有数百种第三方数据源。一个实例里可以配任意多个数据源,同一个面板也能混合使用它们。
类型速查
| 类别 | 典型代表 | 典型用途 |
|---|---|---|
| 指标 | Prometheus、InfluxDB、CloudWatch | 时间序列曲线、容量与 SLO |
| 日志 | Loki、Elasticsearch、Cloud Logging | 排障检索、日志告警 |
| 链路 | Tempo、Jaeger、Zipkin | 请求级调用链分析 |
| SQL/NoSQL | MySQL、PostgreSQL、Graphite、Infinity | 业务表、任意 JSON/CSV 接口 |
添加数据源
- 打开 Connections → Data sources,点击 Add data source(菜单名随版本略有差异,以实际界面为准)。
- 在列表中选择类型;未安装的数据源会提示先安装插件,见插件机制:安装与管理。
- 填写连接信息,最常见的是 URL——注意填「Grafana 服务器可达」的地址。
- 按需配置鉴权(Basic、Bearer、TLS 证书等)。
- 点击 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:配置即代码。
下一步
- 最经典的组合,从连接 Prometheus开始。
- 日志侧搭档,见Loki 日志数据源。
- 结构化数据,见SQL 数据源:MySQL 与 PostgreSQL。