location: 클라이언트 측 측정항목이 게시되는 Google Cloud 리전입니다. 애플리케이션이 Google Cloud외부에 배포되면 측정항목은 global 리전에 게시됩니다.
method: RPC 메서드 이름입니다(예: spanner.commit).
status: RPC 상태입니다(예: OK 또는 INTERNAL).
client_name: 라이브러리 이름 및 버전입니다. 예를 들면 spanner-java/6.70.1입니다.
시도 지연 시간
시도 지연 시간 측정항목은 단일 RPC 요청이 클라이언트에서 Spanner에 도달하는 데 걸리는 시간을 측정합니다.
attempt_latencies 값은 일반적으로 operation_latencies 값과 동일합니다. 클라이언트에서 일시적인 오류를 수신한 경우 operation_latencies 값은 모든 attempt_latencies 값의 합계입니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-06-03(UTC)"],[],[],null,["# Client-side metrics descriptions\n\nThis page provides a detailed\ndescription of each client-side metric that Spanner offers.\nFor more information about viewing and managing client-side metrics, see\n[View and manage client-side metrics](/spanner/docs/view-manage-client-side-metrics).\n\nClient-side metrics offer latency information about\nthe client's RPC request *attempts* and *operations* to\nSpanner.\n\nAn attempt is a single RPC request from the client to\nSpanner. The client can make multiple attempts if a request\nfails.\n\nAn operation represents completion of all RPC requests, including all\nthe attempts the client made to Spanner. An operation is\ncompleted when the client receives a response or exhausts all attempts.\n\nAn RPC request first reaches the Google frontend (GFE) and then the\nSpanner API frontend (AFE). For more information, see\n[Latency points in a Spanner request](/spanner/docs/latency-points).\n\nThese metrics include `DISTRIBUTION` and `INT64` metric value types. For\nmore information, see\n[Value types and metric kinds](/monitoring/api/v3/kinds-and-types).\n\nYou can access client-side metrics using the Spanner\nclient libraries for Java or Go.\n\nThe client-side metrics support all Spanner methods in\nthe [`google.spanner.v1.Spanner`](/spanner/docs/reference/rpc#google.spanner.v1.spanner)\nRPC API.\n\nAll client-side metrics have the following dimensions:\n\n- `project ID`: the Google Cloud project ID.\n- `instance ID`: the Spanner instance ID.\n- `database ID`: the Spanner database ID.\n- `location`: the Google Cloud region where the client-side metrics are published. If your application is deployed outside Google Cloud, then the metrics are published to the `global` region.\n- `method`: the RPC method name---for example, `spanner.commit`.\n- `status`: the RPC status---for example, `OK` or `INTERNAL`.\n- `client_name`: the library name and version---for example, `spanner-java/6.70.1`.\n\nAFE connectivity error count\n----------------------------\n\nThe AFE connectivity error count metric records the number of\nRPC requests that failed to reach the Spanner AFE.\n\nThe AFE connectivity error count metric has the following attributes:\n\n- `Metric name`: `spanner.googleapis.com/client/afe_connectivity_error_count`\n- `Metric value type`: `INT64`\n\nAFE latencies\n-------------\n\nThe AFE latencies metric measures the time in between the Spanner\nAFE receiving the RPC request from the client and Spanner AFE\nstarts writing the response.\n\nThe AFE latencies metric has the following attributes:\n\n- `Metric name`: `spanner.googleapis.com/client/afe_latencies`\n- `Metric value type`: `DISTRIBUTION`\n\nAttempt count\n-------------\n\nThe attempt count metric records the number of attempts performed. The\n`attempt_count` value is typically identical to the `operation_count` value.\nIf the client receives transient errors, the `attempt_count` value is the sum\nof all attempts.\n\nThe Attempt count metric has the following attributes:\n\n- `Metric name`: `spanner.googleapis.com/client/attempt_count`\n- `Metric value type`: `INT64`\n\nAttempt latencies\n-----------------\n\nThe attempt latencies metric measures the duration it takes for a single\nRPC request to reach Spanner from the client.\nThe `attempt_latencies` value is typically identical to the\n`operation_latencies` value. If the client receives transient errors, then the\n`operation_latencies` value is a sum of all the `attempt_latencies` values.\n\nThe Attempt latencies metric has the following attributes:\n\n- `Metric name`: `spanner.googleapis.com/client/attempt_latencies`\n- `Metric value type`: `DISTRIBUTION`\n\nGFE connectivity error count\n----------------------------\n\nThe GFE connectivity error count metric records the number of\nRPC requests that failed to reach the GFE.\n\nThe GFE connectivity error count metric has the following attributes:\n\n- `Metric name`: `spanner.googleapis.com/client/gfe_connectivity_error_count`\n- `Metric value type`: `INT64`\n\nGFE latencies\n-------------\n\nThe GFE latencies metric measures the time in between the GFE receiving the RPC\nrequest from the client and when the GFE receives the first byte of the\nresponse. This metric does not account for the time taken for any TCP/SSL\nhandshake.\n\nThe GFE latencies metric has the following attributes:\n\n- `Metric name`: `spanner.googleapis.com/client/gfe_latencies`\n- `Metric value type`: `DISTRIBUTION`\n\nOperation count\n---------------\n\nThe operation count metric records the number of operations performed every\n60 seconds.\n\nThe Operation count metric has the following attributes:\n\n- `Metric name`: `spanner.googleapis.com/client/operation_count`\n- `Metric value type`: `INT64`\n\nOperation latencies\n-------------------\n\nThe operation latencies metric measures an\noperation's round trip from the client [gRPC](https://grpc.io/) layer to\nSpanner and back to the client.\n\nThe Operation latencies metric has the following attributes:\n\n- `Metric name` : `spanner.googleapis.com/client/operation_latencies`\n- `Metric value type`: `DISTRIBUTION`\n\nWhat's next\n-----------\n\n- [Client metrics overview](/spanner/docs/view-manage-client-side-metrics)\n- [Signal capture overview](/spanner/docs/signal-capture-overview)"]]
