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.1）。

  • エディション: デプロイにインストールされている 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 使用率

このセクションでは、デプロイ全体の処理負荷をモニタリングします。この指標は、次の項目でグループ化できます。

  • ゾーン: 物理的なロケーション間の負荷の不均衡を特定します。

  • 優先度: 高、中、低の優先度のタスク間でリソースがどのように分割されているかを確認します。

  • オペレーション タイプ: 読み取り、書き込み、commit などのユーザーが開始したタスクごとに使用量を分類します。

レイテンシ

このセクションでは、オペレーションの速度を追跡します。

  • リクエストのレイテンシ: 個々の API リクエストにかかった時間。

  • トランザクション レイテンシ: データベース トランザクションの完了にかかる合計時間。

  • パーセンタイル: たとえば、パフォーマンスの中央値として 50 パーセンタイル（P50）を表示します。ただし、トラブルシューティングでは P90 または P99 の確認が必要になることがよくあります。

スループットとオペレーション

このセクションには次の情報が表示されます。

  • スループット: システムがデプロイに対して読み取りまたは書き込みを行うデータ量（1 秒あたりのバイト数で測定）。

  • 1 秒あたりのオペレーション数: システムが処理する 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 リソースの合計の割合。
実行回数 Spanner Omni コンソールがクエリを実行した合計回数。
Avg latency (ms) サーバー間のネットワーク時間を含む、クエリの完了に要した平均時間。
平均スキャン行数 Spanner Omni がクエリを処理するために読み取る行数の平均。スキャン対象と返されるデータの比率が高い場合は、インデックスが欠落しているか、効率が低いことを示していることがよくあります。
返された平均行数 Spanner Omni コンソールがアプリケーションに返す平均行数。
返されたバイト数 Spanner Omni コンソールが 1 回の実行で返すデータの平均量。