# Grafana 高可用部署：使用 PostgreSQL 后端数据库 > 使用 PostgreSQL 而不是 SQLite 作为 Grafana 后端使用的远程存储数据库，获取更好的性能与可用性。 --- LLMS 索引： [llms.txt](/zh/llms.txt) --- 您可以使用 PostgreSQL 作为 Grafana 后端使用的数据库。 这是了解 Pigsty 部署系统使用方式的好机会，完成此教程，您会了解： * 如何 [创建新数据库集群](#创建数据库集群) * 如何在已有数据库集群中 [创建新业务用户](#创建grafana业务用户) * 如何在已有数据库集群中 [创建新业务数据库](#创建grafana业务数据库) * 如何 [访问Pigsty所创建的数据库](#使用grafana业务数据库) * 如何 [管理Grafana中的监控面板](#管理grafana监控面板) * 如何管理 Grafana 中的 [PostgreSQL数据源](#管理postgres数据源) * 如何一步到位完成 [Grafana数据库升级](#一步到位更新grafana) -------- ## 太长不看 ```bash vi pigsty.yml # 取消注释DB/User定义：dbuser_grafana grafana bin/pgsql-user pg-meta dbuser_grafana bin/pgsql-db pg-meta grafana psql postgres://dbuser_grafana:DBUser.Grafana@meta:5436/grafana -c \ 'CREATE TABLE t(); DROP TABLE t;' # 检查连接串可用性 vi /etc/grafana/grafana.ini # 修改 [database] type url systemctl restart grafana-server ``` -------- ## 创建数据库集群 我们可以在 `pg-meta` 上定义一个新的数据库 `grafana`，也可以在新的机器节点上创建一个专用于 Grafana 的数据库集群：`pg-grafana` ### 定义集群 如果需要创建新的专用数据库集群 `pg-grafana`，部署在 `10.10.10.11`，`10.10.10.12` 两台机器上，可以使用以下配置文件： ```yaml pg-grafana: hosts: 10.10.10.11: {pg_seq: 1, pg_role: primary} 10.10.10.12: {pg_seq: 2, pg_role: replica} vars: pg_cluster: pg-grafana pg_databases: - name: grafana owner: dbuser_grafana revokeconn: true comment: grafana primary database pg_users: - name: dbuser_grafana password: DBUser.Grafana pgbouncer: true roles: [dbrole_admin] comment: admin user for grafana database ``` ### 创建集群 使用以下命令完成数据库集群 `pg-grafana` 的创建：[`pgsql.yml`](/docs/pgsql/playbook#pgsqlyml)。 ```bash ./pgsql.yml -l pg-grafana # 初始化pg-grafana集群 ``` 该命令是 Ansible Playbook [`pgsql.yml`](/docs/pgsql/playbook#pgsqlyml)，用于创建数据库集群。 定义在 [`pg_users`](/docs/pgsql/param#pg_users) 与 [`pg_databases`](/docs/pgsql/param#pg_databases) 中的业务用户与业务数据库会在集群初始化时自动创建，因此使用该配置时，集群创建完毕后，（在没有 DNS 支持的情况下）您可以使用以下连接串 [访问](/docs/concept/sec/ac) 数据库（任一即可）： ```bash postgres://dbuser_grafana:DBUser.Grafana@10.10.10.11:5432/grafana # 主库直连 postgres://dbuser_grafana:DBUser.Grafana@10.10.10.11:5436/grafana # 直连default服务 postgres://dbuser_grafana:DBUser.Grafana@10.10.10.11:5433/grafana # 连接串读写服务 postgres://dbuser_grafana:DBUser.Grafana@10.10.10.12:5432/grafana # 主库直连 postgres://dbuser_grafana:DBUser.Grafana@10.10.10.12:5436/grafana # 直连default服务 postgres://dbuser_grafana:DBUser.Grafana@10.10.10.12:5433/grafana # 连接串读写服务 ``` 因为默认情况下 Pigsty 安装在 **单个元节点** 上，接下来的步骤我们会在已有的 `pg-meta` 数据库集群上创建 Grafana 所需的用户与数据库，而并非使用这里创建的 `pg-grafana` 集群。 -------- ## 创建Grafana业务用户 通常业务对象管理的惯例是：先创建用户，再创建数据库。 因为如果为数据库配置了 `owner`，数据库对相应的用户存在依赖。 ### 定义用户 要在 `pg-meta` 集群上创建用户 `dbuser_grafana`，首先将以下用户定义添加至 `pg-meta` 的 [集群定义](#定义集群) 中： 添加位置：`all.children.pg-meta.vars.pg_users` ```yaml - name: dbuser_grafana password: DBUser.Grafana comment: admin user for grafana database pgbouncer: true roles: [ dbrole_admin ] ``` > 如果您在这里定义了不同的密码，请在后续步骤中将相应参数替换为新密码 ### 创建用户 使用以下命令完成 `dbuser_grafana` 用户的创建（任一均可）。 ```bash bin/pgsql-user pg-meta dbuser_grafana # 在pg-meta集群上创建`dbuser_grafana`用户 ``` 实际上调用了 Ansible Playbook [`pgsql-user.yml`](/docs/pgsql/playbook#pgsql-useryml) 创建用户 ```bash ./pgsql-user.yml -l pg-meta -e pg_user=dbuser_grafana # Ansible ``` `dbrole_admin` 角色具有在数据库中执行 DDL 变更的权限，这正是 Grafana 所需要的。 -------- ## 创建Grafana业务数据库 ### 定义数据库 创建业务数据库的方式与业务用户一致，首先在 `pg-meta` 的集群定义中添加新数据库 `grafana` 的 [定义](#定义集群)。 添加位置：`all.children.pg-meta.vars.pg_databases` ```yaml - { name: grafana, owner: dbuser_grafana, revokeconn: true } ``` ### 创建数据库 使用以下命令完成 `grafana` 数据库的创建（任一均可）。 ```bash bin/pgsql-db pg-meta grafana # 在`pg-meta`集群上创建`grafana`数据库 ``` 实际上调用了 Ansible Playbook [`pgsql-db.yml`](/docs/pgsql/playbook#pgsql-dbyml) 创建数据库 ```bash ./pgsql-db.yml -l pg-meta -e pg_database=grafana # 实际执行的Ansible剧本 ``` -------- ## 使用Grafana业务数据库 ### 检查连接串可达性 您可以使用不同的 [服务](/docs/concept/ha/svc) 或 [接入](/docs/concept/sec/ac) 方式访问数据库，例如： ```bash postgres://dbuser_grafana:DBUser.Grafana@meta:5432/grafana # 直连 postgres://dbuser_grafana:DBUser.Grafana@meta:5436/grafana # default服务 postgres://dbuser_grafana:DBUser.Grafana@meta:5433/grafana # primary服务 ``` 这里，我们将使用通过负载均衡器直接访问主库的 [Default服务](/docs/pgsql/service#default服务) 访问数据库。 首先检查连接串是否可达，以及是否有权限执行 DDL 命令。 ```bash psql postgres://dbuser_grafana:DBUser.Grafana@meta:5436/grafana -c \ 'CREATE TABLE t(); DROP TABLE t;' ``` ### 直接修改Grafana配置 为了让 Grafana 使用 Postgres 数据源，您需要编辑 `/etc/grafana/grafana.ini`，并修改配置项： ```ini [database] ;type = sqlite3 ;host = 127.0.0.1:3306 ;name = grafana ;user = root # If the password contains # or ; you have to wrap it with triple quotes. Ex """#password;""" ;password = ;url = ``` 将默认的配置项修改为： ```ini [database] type = postgres url = postgres://dbuser_grafana:DBUser.Grafana@meta/grafana ``` 随后重启 Grafana 即可： ```bash systemctl restart grafana-server ``` 从监控系统中看到新增的 [`grafana`](http://g.pigsty.cc/d/pgsql-database/pgsql-database?var-cls=pg-meta&var-ins=pg-meta-1&var-datname=grafana&orgId=1) 数据库已经开始有活动，则说明 Grafana 已经开始使用 Postgres 作为首要后端数据库了。 但一个新的问题是，Grafana 中原有的 Dashboards 与 Datasources 都消失了！这里需要重新导入 [监控面板](#管理grafana监控面板) 与 [Postgres数据源](#管理postgres数据源) -------- ## 管理Grafana监控面板 您可以使用管理用户前往 Pigsty 目录下的 `files/grafana` 目录，执行 `grafana.py init` 重新加载 Pigsty 监控面板。 ```bash cd ~/pigsty/files/grafana ./grafana.py init # 使用当前目录下的Dashboards初始化Grafana监控面板 ``` 执行结果： ```bash vagrant@meta:~/pigsty/files/grafana $ ./grafana.py init Grafana API: admin:pigsty @ http://10.10.10.10:3000 init dashboard : home.json init folder pgcat init dashboard: pgcat / pgcat-table.json init dashboard: pgcat / pgcat-bloat.json init dashboard: pgcat / pgcat-query.json init folder pgsql init dashboard: pgsql / pgsql-replication.json init dashboard: pgsql / pgsql-table.json init dashboard: pgsql / pgsql-activity.json init dashboard: pgsql / pgsql-cluster.json init dashboard: pgsql / pgsql-node.json init dashboard: pgsql / pgsql-database.json init dashboard: pgsql / pgsql-xacts.json init dashboard: pgsql / pgsql-overview.json init dashboard: pgsql / pgsql-session.json init dashboard: pgsql / pgsql-tables.json init dashboard: pgsql / pgsql-instance.json init dashboard: pgsql / pgsql-queries.json init dashboard: pgsql / pgsql-alert.json init dashboard: pgsql / pgsql-service.json init dashboard: pgsql / pgsql-persist.json init dashboard: pgsql / pgsql-proxy.json init dashboard: pgsql / pgsql-query.json init folder pglog init dashboard: pglog / pglog-instance.json init dashboard: pglog / pglog-analysis.json init dashboard: pglog / pglog-session.json ``` 该脚本会通过 Grafana API 导入仪表盘。你可以使用环境变量显式指定 Grafana 访问参数： ```bash export GRAFANA_ENDPOINT=http://10.10.10.10:3000 export GRAFANA_USERNAME=admin export GRAFANA_PASSWORD=pigsty ``` 题外话，使用 `grafana.py clean` 会清空目标监控面板，使用 `grafana.py load` 会加载当前目录下所有监控面板，当 Pigsty 的监控面板发生变更，可以使用这两个命令升级所有的监控面板。 ## 管理Postgres数据源 当使用 [`pgsql.yml`](/docs/pgsql/playbook#pgsqlyml) 创建新 PostgreSQL 集群，或使用 [`pgsql-db.yml`](/docs/pgsql/playbook#pgsql-dbyml) 创建新业务数据库时，Pigsty 会在 Grafana 中注册新的 PostgreSQL 数据源，您可以使用默认的监控用户通过 Grafana 直接访问目标数据库实例。应用 `pgcat` 的绝大部分功能有赖于此。 要注册 Postgres 数据库数据源，可以使用 [`pgsql.yml`](/docs/pgsql/playbook#pgsqlyml) 中的 `add_ds` 任务（或使用更全面的 `pg_register`）： ```bash ./pgsql.yml -t add_ds # 重新注册当前环境中所有 PostgreSQL 数据源 ./pgsql.yml -t add_ds -l pg-test # 仅重新注册 pg-test 集群的数据源 ``` -------- ## 一步到位更新Grafana 您可以直接通过修改 Pigsty 配置文件，更改 Grafana 使用的后端数据源，一步到位的完成切换 Grafana 后端数据库的工作。编辑 `pigsty.yml` 中 [`grafana_pgurl`](/docs/infra/param#grafana_pgurl) 参数，将其修改为： ```yaml grafana_pgurl: postgres://dbuser_grafana:DBUser.Grafana@meta:5436/grafana ``` 然后重新执行 [`infra.yml`](/docs/infra/playbook#infrayml) 中的 `grafana` 任务，即可完成 Grafana 升级 ```bash ./infra.yml -t grafana ```