使用 Spanner Omni 控制台

Spanner Omni 包含 Spanner Omni 控制台，该控制台会显示部署的健康状况和其他重要信息。

启动 Spanner Omni 控制台

下载 Spanner Omni 控制台，为整个部署运行单个实例。如需了解详情，请参阅下载 Spanner Omni。

将 Spanner Omni 控制台与单服务器部署搭配使用

如需启动 Spanner Omni 控制台（采用单服务器部署），请执行以下操作：

1. 按照设置 Spanner Omni 中的步骤操作。

2. 运行 start-single-server 命令以启动 Spanner 服务器。

3. 启动 Spanner Omni 控制台。如果您使用的是容器，请运行以下命令：

   docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar /google/spanner/bin/spanner-console
   

   Spanner Omni 控制台使用的标志与 Spanner Omni CLI 使用的标志相同。

   • 如需使用 TLS 运行，请使用：

     docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar \
         /google/spanner/bin/spanner-console \
         --ca-certificate-file=PATH_TO_CA_FILE
     

   • 如需使用 mTLS 运行，请使用：

     docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar \
         /google/spanner/bin/spanner-console \
         --ca-certificate-file=PATH_TO_CA_FILE \
         --client-certificate-directory=PATH_TO_CLIENT_CERT_DIR
     

   替换以下内容：

   • PATH_TO_CA_FILE：证书授权机构 (CA) 证书文件的路径。
   • PATH_TO_CLIENT_CERT_DIR：客户端证书目录的路径。

4. 在浏览器中，前往 http://localhost:15026 以访问 Spanner Omni 控制台。

将 Spanner Omni 控制台与可用区级、区域级和多集群部署搭配使用

对于基于 Kubernetes 的部署，当您创建部署时，系统会部署 Spanner Omni 控制台。如需访问 Spanner Omni 控制台，请在浏览器中前往 http://HOST_ADDRESS:15026。

将 HOST_ADDRESS 替换为以下命令输出中 spanner-omni-console 的 EXTERNAL_IP：

kubectl get svc -n spanner-ns

Spanner Omni 控制台功能

Spanner Omni 控制台包含多个页面，可提供有关部署的分析。

概览

概览页面是 Spanner Omni 部署的中央信息中心。它提供有关 Spanner 节点的健康状况、状态和资源利用率的以下高级别信息：

部署信息

本部分列出了部署的详细信息：

• 部署 ID：当前 Spanner Omni 部署的唯一标识符。您可以在创建部署时指定此 ID。

• 数据库版本：您正在运行的 Spanner Omni 软件的具体版本（例如 2026.r4-lts）。

• 版本：部署中安装的 Spanner Omni 许可的版本。

• 许可类型：部署中安装的许可类型。如需详细了解 Spanner Omni 版本和许可类型，请参阅 Spanner Omni 版本概览。

• 许可到期日期：部署的许可到期日期。

部署配置

• CPU 利用率：实时图表，显示部署中的处理负载。您可以在区域和服务器之间切换，以查看利用率。

• 资源表：提供部署中组件的详细视图，其中包含以下信息。服务器按可用区分组。

  列	说明
  资源名称	可用区或特定 Spanner Omni 服务器节点的名称。
  类型	可用区：显示可用区的类型（例如，读写、只读或见证）。 Spanner Omni 服务器：运行 Spanner Omni 服务的各个节点。Spanner Omni 控制台专门用于识别根服务器。
  状态	指示资源是否处于健康状态（例如 Ready）。
  位置	托管可用区的物理区域或逻辑区域（例如 us-central1）。
  vCPU、内存、已用存储空间	每个节点和可用区的当前资源分配和利用率。

数据库

数据库页面集中显示了 Spanner Omni 部署中的所有数据库。此页面上的表格包含以下信息：

列	说明
数据库名称	数据库的唯一标识符（例如 retail、ycsbdb）。
方言	数据库支持的 SQL 方言： GOOGLE_STANDARD_SQL：默认方言，提供全面的 Spanner 功能支持。 POSTGRESQL：与 PostgreSQL 兼容的接口。
CPU 利用率	数据库消耗的 CPU 资源百分比。这有助于您识别高负载数据库。
表	数据库中用户定义的表的总数。
版本保留期限	Spanner Omni 为时间点恢复保留历史数据的时长（例如 1h）。

备份

备份页面全面展示了与您的 Spanner Omni 部署相关联的所有备份。备份是数据库的事务一致性快照和外部一致性快照，由 Spanner Omni 存储在外部存储解决方案中。

如需了解详情，请参阅 Spanner Omni 备份。

总备份存储空间

备份总存储空间部分会显示您存储在外部存储空间（例如 Amazon Simple Storage Service (Amazon S3)、Cloud Storage 或与 Amazon S3 兼容的本地存储空间）中的所有备份的累计大小。

备份表

备份表会显示每个备份的以下信息：

列	说明
备份名称	备份的唯一标识符。
源数据库	Spanner Omni 控制台创建备份时所依据的数据库的名称。
状态	备份的当前状态。常见状态包括： 就绪：备份已完成，可用于恢复。 正在创建：正在进行备份。 即将失效：备份即将达到用户指定的失效日期。
备份大小	存储空间中备份数据的大小。
创建时间	Spanner Omni 服务器启动备份进程的时间戳。
快照时间（或版本时间）	备份所代表的时间点。备份中的所有数据都是数据库在这一时刻的一致快照。
到期时间	Spanner Omni 删除备份的日期和时间。

系统数据分析

系统分析洞见页面可为您的 Spanner Omni 部署提供精细的可观测性，让您能够监控系统健康状况、分析性能和调试问题。

您可以使用以下过滤条件自定义信息中心内显示的数据：

• 可用区：过滤特定部署可用区的指标。

• 服务器：深入查看各个服务器节点。

• 数据库：查看特定数据库或整个部署的指标。

• 时间范围：选择 1 小时到 7 天的回溯期。

CPU 利用率

此部分用于监控整个部署的处理负载。您可以按以下条件对此指标进行分组：

• 可用区：识别物理位置之间的负载不平衡情况。

• 优先级：查看资源在高优先级、中优先级和低优先级任务之间的分配情况。

• 操作类型：按用户启动的任务（例如读取、写入和提交）细分使用情况。

延迟时间

此部分会跟踪您的操作速度：

• 请求延迟时间：单个 API 请求所用的时间。

• 事务延迟时间：完成数据库事务的总时间。

• 百分位：例如，查看第 50 百分位 (P50) 的数据，了解中位效果。不过，问题排查通常需要检查 P90 或 P99。

吞吐量和运营

此部分展示以下信息：

• 吞吐量：系统从部署读取或写入部署的数据量（以每秒字节数为单位）。

• 每秒操作次数：系统处理的 API 调用总数。

锁定等待时间

此指标用于衡量事务等待锁的累计时间。此指标出现峰值（尤其是与高延迟和正常 CPU 使用率同时出现时）通常表示存在锁争用。

存储空间指标

• 存储容量：底层文件系统的总存储空间和可用存储空间，Spanner Omni 控制台会按可用区对这些空间进行分组。

• 存储空间利用率：数据库使用的字节数。Spanner Omni 数据压缩流程可能会导致这些数字出现暂时性波动。

文件系统性能

本部分深入分析了底层存储层 (SpanhostFS) 的性能：

• 文件系统延迟时间：低级 I/O 操作（读取、写入和刷新）所用的时间。

• 文件系统吞吐量：文件系统级别的数据传输速率。

Query Insights

Query Insights 页面可帮助您检测和诊断 SQL 查询和 DML（INSERT、UPDATE 和 DELETE）语句的性能问题。使用 Query Insights 识别可能导致高 CPU 利用率的低效查询。

• 检测：确定查询是否是部署 CPU 负载过高的主要原因。

• 识别：准确找出最消耗资源的特定查询或应用请求标记。

• 分析：使用延迟时间和行数等精细指标来了解查询速度可能较慢的原因。

数据库负载（按执行时间）（所有查询）

数据库负载（按执行时间）显示了所有查询在一段时间内的 CPU 总使用率。如需显示特定数据库的负载，请使用数据库过滤条件。

排名前 N 的查询和标记

此部分提供了一个时间序列视图，用于显示所选时间范围内导致数据库负载最高的查询或标记。

热门查询和标记表

该表格会列出消耗资源最多的查询和标记。您可以使用此功能来确定查询工作负载中最消耗资源的查询。

列	说明
指纹	特定查询“形状”的唯一标识符。
查询或请求标记	查询的标准化 SQL 文本。如果您的应用在查询选项中提供了请求标记，Spanner Omni 控制台会显示该标记，以便您对相关查询进行分组（例如 checkout_process）。
查询类型	操作的类型（例如 QUERY）。
CPU (%)	相应时间段内，相应查询消耗的数据库 CPU 资源占总数据库 CPU 资源的百分比。
执行次数	Spanner Omni 控制台执行查询的总次数。
平均延迟时间（毫秒）	完成查询所用的平均时间，包括服务器之间的网络时间。
扫描的平均行数	Spanner Omni 为处理查询而读取的平均行数。扫描与返回的比率较高通常表示缺少索引或索引效率低下。
返回的平均行数	Spanner Omni 控制台发送回应用的平均行数。
返回的字节数	Spanner Omni 控制台每次执行返回的平均数据量。