使用 Spanner Omni 控制台

Spanner Omni 包含 Spanner Omni 控制台，可顯示部署作業的健康狀態和其他重要資訊。

Spanner Omni 控制台支援執行 Spanner Omni Preview 版的未加密部署作業。如要取得可建立採用 TLS 加密部署作業的功能，請與 Google 聯絡，要求搶先體驗完整版 Spanner Omni。對於使用 TLS 加密的部署作業，請使用 Prometheus 快訊和 Grafana 資訊主頁監控部署作業。

啟動 Spanner Omni 控制台

下載 Spanner Omni 控制台，為整個部署作業執行單一執行個體。詳情請參閱「下載 Spanner Omni」。

搭配單一伺服器部署作業使用 Spanner Omni 控制台

如要使用單一伺服器部署作業啟動 Spanner Omni 控制台，請按照下列步驟操作：

按照「設定 Spanner Omni」中的步驟操作。
執行 start-single-server 指令來啟動 Spanner 伺服器。
啟動 Spanner Omni 控制台。如果您使用容器，請執行下列指令：
```
docker exec -it spanneromni /app/bin/spanner-console
```
在瀏覽器中前往 http://localhost:15026，存取 Spanner Omni 控制台。

搭配區域、地區和多叢集部署作業使用 Spanner Omni 控制台

如果是以 Kubernetes 為基礎的部署作業，建立部署作業時，系統會部署 Spanner Omni 控制台。如要存取 Spanner Omni 控制台，請在瀏覽器中前往 http://HOST_ADDRESS:15026。

將 HOST_ADDRESS 替換為以下指令輸出內容中的 EXTERNAL_IP spanner-omni-console：

kubectl get svc -n spanner-ns

Spanner Omni 控制台功能

Spanner Omni 控制台包含多個頁面，可提供部署作業的洞察資料。

總覽

「總覽」頁面是 Spanner Omni 部署作業的中央資訊主頁。這項工具會提供 Spanner 節點的健康狀態、狀態和資源用量等高階資訊：

部署作業資訊

本節列出部署作業的主要 ID：

部署 ID：目前 Spanner Omni 部署作業的專屬 ID。建立部署作業時，請指定這個 ID。
資料庫版本：您執行的 Spanner Omni 軟體特定版本 (例如 2026.r1-beta)。

Deployment 設定

CPU 使用率：即時圖表，顯示部署作業的處理負載。你可以切換「區域」和「伺服器」，查看使用率。

資源表：提供部署作業中元件的詳細檢視畫面，包括下列資訊。伺服器會依可用區分組。

欄	說明
資源名稱	可用區或特定 Spanner Omni 伺服器節點的名稱。
類型	區域：顯示區域類型 (例如讀寫、唯讀或見證)。 Spanner Omni 伺服器：執行 Spanner Omni 服務的個別節點。Spanner Omni 控制台會特別識別根伺服器。
狀態	指出資源是否正常運作 (例如 `Ready`)。
位置	託管可用區的實體或邏輯區域 (例如 `us-central1`)。
vCPU、記憶體、儲存空間用量	每個節點和可用區目前的資源分配和用量。

資料庫

「資料庫」頁面會集中顯示 Spanner Omni 部署作業中的所有資料庫。這個頁面的表格包含下列資訊：

欄	說明
資料庫名稱	資料庫的專屬 ID (例如 `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 相容的本機儲存空間。

備份表格

備份表格會顯示每個備份的下列資訊：

欄	說明
備份名稱	備份的專屬 ID。
來源資料庫	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 作業 (讀取、寫入和排清) 所需的時間。
檔案系統處理量：檔案系統層級的資料移轉速率。

查詢洞察

「查詢洞察」頁面可協助您偵測及診斷 SQL 查詢和 DML (INSERT、UPDATE 和 DELETE) 陳述式的效能問題。使用查詢洞察找出效率不彰的查詢，這類查詢可能會導致 CPU 使用率偏高。

偵測：判斷查詢是否為部署作業 CPU 負載的主要原因。
識別：找出最耗用資源的特定查詢或應用程式請求代碼。
分析：使用延遲時間和資料列計數等精細指標，瞭解查詢速度緩慢的原因。

資料庫負載 (根據執行時間) - 所有查詢

「資料庫負載 (根據執行時間)」會顯示所有查詢的 CPU 總用量。如要顯示特定資料庫的負載，請使用資料庫篩選器。

前 N 個熱門查詢和標記

本節提供時間序列檢視畫面，顯示在所選時間範圍內，造成最多資料庫負載的查詢或標記。

欄	說明
指紋	特定查詢「形狀」的專屬 ID。
「查詢」或「要求」標記	查詢的正規化 SQL 文字。如果應用程式在查詢選項中提供要求標記，Spanner Omni 控制台會改為顯示該標記，方便您將相關查詢分組 (例如 `checkout_process`)。
查詢類型	作業類型 (例如 `QUERY`)。
CPU (%)	查詢在間隔期間消耗的資料庫 CPU 資源總量百分比。
執行次數	Spanner Omni 控制台執行查詢的總次數。
平均延遲時間 (毫秒)	完成查詢的平均時間，包括伺服器之間的網路時間。
平均掃描列數	Spanner Omni 處理查詢時讀取的平均資料列數。如果掃描與傳回的比率偏高，通常表示索引遺失或效率不彰。
平均傳回列數	Spanner Omni 控制台傳回應用程式的平均資料列數。
傳回的位元組數	Spanner Omni 控制台每次執行作業時傳回的平均資料量。