クライアントサイドの指標の説明

このページでは、Spanner が提供する各クライアントサイドの指標について詳しく説明します。クライアントサイドの指標の表示と管理について詳しくは、クライアントサイドの指標の表示と管理をご覧ください。

クライアントサイドの指標は、Spanner に対するクライアントの RPC リクエストの試行とオペレーションに関するレイテンシ情報を提供します。

試行とは、クライアントから Spanner への単一の RPC リクエストです。リクエストが失敗した場合、クライアントは複数回リクエストを試行できます。

オペレーションは、すべての RPC リクエストが完了したことを表します。これには、クライアントが Spanner に対して行ったすべての試行も含まれます。クライアントがレスポンスを受信するか、すべての試行を消費すると、オペレーションは完了します。

RPC リクエストは、Google フロントエンド（GFE）に到達してから Spanner API フロントエンド（AFE）に到達します。詳細については、Spanner リクエストのレイテンシ ポイントをご覧ください。

これらの指標には、DISTRIBUTION と INT64 型の指標値が含まれます。詳細については、値の型と指標の種類をご覧ください。

クライアントサイドの指標には、Java または Go 用の Spanner クライアント ライブラリを使用してアクセスできます。

クライアントサイドの指標では、google.spanner.v1.Spanner RPC API のすべての Spanner メソッドがサポートされています。

すべてのクライアントサイドの指標に、次のディメンションがあります。

  • project ID: Google Cloud プロジェクト ID。
  • instance ID: Spanner インスタンス ID。
  • database ID: Spanner データベース ID。
  • location: クライアントサイドの指標が公開される Google Cloud リージョン。アプリケーションが Google Cloudの外部にデプロイされている場合、指標は global リージョンにパブリッシュされます。
  • method: RPC メソッド名（例: spanner.commit）。
  • status: RPC ステータス（例: OK、INTERNAL）。
  • client_name: ライブラリの名前とバージョン（例: spanner-java/6.70.1）。

AFE 接続エラー数

AFE 接続エラー数の指標は、Spanner AFE に到達できなかった RPC リクエストの数を記録します。

AFE 接続エラー数の指標には次の属性があります。

  • Metric name: spanner.googleapis.com/client/afe_connectivity_error_count
  • Metric value type: INT64

AFE レイテンシ

AFE レイテンシの指標は、Spanner AFE がクライアントから RPC リクエストを受信してから、Spanner AFE がレスポンスの書き込みを開始するまでの時間を測定します。

AFE レイテンシの指標には次の属性があります。

  • Metric name: spanner.googleapis.com/client/afe_latencies
  • Metric value type: DISTRIBUTION

試行回数

試行回数の指標には、実行された試行回数が記録されます。通常、attempt_count 値は operation_count 値と同じです。クライアントが一時的なエラーを受け取った場合、attempt_count 値はすべての試行の合計になります。

試行回数の指標には次の属性があります。

  • Metric name: spanner.googleapis.com/client/attempt_count
  • Metric value type: INT64

試行レイテンシ

試行レイテンシ指標は、単一の RPC リクエストがクライアントから Spanner に到達するまでにかかる時間を測定します。通常、attempt_latencies 値は operation_latencies 値と同じです。クライアントが一時的なエラーを受け取った場合、operation_latencies 値はすべての attempt_latencies 値の合計になります。

試行レイテンシの指標には次の属性があります。

  • Metric name: spanner.googleapis.com/client/attempt_latencies
  • Metric value type: DISTRIBUTION

GFE 接続エラー数

GFE 接続エラー数の指標は、GFE に到達できなかった RPC リクエストの数を記録します。

GFE 接続エラー数の指標には次の属性があります。

  • Metric name: spanner.googleapis.com/client/gfe_connectivity_error_count
  • Metric value type: INT64

GFE レイテンシ

GFE レイテンシの指標は、GFE がクライアントから RPC リクエストを受信してから、GFE がレスポンスの最初のバイトを受信するまでの時間を測定します。この指標では、TCP/SSL handshake にかかる時間は考慮されません。

GFE レイテンシの指標には次の属性があります。

  • Metric name: spanner.googleapis.com/client/gfe_latencies
  • Metric value type: DISTRIBUTION

オペレーション数

オペレーション数の指標には、60 秒ごとに実行されたオペレーションの数が記録されます。

オペレーション数の指標には次の属性があります。

  • Metric name: spanner.googleapis.com/client/operation_count
  • Metric value type: INT64

オペレーション レイテンシ

オペレーション レイテンシの指標は、オペレーションがクライアントの gRPC レイヤから Spanner に到達し、再度クライアントに戻るまでのラウンド トリップ時間を測定します。

オペレーション レイテンシの指標には次の属性があります。

  • Metric name: spanner.googleapis.com/client/operation_latencies
  • Metric value type: DISTRIBUTION

次のステップ