[Github] Grafana – 把多种数据源接成可视化观测台

如果你的指标、日志和链路数据分别落在 Prometheus、Loki、Tempo、Elasticsearch 或数据库里，Grafana 的价值不在于把这些后端替换掉，而在于提供一个统一的查询、可视化、分享和告警入口。它更像可观测性系统的工作台，而不是遥测数据仓库：先把数据源接好，再组织查询、面板和 Dashboard，最后才是告警路由、权限、备份与升级。

先看清它管什么

Grafana 官方 README 将项目定位为开放源码的监控与可观测性平台，核心动作是 query、visualize、alert 和 understand。这个定位决定了它的边界：Grafana 负责向外部数据源发起查询、把结果交给面板渲染，并在规则满足条件时发送通知；Prometheus、Loki、Tempo、InfluxDB 或 PostgreSQL 等系统仍然负责各自的数据采集、存储、保留周期和容量规划。

这也是选型时最容易忽略的一点。只部署 Grafana 而没有可查询的数据源，得到的只是空的管理界面；反过来，已经有多个监控后端的团队，才更能从统一的 Dashboard、Explore 和告警入口中获得收益。

它不负责存储

Grafana 自身仍需要数据库保存用户、数据源、Dashboard 等配置。官方安装文档说明，默认可以使用嵌入式 SQLite，但它适合本地开发和小规模评估，不建议作为生产环境的长期方案；需要高可用时，应使用 MySQL 或 PostgreSQL。这里要区分“Grafana 的配置数据库”和“指标、日志、链路后端”，前者保存平台状态，后者保存真正被观测的数据。

三层协作

可以用一条实际工作链理解 Grafana：数据源插件负责连接某类系统，已配置的数据源提供具体地址和认证信息，查询返回数据后由面板插件决定如何呈现，多个面板组成 Dashboard；Explore 则更适合临时查询、对比时间范围和从指标钻取到日志。官方文档还特别区分了 Cloud 的 Integration：它把采集配置、Dashboard 和告警打包在一起，不应直接当成自托管 OSS 的默认能力。

从数据源开始

安装完成后，第一项真正有价值的工作不是挑颜色或布局，而是添加一个可验证的数据源。Grafana 内置了 Prometheus、Loki、MySQL 等核心数据源插件，也可以从插件目录扩展到更多数据库、云服务和第三方系统。配置时要准备好端点、认证方式、访问模式以及数据源本身的权限边界；连接成功只代表 Grafana 能查询，不代表查询本身已经足够低成本或安全。

当多个数据源都接入后，Grafana 的“混合数据源”能力可以让同一图表里的不同查询分别指向不同数据源。它适合把同一时间窗口的指标、业务数据库结果或日志统计放到一个观察上下文里，但也会把查询延迟、字段语义和故障排查复杂度叠加到 Dashboard 上。跨源组合应服务于一个明确的问题，不要为了“看起来集中”而把所有查询塞进一张图。

把面板做成系统

Dashboard 的价值来自可复用，而不是面板数量。Grafana 支持模板变量，让环境、主机、服务或租户成为 Dashboard 顶部的选择项；同一份布局可以通过变量切换对象。对团队来说，先确定要回答的运营问题，再决定面板、时间范围、刷新频率和变量，比复制一张漂亮的图更重要。

面板是查询结果的呈现层：指标名称、数值卡片、颜色和布局都可以围绕同一个问题组织。真正上线前，还需要检查每个面板的查询成本和刷新间隔；官方安装文档明确把并发用户、告警规则、数据源类型、面板数量和刷新频率列为影响 Grafana 服务进程负载的因素。

变量与查询

推荐的起步顺序是：先用一个数据源写出最小查询，再把查询结果放进单个面板，确认时间范围和单位正确后，才抽取环境或服务变量。这样做能避免变量、转换、阈值和多个查询同时出错时无法定位。Explore 适合临时验证查询，Dashboard 适合沉淀团队共识，两者不要混为同一个编辑场景。

探索到告警

Grafana Alerting 建立在规则评估之上：规则执行数据源查询并检查条件，一条规则可以按时间序列或维度产生多个 alert instance，触发后再交给 contact point 或 notification policy 路由。这个模型比“某个面板变红就发消息”更可控，但也意味着要同时设计评估间隔、标签、通知分组、维护窗口和静默策略。告警数量一多，规则本身也会成为 Grafana 服务进程的负载来源。

部署先做取舍

如果只是评估界面和数据源连接，官方 Docker OSS 镜像足够作为起点。下面的命令使用当前官方文档列出的 grafana/grafana 镜像和默认数据目录；本文没有在本机执行它，因此不把启动结果写成实测结论。

docker run -d --name=grafana \
  -p 3000:3000 \
  -v grafana-storage:/var/lib/grafana \
  grafana/grafana:13.2.0

进入 http://localhost:3000 后，先完成登录和基础安全设置，再添加第一个数据源。生产环境不要长期依赖浮动标签，也不要把容器可写层当作备份；至少应把 /var/lib/grafana、配置文件、Provisioning 目录和外部数据库纳入自己的备份与恢复方案。

Docker 入门

上面的单容器方式适合快速确认 Grafana 能否访问你的数据源。实际部署时，还要明确容器网络、反向代理、HTTPS、认证方式、插件安装策略和数据目录的持久化方式。对于生产镜像，建议使用已经核验过的明确版本，并在升级前阅读对应 Release 的安全修复与 Breaking changes。

生产配置

官方安装文档把 Grafana 服务进程与数据源容量分开计算：Prometheus、Loki、Tempo 等后端各有自己的资源和保留策略。多实例部署还需要外部 MySQL 或 PostgreSQL，以及粘性会话或共享 Redis 会话存储；告警规则很多、评估周期很短或面板刷新频繁时，Grafana 的查询和告警评估会互相争用资源。单纯给 Grafana 容器加 CPU，并不能替代对数据源和查询设计的治理。

把配置纳入版本

自托管 Grafana 最值得尽早建立的习惯，是把“手工点出来的状态”转成可复现配置。官方 Provisioning 系统支持用配置文件定义数据源和 Dashboard，文件可以纳入版本控制。数据源文件通常放在 provisioning/datasources，敏感值可以通过环境变量注入；官方文档也提醒，环境变量适合配置值，不应拿来替代配置键或整段文件结构。

apiVersion: 1
datasources:
  - name: Prometheus
    type: prometheus
    access: proxy
    url: http://prometheus:9090
    isDefault: true
    editable: false

这段示例只表达配置结构，不包含真实凭据，也没有假设你的 Prometheus 服务名。实际使用时还要根据数据源文档补充认证、TLS 和 jsonData 字段。多实例场景应为配置维护版本号，避免不同实例在重启时用旧文件覆盖新状态；如果启用 prune，还要先确认删除配置文件是否意味着你希望删除对应的已托管数据源。

升级与恢复

备份不能只备份 Dashboard JSON。Grafana 的配置数据库、数据源连接信息、用户和权限状态、Provisioning 文件、插件版本以及外部数据源本身，都可能影响恢复后的可用性。升级前至少记录当前版本、数据库备份、插件清单和关键 Dashboard；升级后优先检查登录、数据源连通性、告警评估和通知路由。

它适合谁

Grafana 适合已经拥有一个或多个指标、日志或链路后端，想统一查询和分享入口的开发团队、平台团队和运维团队；也适合希望把 Dashboard、数据源和告警配置纳入 GitOps 的组织。如果你的需求只是一个无需维护后端的托管监控面板，Grafana OSS 并不会自动提供采集、存储、保留和高可用，这时应把 Grafana Cloud 或其他托管方案一起纳入比较。

许可方面，仓库的 LICENSE 与 LICENSING.md 将默认项目许可标为 AGPL-3.0-only，同时列出部分 Apache-2.0 例外目录；这不是一句“开源”就能概括的商用结论。要把 Grafana 嵌入产品、修改后提供网络服务或分发相关代码时，应让法务按具体使用方式核对许可证和例外清单。

核验信息

以上版本、数量和维护状态都是核验时点信息，不应当被当作永久不变的项目属性。本文依据 Grafana 官方仓库、官方文档和仓库公开 UI 资产整理，未进行本地部署或性能测试。

相关链接

• 项目仓库：https://github.com/grafana/grafana
• 项目官网：https://grafana.com
• 官方文档：https://grafana.com/docs/grafana/latest/
• 安装文档：https://grafana.com/docs/grafana/latest/setup-grafana/installation/
• Provisioning 文档：https://grafana.com/docs/grafana/latest/administration/provisioning/
• v13.2.0 Release：https://github.com/grafana/grafana/releases/tag/v13.2.0