使用 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 控制台包含多個頁面,可提供部署作業的深入分析。

總覽

「Overview」(總覽) 頁面是 Spanner Omni 部署作業的中央資訊主頁。提供下列 Spanner 節點健康狀態、狀態和資源使用率的概略資訊:

部署作業資訊

這個部分會列出部署作業的詳細資料:

  • Deployment ID:目前 Spanner Omni 部署作業的專屬 ID。您會在建立部署作業時指定這個 ID。

  • 資料庫版本:您執行的 Spanner Omni 軟體特定版本 (例如 2026.r5)。

  • 版本:部署項目安裝的 Spanner Omni 授權版本。

  • 授權類型:部署作業安裝的授權類型。如要進一步瞭解 Spanner Omni 版本和授權類型,請參閱「Spanner Omni 版本總覽」。

  • 授權到期日:部署作業授權到期的日期。

Deployment 設定

  • CPU 使用率:即時圖表,顯示整個部署作業的處理負載。您可以在「Zone」(可用區) 和「Server」(伺服器) 之間切換,查看使用率。

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

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

資料庫

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

欄 說明
資料庫名稱 資料庫的專屬 ID (例如 retail、ycsbdb)。
方言 資料庫支援的 SQL 方言:
  • GOOGLE_STANDARD_SQL:預設方言,提供完整的 Spanner 功能支援。
  • POSTGRESQL:與 PostgreSQL 相容的介面。
CPU 使用率 資料庫耗用的 CPU 資源百分比。這有助於找出高負載資料庫。
Tables 資料庫中使用者定義的資料表總數。
版本保留期限 Spanner Omni 保留歷來資料的時間長度,以便進行時間點復原 (例如 1h)。

備份

「Backups」(備份) 頁面會完整顯示與 Spanner Omni 部署作業相關聯的所有備份。備份是資料庫的交易和外部一致性快照,Spanner Omni 會將其儲存在外部儲存空間解決方案中。

詳情請參閱「Spanner Omni 備份」。

備份儲存空間總計

「Total backup storage」(備份儲存空間總量) 專區會顯示儲存在外部儲存空間 (例如 Amazon Simple Storage Service (Amazon S3)、Cloud Storage 或與 Amazon S3 相容的本機儲存空間) 的所有備份累積大小。

備份資料表

備份表格會顯示各個備份的下列資訊:

欄 說明
備份名稱 備份的專屬 ID。
來源資料庫 Spanner Omni 控制台建立備份的資料庫名稱。
狀態 備份目前的狀態。常見狀態包括:
  • 就緒:備份已完成,可供還原。
  • 建立中:正在備份。
  • 即將到期:備份即將達到使用者指定的到期日。
備份大小 儲存空間中的備份資料大小。
建立時間 Spanner Omni 伺服器啟動備份程序的時間戳記。
快照時間 (或版本時間) 備份代表的時間點。備份中的所有資料都是資料庫在這個時間點的一致快照。
到期時間 Spanner Omni 刪除備份的日期和時間。

系統深入分析

「System Insights」頁面提供 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 負載的主要原因。

  • 識別:找出最耗用資源的特定查詢或應用程式要求標記。

  • 分析:使用延遲時間和資料列數等精細指標,瞭解查詢速度緩慢的原因。

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

「Database load by execution time」(資料庫負載 (根據執行時間)) 會顯示所有查詢在一段時間內的 CPU 匯總用量。如要顯示特定資料庫的負載,請使用資料庫篩選器。

前 N 個熱門查詢和標記

這個部分會以時間序列檢視畫面,呈現指定時間範圍內造成最多資料庫負載的查詢或標記。

熱門查詢和標記表格

表格會列出耗用量最高的查詢和標記。您可以使用這項功能,找出查詢工作負載中耗用最多資源的查詢。

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