할당량 측정항목 사용

이 페이지에서는 할당량 사용을 모니터링하거나 표시할 알림 정책 및 차트를 만드는 방법을 설명합니다. 할당량 및 요금 할당량에 대한 정보를 비롯하여 할당량에 대한 일반적인 정보는 할당량 작업을 참조하세요.

이 페이지의 모든 알림 정책 및 차트에서 모니터링되는 리소스는 consumer_quota입니다. 이 리소스의 측정항목은 serviceruntime 측정항목 하위 집합입니다.

  • 게이지, 델타, 누적이라는 용어의 정의는 측정항목의 종류를 참조하세요.
  • 시계열 결합에 사용되는 필드에 대한 자세한 내용은 AlignerReducer를 참조하세요.

소비자 할당량 이해

특정 할당량의 할당량 사용량을 보려면 quota_metric 특정 라벨 값으로 시계열을 필터링해야 합니다. 이 섹션의 예시에서는 시계열 데이터를 확인하여 이 라벨의 올바른 값을 식별하는 방법을 보여줍니다. 특정 API 할당량에 대해 이 라벨의 값을 확인하려면 다음 절차를 따르세요.

  1. Google Cloud Console에서 ID 및 액세스 관리 할당량 페이지로 이동합니다.

    할당량으로 이동

  2. 원하는 할당량을 찾은 다음 모든 할당량을 클릭합니다.

  3. 서비스가 할당량 측정항목을 지원하면 할당량 측정항목 필드가 표시되고 이 API의 quota_metric 라벨 값이 표시됩니다. 다음 스크린샷에서는 Compute Engine API 서브네트워크 할당량의 quota_metric 라벨 값이 compute.googleapis.com/subnetworks인 것을 보여줍니다.

    할당량 측정항목 세부정보 페이지의 예시

    서비스에서 할당량 측정항목을 지원하지 않으면 할당량 측정항목 필드가 표시되지 않습니다.

목표는 Compute Engine의 총 디스크 스토리지 할당량을 리전별로 표시하는 차트를 만드는 것입니다.

  1. Google Cloud Console에서 Cloud Monitoring을 선택한 후 측정항목 탐색기를 선택합니다.

  2. 리소스 유형을 소비자 할당량으로 설정하고 측정항목 유형을 할당량 사용량으로 설정하여 할당량 사용량을 표시하도록 측정항목 탐색기를 구성합니다.

    소비자 할당량 선택

    차트에는 6주 동안의 할당량 사용량이 막대 그래프로 표시됩니다. 범례를 보면 차트에 여러 서비스에 대한 할당량 사용량이 표시됩니다.

    Cloud Monitoring API를 사용하는 경우 동등한 필터 값은 다음과 같습니다.

    metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota"
    
  3. 디스플레이를 Compute Engine 서비스로 제한하려면 service = "compute.googleapis.com" 필터를 추가합니다.

    컴퓨팅 서비스를 기준으로 소비자 할당량을 필터링합니다.

    이제 차트에 Compute Engine 할당량의 할당량 사용량 시계열이 표시됩니다. 범례에는 표시된 각 시계열의 quota_metric 라벨 값이 표시됩니다. 이 값은 특정 할당량을 식별합니다. 예를 들어 compute.googleapis.com/disks_total_storage은 시계열이 Compute Engine의 총 디스크 스토리지 할당량임을 나타냅니다. 차트에는 사용량이 기록된 할당량의 할당량 사용량만 표시됩니다. 예를 들어 프로젝트에 Compute Engine 리소스가 없으면 이 필터는 데이터가 없는 차트를 얻게 됩니다.

    Cloud Monitoring API를 사용하는 경우 동등한 필터 값은 다음과 같습니다.

    metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota" resource.label.service="compute.googleapis.com"
    
  4. Compute Engine의 총 디스크 저장용량 할당량 사용량을 표시하는 차트를 만들려면 quota_metric = "compute.googleapis.com/disks_total_storage" 필터를 추가합니다.

    할당량 측정항목을 기준으로 소비자 할당량을 필터링합니다.

    Cloud Monitoring API를 사용하는 경우 동등한 필터 값은 다음과 같습니다.

    metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota" metric.label.quota_metric="compute.googleapis.com/disks_total_storage"
    
  5. 이전 차트는 리전 us-centra1us-east1us-central1-a 영역을 포함한 여러 영역의 시계열을 표시합니다. 리전별 할당량 사용량만 표시하려면 location 라벨을 기준으로 필터를 추가합니다. 두 리전 모두 us- 프리픽스가 붙고 1로 끝나는 이 예시에서 정규 표현식 location =~"^us.*1$"을 사용하는 필터가 효과적으로 작동합니다.

    할당량 측정항목 및 리전별로 필터링합니다.

소비자 할당량을 사용하면 quota_metric 라벨 값이 모니터링되는 서비스와 특정 할당량 사용량을 모두 식별합니다. 이 정보를 사용하여 특정 할당량 측정항목을 모니터링하는 차트 또는 알림 정책을 만들 수 있습니다.

알림 정책 예시

알림 정책은 조건 및 알림 정보의 모음입니다.

  • 조건은 모니터링 대상, 해당 리소스의 시계열 데이터가 결합되는 방식, 알림이 생성되어야 하는 시기를 설명합니다. 알림 정책은 하나 이상의 조건을 지정해야 합니다.
  • 알림 채널은 알림이 발생할 때 알림을 받는 사람과 알림 방법을 지정합니다. 예를 들어 특정 사용자 또는 그룹에 이메일을 보내도록 알림 정책을 구성할 수 있습니다.

본 섹션에서는 이제부터 각 하위 섹션에 알림 정책의 JSON 표현이 포함됩니다. Google Cloud Console을 사용하여 정책을 만들 수 있는 경우 두 개의 테이블도 포함됩니다.

  • 첫 번째 테이블은 모니터링 대상과 데이터의 결합 방식을 설명합니다.
  • 두 번째 테이블은 알림이 생성되는 시기를 설명합니다.

이 테이블의 값을 사용하여 알림 정책 조건을 구성할 수 있습니다.

할당량 한도에 대한 할당량 사용 비율 알림

Google Cloud 프로젝트 내 서비스의 할당량 한도에 대한 할당량 사용량의 비율이 80%를 초과하면 알림 정책을 만들 수 있습니다. 이러한 유형의 정책은 Cloud Monitoring API를 사용해야만 만들 수 있습니다.

Cloud Monitoring API 사용

API 메서드 alertPolicies.create를 사용하여 이 알림 정책을 만들 수 있습니다. gcloud 명령줄 도구를 사용하거나 클라이언트 라이브러리를 사용하여 Cloud Monitoring API를 직접 호출할 수 있습니다. 자세한 내용은 정책 만들기를 참조하세요.

JSON 또는 YAML의 알림 정책 표현에 대한 자세한 내용은 샘플 정책을 참조하세요.

이 정책 예시는 할당량 한도에 대한 ID 및 액세스 관리 API 할당량 사용량 비율을 모니터링합니다. 이 예시에서는 할당량 한도 결합이 의미가 없으므로 위치가 지정됩니다.

{
    "combiner": "OR",
    "conditions": [
      {
        "conditionThreshold": {
          "filter": "metric.type=\"serviceruntime.googleapis.com/quota/allocation/usage\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
          "aggregations": [
            {
              "alignmentPeriod": "86400s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_NEXT_OLDER"
            }
          ],
          "denominatorFilter": "metric.type=\"serviceruntime.googleapis.com/quota/limit\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
          "denominatorAggregations" : [
            {
              "alignmentPeriod": "86400s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_NEXT_OLDER"
            }
          ],
          "comparison": "COMPARISON_GT",
          "duration": "60s",
          "thresholdValue": 0.8,
          "trigger": {
            "count": 1
          }
        },
        "displayName": "Ratio quota usage for iam.googleapis.com by label.quota_metric [SUM]",
      }
    ],
    "displayName": "Ratio quota usage to limit",
    "enabled": true,
  }

quota/exceeded 오류 알림

Google Cloud 프로젝트에서 할당량 초과 오류를 보고하는 서비스가 있으면 알림 정책을 만들 수 있습니다. 이러한 유형의 정책은 Google Cloud Console 또는 Cloud Monitoring API를 사용하여 만들 수 있습니다.

Google Cloud Console 사용

본 하위 섹션은 이제부터 알림 정책의 조건 대화상자에 대한 것입니다.

다음 표의 설정을 사용하여 목표 대화상자를 완성합니다. 이 설정을 사용하면 Google Cloud 프로젝트 내 모든 서비스의 serviceruntime측정항목/quota/exceeded에 대한 시계열 데이터를 모니터링하고 데이터를 할당량 한도별로 분류할 수 있습니다.

목표
필드

리소스 유형 consumer_quota 입력
측정항목 serviceruntime.googleapis.com/quota/exceeded 선택
필터

비워 두기

이 입력란을 비워 두면 사용 가능한 모든 측정항목 데이터가 차트에 포함됩니다. 표시되는 데이터를 제한하려면 필터를 추가합니다. 예를 들어 데이터를 로깅 서비스로 제한하려면 service = logging.googleapis.com 필터를 추가합니다.

그룹화 기준

quota_metric를 선택합니다.

이 옵션은 데이터를 quota_metric 이름 유형별로 분류합니다.

애그리게이터

sum를 선택합니다.

집계 필드는 데이터가 그룹화될 때 자동으로 sum으로 설정됩니다. 이 설정은 개별 시계열의 데이터가 결합되는 방식을 정의합니다.

기간 1 m를 선택합니다.
고급 집계 정렬기: count true

이 측정항목은 GAUGE 유형으로 시계열의 각 데이터 포인트가 즉각적으로 측정되는 것을 의미합니다. 값 유형은 BOOL입니다. true 값은 할당량이 초과되었음을 나타냅니다.

이 측정항목의 경우 count truecount 정렬자 설정은 동일합니다.

다음 설정을 사용하여 구성 대화상자를 완성하세요. 이렇게 설정하면 할당량 초과 오류 수가 1백만당 0을 초과하면 알림 정책에서 알림을 생성합니다. 여기에서 할당량 초과 오류가 예기치 않게 발생하고 할당량을 늘려야 하거나 API 요청을 줄이기 위해 서비스를 수정해야 하기 때문에 값 0이 선택됩니다. 더 높은 기준을 사용하는 것이 좋습니다.

구성
필드

Condition triggers if Any time series violates
Condition is above
Threshold 0
For 1m

Cloud Monitoring API 사용

API 메서드 alertPolicies.create를 사용하여 이 알림 정책을 만들 수 있습니다. gcloud 명령줄 도구를 사용하거나 클라이언트 라이브러리를 사용하여 Cloud Monitoring API를 직접 호출할 수 있습니다. 자세한 내용은 정책 만들기를 참조하세요.

JSON 또는 YAML의 알림 정책 표현에 대한 자세한 내용은 샘플 정책을 참조하세요.

이 정책 예시는 할당량 한도에 대한 ID 및 액세스 관리 API 할당량 사용량 비율을 모니터링합니다. 이 예시에서는 할당량 한도 결합이 의미가 없으므로 위치가 지정됩니다.

{
    "combiner": "OR",
    "conditions": [
      {
        "conditionThreshold": {
          "aggregations": [
            {
              "alignmentPeriod": "60s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_COUNT_TRUE"
            }
          ],
          "comparison": "COMPARISON_GT",
          "duration": "60s",
          "filter": "metric.type=\"serviceruntime.googleapis.com/quota/exceeded\" resource.type=\"consumer_quota\"",
          "trigger": {
            "count": 1
          }
        },
        "displayName": "Quota exceeded error by label.quota_metric SUM",
      }
    ],
    "displayName": "Quota exceeded policy",
  }

절대 quota/allocation/usage에 대한 알림

알림 정책을 만들어 Google Cloud 프로젝트의 특정 서비스에 대한 할당량 사용량이 사용자 지정 임곗값을 초과하는 경우 알림을 보낼 수 있습니다. 이러한 유형의 정책은 Google Cloud Console 또는 Cloud Monitoring API를 사용하여 만들 수 있습니다.

Google Cloud Console 사용

본 하위 섹션은 이제부터 알림 정책의 조건 대화상자에 대한 것입니다.

다음 표의 설정을 사용하여 목표 대화상자를 완성합니다. 이 설정을 사용하면 Google Cloud 프로젝트 내 하나의 서비스의 serviceruntime측정항목/quota/allocation/usage에 대한 시계열 데이터를 모니터링하고 데이터를 할당량 한도별로 분류할 수 있습니다.

목표
필드

리소스 유형 consumer_quota 입력
측정항목 serviceruntime.googleapis.com/quota/allocation/usage 선택
필터 필터 service = iam.googleapis.com을 추가합니다.

iam.googleapis.com을 모니터링하려는 서비스의 이름으로 바꿉니다. 이 예에서는 이 공통 서비스가 선택되었습니다.

그룹화 기준

quota_metric를 선택합니다.

이 옵션은 데이터를 quota_metric 이름 유형별로 분류합니다.

애그리게이터

sum를 선택합니다.

집계 필드는 데이터가 그룹화될 때 자동으로 sum으로 설정됩니다. 이 설정은 개별 시계열의 데이터가 결합되는 방식을 정의합니다.

기간 1440 m를 선택합니다.

기간 일치는 이 측정항목의 샘플링 간격입니다.

고급 집계 정렬기: next older

정렬자가 next older로 설정되어 이 GAUGE 측정항목의 측정값을 포함합니다.

다음 설정을 사용하여 구성 대화상자를 완성하세요. 이렇게 설정하면 시계열 값이 14억 4천만당 2.5를 초과하는 경우 알림 정책을 통해 알림을 만듭니다. 14억 4천만의 값은 정렬 기간과 일치합니다. 2.5라는 값은 테스트 시스템의 정상 값보다 약간 높으므로 본 예시에서는 값 2.5를 선택했습니다. 모니터링할 서비스를 기준으로 임곗값을 선택하고 측정항목의 예상 값 범위를 파악해야 합니다.

구성
필드

Condition triggers if Any time series violates
Condition is above
Threshold 2.5
For 14억 4천만

Cloud Monitoring API 사용

API 메서드 alertPolicies.create를 사용하여 이 알림 정책을 만들 수 있습니다. gcloud 명령줄 도구를 사용하거나 클라이언트 라이브러리를 사용하여 Cloud Monitoring API를 직접 호출할 수 있습니다. 자세한 내용은 정책 만들기를 참조하세요.

JSON 또는 YAML의 알림 정책 표현에 대한 자세한 내용은 샘플 정책을 참조하세요.

이 정책 예시는 할당량 한도에 대한 ID 및 액세스 관리 API 할당량 사용량 비율을 모니터링합니다. 이 예시에서는 할당량 한도 결합이 의미가 없으므로 위치가 지정됩니다.

{
    "combiner": "OR",
    "conditions": [
      {
        "conditionThreshold": {
          "aggregations": [
            {
              "alignmentPeriod": "86400s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_NEXT_OLDER"
            }
          ],
          "comparison": "COMPARISON_GT",
          "duration": "84600s",
          "filter": "metric.type=\"serviceruntime.googleapis.com/quota/allocation/usage\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
          "thresholdValue": 2.5,
          "trigger": {
            "count": 1
          }
        },
        "displayName": "Allocation quota usage for iam.googleapis.com by label.quota_metric SUM",
      }
    ],
    "displayName": "Absolute quota usage policy",
  }

차트 예시

차트는 시계열 데이터를 표시합니다. 측정항목 탐색기를 사용하여 차트를 만들 수 있습니다. 측정항목 탐색기를 사용하면 더 이상 필요하지 않은 차트를 삭제하거나 대시보드에 저장할 수 있습니다. 대시보드 보기에서 대시보드에 차트를 추가할 수 있습니다.

차트를 만들려면 조회할 데이터와 그 방식을 지정합니다. 이 섹션의 나머지 부분에는 차트를 만드는 데 사용할 수 있는 설정이 포함되어 있습니다. 알림 정책의 목표 대화상자 설정을 사용하여 차트를 만들 수도 있습니다.

quota/allocation/usage 간격의 최대 사용량

데이터가 할당량 측정항목 이름별로 그룹화되고 25시간 단위의 측정항목 최댓값이 표시되는 Google Cloud 프로젝트의 모든 서비스에 대해 serviceruntime 측정항목 quota/allocation/usage의 시계열 데이터를 보려면 다음 설정을 사용합니다.

목표
필드

리소스 유형 consumer_quota 입력
측정항목 serviceruntime.googleapis.com/quota/allocation/usage 선택
필터 필터 service = iam.googleapis.com을 추가합니다.

iam.googleapis.com을 모니터링하려는 서비스의 이름으로 바꿉니다. 이 예에서는 이 공통 서비스가 선택되었습니다.

그룹화 기준

quota_metric를 선택합니다.

이 옵션은 데이터를 quota_metric 이름 유형별로 분류합니다.

애그리게이터

sum를 선택합니다.

집계 필드는 데이터가 그룹화될 때 자동으로 sum으로 설정됩니다. 이 설정은 개별 시계열의 데이터가 결합되는 방식을 정의합니다.

기간 1500 m를 선택합니다.

기간(25시간)은 이 측정항목의 샘플링 간격보다 약간 더 깁니다.

고급 집계 정렬기: max
보조 애그리게이터:sum

정렬자는 정렬 기간 동안 측정된 측정항목의 최댓값을 표시하도록 설정됩니다. 보조 애그리게이터는 여러 서비스에 대한 시계열을 단일 시계열로 결합합니다.

quota/rate/net_usage 시계열

데이터가 할당량 측정항목 이름별로 그룹화되고 사용량 요금이 표시되는 Google Cloud 프로젝트의 모든 서비스에 대해 serviceruntime 측정항목 quota/rate/net_usage의 시계열 데이터를 보려면 다음 설정을 사용합니다.

목표
필드

리소스 유형 consumer_quota 입력
측정항목 serviceruntime.googleapis.com/quota/rate/net_usage 선택
필터 필터 service = iam.googleapis.com을 추가합니다.

iam.googleapis.com을 모니터링하려는 서비스의 이름으로 바꿉니다. 이 예에서는 이 공통 서비스가 선택되었습니다.

그룹화 기준

quota_metric를 선택합니다.

이 옵션은 데이터를 quota_metric 이름 유형별로 분류합니다.

애그리게이터

sum를 선택합니다.

집계 필드는 데이터가 그룹화될 때 자동으로 sum으로 설정됩니다. 이 설정은 개별 시계열의 데이터가 결합되는 방식을 정의합니다.

기간 1 m를 선택합니다.

기간(1분)은 이 측정항목의 샘플링 간격과 일치합니다.

고급 집계 정렬기: rate

정렬자를 rate의 값으로 설정하면 이 DELTA 측정항목의 시계열에 저장된 값이 요금 데이터를 저장하는 새로운 시계열로 변환됩니다. 차트의 Y축에는 초당 할당량 단위가 있습니다.

quota/limit 시계열

데이터가 25시간동안 집계되는 Google Cloud 프로젝트의 모든 서비스에 대해 serviceruntime 측정항목 quota/limit의 시계열 데이터를 보려면 다음 설정을 사용합니다.

목표
필드

리소스 유형 consumer_quota 입력
측정항목 serviceruntime.googleapis.com/quota/limit 선택
필터 필터 service = iam.googleapis.com을 추가합니다.

iam.googleapis.com을 모니터링하려는 서비스의 이름으로 바꿉니다. 이 예에서는 이 공통 서비스가 선택되었습니다.

그룹화 기준 비워 두기
애그리게이터 none
기간 1500 m를 선택합니다.

기간 일치는 이 측정항목의 샘플링 간격입니다.

고급 집계 정렬기: next older

정렬자가 next older로 설정되어 이 GAUGE 측정항목의 측정값을 표시합니다. 정렬 기간인 25시간은 이 측정항목의 샘플링 간격보다 약간 깁니다.