连接到 Web 界面

选择文档版本： 18.4.0

• 18.3.0
• 18.1.0

本页面介绍了如何连接到 AlloyDB Omni Web 界面，以便监控数据库集群。

在开始之前，请务必执行以下操作：

• 安装 Web 界面。
• 在数据库实例上配置 alloydbui 数据库用户密码。如需了解详情，请参阅配置数据库用户。
• 准备好数据库集群和 Prometheus 端点。

配置数据库连接

Web 界面提供集群选择视图，可让您添加和配置多个 AlloyDB Omni 数据库实例。

如需配置新的数据库连接，请执行以下操作：

1. 在 http://HOST:9080（或您配置的自定义基本路径）打开 Web 界面。
2. 点击添加集群连接。
3. 根据以下参数参考信息输入连接设置：

设置	说明
集群名称	一个人类可读的显示标签，用于在界面中标识目标数据库实例。
集群主机名（或 IP 地址）	AlloyDB Omni 集群运行的位置。对于高可用性 (HA) 设置，请指定代理主机；否则，请指定主实例主机。注意：主机名或 IP 必须可供 Web 界面容器访问，而不是您访问 Web 界面的机器。
集群端口	数据库监听连接的端口。默认值为 5432。
alloydbui 个密码	为 alloydbui 用户创建的密码，如配置数据库用户中所述。
Prometheus 主机名（或 IP 地址）	Prometheus 的运行位置。此地址必须可供 Web 界面访问，但不一定是用户的工作站。
Prometheus 端口	Prometheus 服务监听连接的端口。默认值为 9090。

排查数据库身份验证和权限问题

如果 Web 界面无法连接或显示集群数据，您可以使用 psql 客户端验证 alloydbui 监控角色是否可以对数据库进行身份验证和查询。

注意： 使用 docker exec、podman exec 或 kubectl exec 在数据库容器或 Pod 中运行 psql 可验证 alloydbui 凭据和权限。如需同时验证从 Web 界面到数据库的网络可达性，请直接从安装了 Web 界面的主机或容器环境运行 psql。

如需使用数据库容器内的容器化 psql 客户端验证 alloydbui 凭证和权限，请根据容器运行时运行以下命令之一：

Docker

docker exec -it CONTAINER_NAME psql -h DB_HOST -U alloydbui -d postgres

Podman

podman exec -it CONTAINER_NAME psql -h DB_HOST -U alloydbui -d postgres

替换以下内容：

• CONTAINER_NAME：AlloyDB Omni 容器的名称。
• DB_HOST：数据库实例的主机名或 IP 地址，例如 localhost、IP 地址或 DNS 主机名。

选择现有连接

配置集群连接后，后续界面会话可让您选择已保存的连接详细信息，而无需重新输入配置。

管理连接数据

本部分介绍了 Web 界面如何存储、删除和传输连接数据。

连接数据的存储

Web 界面会将连接数据存储在启动 Web 界面的用户账号的 .config/alloydb-omni-ui 目录中。Web 界面使用 256 位 AES 密钥加密连接数据。您在启动应用时在 ALLOYDB_OMNI_UI_KEYSTORE 环境变量中指定的密码可保护密钥。

删除连接数据

通过移除 .config/alloydb-omni-ui 目录中的 .dat 文件来删除连接数据。

连接数据的可移植性

您可以将连接数据文件从 .config/alloydb-omni-ui 目录复制到运行 Web 界面的另一台设备。您必须使用 ALLOYDB_OMNI_UI_KEYSTORE 环境变量的相同值启动应用。