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

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

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

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

시작하기 전에

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

    Monitoring API 사용 설정

  2. 클라이언트 측 측정항목에 액세스하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Monitoring 측정항목 작성자 (roles/monitoring.metricWriter) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

    이 사전 정의된 역할에는 클라이언트 측 측정항목에 액세스하는 데 필요한 monitoring.timeSeries.create 권한이 포함되어 있습니다.

    커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

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

다음 클라이언트 라이브러리를 사용하여 클라이언트 측 측정항목에 액세스할 수 있습니다.

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

측정항목 탐색기에서 클라이언트 측 측정항목을 보려면 다음 단계를 따르세요.

  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 가격 책정을 참조하세요.

다음 단계