클라이언트 측 측정항목 설명

이 페이지에서는 Spanner에서 제공하는 각 클라이언트 측 측정항목을 자세히 설명합니다. 클라이언트 측 측정항목 보기 및 관리에 대한 자세한 내용은 클라이언트 측 측정항목 보기 및 관리를 참조하세요.

클라이언트 측 측정항목은 클라이언트의 Spanner에 대한 RPC 요청 시도 및 작업에 관한 지연 시간 정보를 제공합니다.

시도는 클라이언트에서 Spanner로 전송되는 단일 RPC 요청입니다. 요청이 실패하면 클라이언트가 여러 번 시도할 수 있습니다.

작업은 클라이언트가 Spanner에 수행한 모든 시도를 포함하여 모든 RPC 요청 완료를 나타냅니다. 클라이언트에서 응답을 수신하거나 모든 시도를 소진하면 작업이 완료됩니다.

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 핸드셰이크에 걸린 시간을 고려하지 않습니다.

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

다음 단계