使用 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.r5）。

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

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

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

Deployment 配置

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

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

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

数据库

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

备份

备份页面提供了与 Spanner Omni 部署关联的所有备份的全面视图。备份是数据库的事务一致性和外部一致性快照，Spanner Omni 会将其存储在外部存储解决方案中。

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

总备份存储空间

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

备份表

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

系统数据分析

System Insights 页面为 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 的查询和标记

此部分提供在所选时段内产生最多数据库负载的查询或标记的时序视图。

热门查询和标记表

该表格会列出消耗量最大的查询和标记。您可以使用此功能来识别查询工作负载中资源密集度最高的查询。