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

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

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

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

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

이러한 측정항목에는 DISTRIBUTION 및 INT64 측정항목 값 유형이 포함됩니다. 자세한 내용은 값 유형 및 측정항목 종류를 참고하세요.

클라이언트 측 측정항목은 Java 또는 Go용 Spanner 클라이언트 라이브러리를 사용할 때 사용 가능합니다.

클라이언트 측 측정항목은 google.spanner.v1.Spanner RPC API에서 사용할 수 있는 모든 Spanner 메서드를 지원합니다.

작업 지연 시간

작업 지연 시간 측정항목은 클라이언트 gRPC 레이어에서 Spanner로, 다시 클라이언트로의 작업 왕복을 측정합니다.

이 측정항목에는 다음과 같은 속성이 있습니다.

  • Metric name: spanner.googleapis.com/client/operation_latencies
  • Metric value type: DISTRIBUTION
  • 사용 가능한 측정기준:
    • 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).

작업 수

작업 수 측정항목은 실행된 작업 수를 기록합니다.

이 측정항목에는 다음과 같은 속성이 있습니다.

  • Metric name: spanner.googleapis.com/client/operation_count
  • Metric value type: INT64
  • 사용 가능한 측정기준:
    • 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입니다.

시도 지연 시간

시도 지연 시간 측정항목은 단일 RPC 요청이 클라이언트에서 Spanner에 도달하는 데 걸리는 시간을 측정합니다. attempt_latencies 값은 일반적으로 operation_latencies 값과 동일합니다. 클라이언트에서 일시적인 오류를 수신한 경우 operation_latencies 값은 모든 attempt_latencies 값의 합계입니다.

이 측정항목에는 다음과 같은 속성이 있습니다.

  • Metric name: spanner.googleapis.com/client/attempt_latencies
  • Metric value type: DISTRIBUTION
  • 사용 가능한 측정기준:
    • 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입니다.

시도 횟수

시도 횟수 측정항목은 수행된 시도 횟수를 기록합니다. attempt_count 값은 일반적으로 operation_count 값과 동일합니다. 클라이언트에서 일시적인 오류를 수신한 경우 attempt_count 값은 모든 시도의 합계입니다.

이 측정항목에는 다음과 같은 속성이 있습니다.

  • Metric name: spanner.googleapis.com/client/attempt_count
  • Metric value type: INT64
  • 사용 가능한 측정기준:
    • 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입니다.

다음 단계