클라이언트 측 측정항목 보기 및 관리

이 페이지에서는 클라이언트 측 측정항목을 보고 관리하는 방법을 설명합니다. 클라이언트 측 측정항목은 클라이언트의 Spanner RPC 요청에 관한 지연 시간 정보를 제공합니다.

Spanner는 서버 측 측정항목과 함께 사용할 수 있는 클라이언트 측 측정항목을 제공하므로 성능을 최적화하고 성능 문제가 발생할 경우 해결할 수 있습니다.

클라이언트 측 측정항목은 요청이 애플리케이션에서 전송되는 시간부터 애플리케이션에서 응답을 수신한 시간까지 측정됩니다. 반면에 서버 측 측정항목은 Spanner에서 요청을 수신한 시간부터 마지막 데이터 바이트가 클라이언트에 전송될 때까지 측정됩니다.

클라이언트 측 측정항목 액세스

다음 클라이언트 라이브러리에서 클라이언트 측 측정항목을 사용할 수 있습니다.

  • 버전 6.81.0 이상의 Java
  • Go 버전 1.71.0 이상

Cloud Monitoring API를 사용 설정한 후 클라이언트 측 측정항목을 사용할 수 있습니다.

Monitoring API 사용 설정

클라이언트 측 측정항목은 Identity and Access Management (IAM) monitoring.timeSeries.create 권한이 부여된 사용자 또는 서비스 계정에서 사용할 수 있습니다. 이 권한은 다음 Spanner IAM 역할에 포함되어 있습니다.

역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할을 통해 필요한 monitoring.timeSeries.create IAM 권한을 얻을 수도 있습니다.

측정항목 탐색기에서 측정항목 보기

  1. Google Cloud 콘솔에서 측정항목 탐색기 페이지로 이동합니다.

    측정항목 탐색기로 이동

  2. 프로젝트를 선택합니다.

  3. 측정항목 선택을 클릭합니다.

  4. spanner.googleapis.com/client을 검색합니다.

  5. 측정항목을 선택한 다음 적용을 클릭합니다.

측정항목 그룹화 또는 집계에 관한 자세한 내용은 메뉴를 사용하여 쿼리 빌드를 참고하세요.

게시된 측정항목을 보려면 애플리케이션이 최소 1분 동안 실행되어야 합니다.

클라이언트 측 측정항목 선택 해제

이미 OpenTelemetry를 사용하여 맞춤 클라이언트 측정항목을 캡처하고 있다면 다음 코드를 사용하여 클라이언트 측 측정항목 사용을 선택 해제할 수 있습니다.

자바

Spanner spanner =
  SpannerOptions.newBuilder()
    .setProjectId("test-project")
    .setBuiltInMetricsEnabled(false)
    .build()
    .getService();

Go

    client, err := spanner.NewClientWithConfig(ctx, database, spanner.ClientConfig{
    DisableNativeMetrics: true,
    })

비용

Cloud Monitoring에서 클라이언트 측 측정항목 보기는 무료입니다. Monitoring API를 사용하면 요금이 청구될 수 있습니다. 자세한 내용은 Google Cloud Observability 가격 책정을 참고하세요.

다음 단계