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 デプロイ内のすべてのデータベースの一元的なビューが表示されます。このページの表には、次の情報が表示されます。

列 説明
データベース名 データベースの一意の ID（retail、ycsbdb など）。
方言 データベースがサポートする SQL 言語:
  • GOOGLE_STANDARD_SQL: デフォルトの言語。Spanner の機能を完全にサポートします。
  • POSTGRESQL: PostgreSQL 互換のインターフェース。
CPU 使用率 データベースが消費する CPU リソースの割合。これにより、負荷の高いデータベースを特定できます。
Tables データベース内のユーザー定義テーブルの合計数。
バージョンの保持期間 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 秒あたりのオペレーション数: システムが処理する 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 コンソールが実行ごとに返すデータの平均量。