Grafana高可用部署核心前提是所有实例共享同一外部数据库(MySQL/PostgreSQL),替换默认SQLite以避免并发冲突;需配置统一database连接、一致security.secret_key、专用低权限数据库账号,并确保数据库自身具备高可用能力。

要让 Grafana 支持高可用(HA)部署,核心前提是所有 Grafana 实例共享同一份元数据——包括用户、仪表板、告警规则、权限配置等。默认的嵌入式 SQLite 数据库无法被多个实例并发安全访问,因此必须替换为 MySQL 或 PostgreSQL 这类支持多连接、事务和行级锁的关系型数据库。
修改 grafana.ini 配置数据库后端
编辑主配置文件 /etc/grafana/grafana.ini,定位到 [database] 区块,注释掉或删除 SQLite 相关配置,启用对应外部数据库:
- 对于 MySQL:
type = mysql
host = your-mysql-host:3306
name = grafana
user = grafana_writer
password = your_secure_password
ssl_mode = disable(若未启用 TLS)
可选:添加 max_open_conn = 10 和 max_idle_conn = 5 控制连接池大小 - 对于 PostgreSQL:
type = postgres
host = your-pg-host:5432
name = grafana
user = grafana_writer
password = your_secure_password
ssl_mode = disable(或require/verify-full)
注意:Grafana 启动时会自动创建所需表结构,无需手动导入 schema;但数据库 必须预先创建(如 MySQL 中执行 CREATE DATABASE grafana DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;)。
准备专用数据库账号并限制权限
切勿使用 root 或高权限账号。应创建仅具备必要 DML 权限的专用用户:
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理(CRM)系统设计、评审、优化或生成数据库模式时,应使用此项技能。
- MySQL 示例:
CREATE USER 'grafana_writer'@'%' IDENTIFIED BY 'strong_pass';GRANT SELECT, INSERT, UPDATE, DELETE ON grafana.* TO 'grafana_writer'@'%';FLUSH PRIVILEGES; - PostgreSQL 示例:
CREATE USER grafana_writer WITH PASSWORD 'strong_pass';GRANT CONNECT ON DATABASE grafana TO grafana_writer;\c grafanaGRANT USAGE ON SCHEMA public TO grafana_writer;GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO grafana_writer;
该账号只需操作 grafana 库内的系统表,不涉及业务数据,也无需 DDL 权限。
确保数据库服务具备高可用能力
Grafana 自身是无状态的,但其依赖的元数据库必须可靠。实际生产中需满足:
- MySQL 推荐使用主从集群 + 读写分离代理(如 ProxySQL),或云厂商托管的高可用 RDS 实例(如阿里云 PolarDB、AWS Aurora)
- PostgreSQL 推荐采用流复制 + Patroni 自动故障转移,或云上托管服务(如腾讯云 TBase、阿里云 PolarDB-PG)
- 数据库连接地址应使用 VIP、DNS 名或负载均衡器入口,避免硬编码单点 IP
- 在 grafana.ini 中设置 conn_max_lifetime = 14400(4 小时)和 max_idle_conn = 5,有助于应对后端连接漂移
启动与验证集群行为
完成配置后,依次启动多个 Grafana 实例(例如通过 systemd、Kubernetes Deployment 或 Docker Compose):
- 所有实例共用同一份
grafana.ini(尤其是 database 和 security.secret_key) - security.secret_key 必须一致,否则会因 session 解密失败导致登录异常或 dashboard 权限错乱
- 可通过 Grafana Admin UI 的「Server Admin」→「Stats」查看当前实例是否已注册到共享数据库,并观察「active_users」、「dashboards」等计数是否跨实例同步
- 手动在一个实例中新建 dashboard,稍等几秒后在另一实例刷新页面,确认可见且可编辑
不复杂但容易忽略:时间同步(NTP)、网络连通性(特别是 Grafana 节点到 DB 的 3306/5432 端口)、以及防火墙/安全组放行策略,都直接影响集群初始化成功率。

















