Spanner Omni コンソールを使用する

プレビュー

このプロダクトまたは機能はプレビュー版であり、サービス固有規約の 一般サービス規約 セクションの「pre-GA サービス規約」の対象となります。ソフトウェア プログラムの開発、 テスト、プロトタイピング、デモンストレーションのみを目的として使用できます。データ 処理や商用目的で使用することはできません。pre-GA のプロダクトと機能は「現状のまま」利用できますが、 サポートが制限されることがあります。詳細については、 リリース ステージ の説明をご覧ください。

Spanner Omni には、デプロイの健全性やその他の重要な情報を表示する Spanner Omni コンソールが含まれています。

Spanner Omni コンソールは、 プレビュー版の Spanner Omni を実行している暗号化されていないデプロイをサポートしています。TLS 暗号化を使用してデプロイを作成できる機能を入手するには、Google にお問い合わせのうえ、Spanner Omni のフルバージョンへの早期アクセスをリクエストしてください。TLS 暗号化を使用するデプロイの場合は、Prometheus アラートと Grafanaダッシュボードを使用してデプロイをモニタリングします。

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 /app/bin/spanner-console
   

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.r1-beta）。

デプロイ構成

• 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 Deployment の詳細なオブザーバビリティを提供します。これにより、システムの健全性をモニタリングし、パフォーマンスを分析して、問題をデバッグできます。

ダッシュボードに表示されるデータは、次のフィルタでカスタマイズできます。

• ゾーン: 特定のデプロイ ゾーンの指標をフィルタします。

• サーバー: 個々のサーバーノードをドリルダウンします。

• データベース: 特定のデータベースまたはデプロイ全体の指標を表示します。

• 期間: 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 コンソールが実行ごとに返すデータの平均量。