モニタリングの概要

Spanner Omni でのモニタリングは、いくつかの例外を除き、Spanner でのモニタリングと同様に機能します。このドキュメントでは、これらの例外について説明し、Spanner モニタリング ドキュメントの関連情報を示します。Spanner のドキュメントを読む際は、このページに戻って Spanner Omni の違いを確認してください。

サポートされていない Spanner の機能

Spanner Omni は、エンドツーエンド トレースを除くすべての Spanner モニタリング機能をサポートしています。

テレメトリー シグナルをキャプチャする

パフォーマンス、使用状況、潜在的な問題に関する分析情報を取得するには、Spanner Omni データベースからシグナルをキャプチャします。

シグナル キャプチャの概要

テレメトリー シグナルは、データベースのパフォーマンスを把握するのに役立ちます。

Spanner Omni では、次のシグナルを使用できます。

シグナルタイプ 説明
指標 データベースの健全性またはパフォーマンスに関する数値データ。
ログ システム アクティビティを経時的に記録したもの。
トレース アプリケーションを通過するリクエストパス。
統計情報テーブル データベース情報をクエリするための組み込みテーブル。

Spanner Omni では、クライアントサイドの指標はサポートされていません。クライアントサイドの指標には、GFE 指標のレイテンシ、クライアントサイドの指標の収集、カスタム クライアントサイドの指標の収集が含まれます。詳細については、Spanner ドキュメントのシグナル キャプチャの概要をご覧ください。

トレース コレクション

トレースは、アプリケーション内を通過するリクエストのパスを表します。トレースを使用すると、リクエストのフローを追跡し、問題の根本原因を特定できます。たとえば、トレースでは、クライアントが RPC リクエストを送信した時点や受信した時点のタイムスタンプを含むスパンなど、クライアントからのリクエストごとに情報を提供できます。これにより、データベース リクエストのモニタリングとデバッグを行うことができます。

詳細については、Spanner ドキュメントのトレースの収集の概要をご覧ください。

OpenTelemetry を使用してトレースのコレクションを設定する

OpenTelemetry API を使用してトレースをエクスポートするように Spanner クライアント ライブラリを構成できます。このプロセスでは、OpenTelemetry SDK を構成し、エクスポータを使用してトレースデータをオブザーバビリティ バックエンドに送信します。

Spanner Omni では、クライアントサイド トレースは使用できません。

詳細については、Spanner ドキュメントの OpenTelemetry を使用してトレースの収集を設定するをご覧ください。

サーバー トレースをコレクタにエクスポートする

Spanner Omni サーバーは、独自のトレースを OTLP 形式でトレース コレクタ(Jaeger など)にエクスポートできます。コレクタを設定するには、次のいずれかを行います。

  • VM では、サーバーを起動する前に SPANNER_TRACE_EXPORTER_ENDPOINT 環境変数を設定します。詳細については、トレースを収集して分析するをご覧ください。

  • Kubernetes で、deployment.traceExporterEndpoint Helm 値を設定します。

    helm upgrade spanner-omni oci://us-docker.pkg.dev/spanner-omni/charts/spanner-omni \
        --version 2.0.0 \
        --namespace NAMESPACE \
        --reuse-values \
        --set deployment.traceExporterEndpoint=dns:///COLLECTOR_HOST:COLLECTOR_PORT
    

    monitoring.enabled=true を使用して Helm チャートをインストールし、deployment.traceExporterEndpoint を設定しない場合、サーバーは Helm チャートがインストールする Jaeger コレクタ(dns:///jaeger.monitoring.svc.cluster.local:4317)にトレースをエクスポートします。

トレースはホストから離れないため、サーバーは TLS を使用せずに Unix ドメイン ソケット エンドポイント(unix: または unix-abstract: で始まるターゲット)にトレースをエクスポートします。サーバーは、localhost のコレクタ、ループバック IP アドレス、別の Pod または Service、Kubernetes ノードの IP アドレス(DaemonSet コレクタの $HOST_IP:4317 など)を含む、他のすべてのコレクタをリモートとして扱います。

TLS 経由でトレースをエクスポートする

Spanner Omni リリース 2026.r4-lts.3 以降、TLS 暗号化を使用するデプロイのサーバーは、TLS 経由でのみリモート コレクタにトレースをエクスポートします。以前のリリースでは、トレースを平文でリモート コレクタにエクスポートし、TLS トレースのエクスポートはサポートしていません。トレースをリモート コレクタにエクスポートする手順は次のとおりです。

  1. トレース エクスポーター エンドポイントのコレクタ ホスト名に、トレース コレクタ CA(ca-otlp.crt)とコレクタ証明書を作成します。

  2. コレクタ証明書を使用して、コレクタの OTLP gRPC レシーバーで TLS を有効にします。次の例では、otlp-certs ディレクトリの collector.crt ファイルと collector.key ファイルを使用します。証明書を作成したディレクトリからコマンドを実行するか、otlp-certs をそのディレクトリのフルパスに置き換えます。

    • VM 上の Jaeger v1(jaeger-all-in-one)の場合:

      export COLLECTOR_OTLP_ENABLED=true
      export COLLECTOR_OTLP_GRPC_TLS_ENABLED=true
      export COLLECTOR_OTLP_GRPC_TLS_CERT=otlp-certs/collector.crt
      export COLLECTOR_OTLP_GRPC_TLS_KEY=otlp-certs/collector.key
      jaeger-all-in-one
      

      Jaeger v2 では、構成ファイルで TLS を構成します。詳細については、Jaeger のセキュリティ ドキュメントをご覧ください。

    • Helm チャートが monitoring.enabled=true でインストールする Jaeger コレクタの場合、monitoring Namespace に jaeger-tls という名前の TLS Secret を作成します。

      kubectl create secret tls jaeger-tls -n monitoring \
          --cert=otlp-certs/collector.crt --key=otlp-certs/collector.key
      

      Helm チャート バージョン 2.0.0 以降、Jaeger コレクタは、TLS 暗号化を使用したデプロイで、jaeger-tls シークレットを使用してデフォルトで TLS を提供します。これらのデプロイでは、deployment.traceExporterEndpoint を独自のコレクタに設定しない限り、シークレットが存在しないと helm install と helm upgrade が失敗します。別の名前の Secret を使用するには、monitoring.jaeger.tls.secretName を設定します。Jaeger は monitoring.jaeger.tls.reloadInterval(デフォルト: 1h)ごとに証明書を再読み込みするため、再起動せずに証明書をローテーションできます。

      Helm チャート バージョン 2.0.0 には、Spanner Omni リリース 2026.r4-lts.3 以降が必要です。以前のリリースでは、Helm チャート バージョン 1.x を使用します。

  3. 他の証明書と一緒に ca-otlp.crt をサーバーに配布します。

  4. サーバーを起動または再起動します。サーバーは、ca-otlp.crt が存在するかどうかに基づいて、起動時に TLS を使用するかどうかを決定します。そのため、ファイルの追加または削除は、再起動後にのみ有効になります。証明書のローテーションなど、既存のファイルへの変更は、再起動なしで有効になります。

    Kubernetes では、tls-certs Secret に鍵を追加してもサーバーは再起動されません。再起動するには、次のコマンドを実行します。

    kubectl rollout restart statefulset -n NAMESPACE \
        -l app.kubernetes.io/instance=spanner-omni
    

サーバーは、コレクタの証明書が ca-otlp.crt によって発行され、トレース エクスポータ エンドポイントのホスト名と一致することを確認します。サーバーはクライアント証明書を提示しないため、クライアント証明書を要求するようにコレクタを構成しないでください。ca-otlp.crt が存在する場合、サーバーは TLS 暗号化を使用しないデプロイでリモート コレクタに TLS を使用します。

ドロップされたトレースをモニタリングする

TLS 暗号化を使用したデプロイで、ca-otlp.crt が存在しない場合、サーバーはトレースをリモート コレクタにエクスポートしません。サーバーは、構成の修正方法を説明するレート制限の警告をログに記録し、opentelemetry_dropped_spans Prometheus 指標でドロップされたトレースをカウントします。reason ラベルは secure_mode に設定されます。

デプロイを作成する前に、サーバーはデプロイで TLS 暗号化が使用されているかどうかを判断できません。それまでは、ca-otlp.crt が存在しない場合、サーバーはトレースをリモート コレクタにエクスポートせず、reason ラベルを deployment_state_unavailable に設定してカウントします。

ca-otlp.crt が有効な CA 証明書でない場合、またはコレクタの証明書が ca-otlp.crt によって発行されていない場合、またはトレース エクスポータ エンドポイントのホスト名と一致しない場合、構成を修正するまでコレクタへの接続は失敗します。opentelemetry_dropped_spans 指標では、これらの失敗はカウントされません。これらを検出するには、サーバーログで TLS handshake とトレース エクスポートのエラーを確認します。ca-otlp.crt に PEM 証明書が含まれていない場合、サーバーは起動時に警告をログに記録します。

監査ログ

監査ログは、セキュリティとコンプライアンスのために管理上の変更とデータアクセス イベントを追跡します。監査ログを使用すると、処理時間のフィールドを参照してリクエストのレイテンシをモニタリングできます。詳細については、監査ログをご覧ください。

インスタンスをモニタリングする

インスタンスをモニタリングして、期待どおりに動作していることを確認し、潜在的な問題のトラブルシューティングに役立てます。

分析情報を使用してインスタンスのパフォーマンスをモニタリングする

システム分析情報ダッシュボードには、レイテンシ、CPU 使用率、ストレージ、スループットなどのパフォーマンス統計情報のグラフと指標が表示されます。このダッシュボードを使用して、Spanner Omni インスタンスとデータベースをモニタリングできます。詳細については、Spanner ドキュメントのシステム分析情報を使用してインスタンスをモニタリングするをご覧ください。

次のステップ