Spanner リクエストのレイテンシ ポイント

このページでは、Spanner リクエストに関わる上位コンポーネントの概要と、各コンポーネントがレイテンシに与える影響について説明します。

Spanner API リクエスト

Spanner API リクエストの作成に使用される上位コンポーネントは、次のとおりです。

  • Spanner クライアント ライブラリ。gRPC の上に抽象化レイヤを提供し、セッション管理、トランザクション、再試行などのサーバー通信の詳細を処理します。

  • Google Front End（GFE）。Spanner を含むすべての Google Cloud サービスに共通のインフラストラクチャ サービスです。GFE は、すべての Transport Layer Security（TLS）接続が停止していることを確認し、サービス拒否攻撃に対する保護を適用します。GFE の詳細については、Google Front End サービスをご覧ください。

  • Cloud Spanner API フロントエンド（AFE）。API リクエストに対してさまざまなチェック（認証、認可、割り当てチェック）が実施され、セッションとトランザクションの状態が維持されます。

  • Spanner データベース。データベースに対する読み取りと書き込みを実行します。

Spanner にリモート プロシージャ コールを行うと、Spanner クライアント ライブラリによって API リクエストが準備されます。次に、API リクエストは Spanner データベースに到達する前に、GFE と Spanner AFE の両方を通過します。

さまざまなコンポーネントとデータベース間のリクエストのレイテンシを測定し、比較することで、問題の原因となっているコンポーネントを特定できます。これらのレイテンシには、クライアントのエンドツーエンド、GFE、Spanner API リクエスト、クエリのレイテンシが含まれます。

Spanner のアーキテクチャ図。

以降のセクションでは、前の図で示した各種類のレイテンシについて説明します。

エンドツーエンドのレイテンシ

エンドツーエンドのレイテンシは、クライアントが GFE と Spanner API フロントエンドの両方からデータベースに送信する Spanner API リクエストの最初のバイトと、クライアントがデータベースから受信したレスポンスの最後のバイトの間の時間（ミリ秒単位）です。

エンドツーエンドのレイテンシの Spanner アーキテクチャ図。

spanner.googleapis.com/client/operation_latencies 指標は、送信された API リクエストの最初のバイトから受信されたレスポンスの最後のバイトまでの時間を表します。これには、クライアント ライブラリによって実行された再試行が含まれます。

詳細については、クライアントサイドの指標の表示と管理をご覧ください。

GFE レイテンシ

Google Front End（GFE）レイテンシは、Google ネットワークがクライアントからリモート プロシージャ コールを受信してから、GFE がレスポンスの最初のバイトを受信するまでの時間（ミリ秒単位）です。このレイテンシには TCP/SSL handshake は含まれません。

GFE レイテンシの Spanner アーキテクチャ図。

Spanner からのすべてのレスポンス（REST または gRPC）には、リクエストとレスポンスの両方に対する GFE とバックエンド（Spanner サービス）間の合計時間を示すヘッダーが含まれています。これは、クライアントと GFE 間のレイテンシの原因の特定に役立ちます。

spanner.googleapis.com/client/gfe_latencies 指標によって、Spanner リクエストに対する GFE レイテンシがキャプチャされ公開されます。

詳細については、クライアントサイドの指標の表示と管理をご覧ください。

Spanner API リクエストのレイテンシ

Spanner API リクエストのレイテンシは、Spanner AFE がリクエストの最初のバイトを受信してから、Spanner API フロントエンドがレスポンスの最後のバイトを送信するまでの時間（秒単位）です。レイテンシには、Spanner バックエンドと API レイヤの両方で API リクエストの処理に必要な時間が含まれます。ただし、このレイテンシには、Spanner クライアントとサーバーの間のネットワークやリバース プロキシのオーバーヘッドは含まれません。

Spanner API リクエストのレイテンシの Spanner アーキテクチャ図。

spanner.googleapis.com/api/request_latencies 指標によって、Spanner リクエストに対する Spanner AFE レイテンシがキャプチャされ公開されます。詳細については、Spanner の指標をご覧ください。

クエリのレイテンシ

このクエリのレイテンシは、Spanner データベースで SQL クエリを実行するのにかかる時間の長さ（ミリ秒単位）です。

クエリのレイテンシの Spanner アーキテクチャ図。

クエリのレイテンシは executeSql API で使用できます。

QueryMode パラメータを WITH_STATS または WITH_PLAN_AND_STATS に設定すると、Spanner の ResultSetStats をレスポンスで使用できます。ResultSetStats には、Spanner データベースでのクエリの実行時間も含まれます。

クエリのレイテンシをキャプチャして可視化するには、OpenTelemetry を使用してクエリのレイテンシをキャプチャするをご覧ください。

次のステップ