할당량 측정항목 사용

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

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

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

알림 정책 예시

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

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

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

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

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

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

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

Cloud Monitoring API 사용

API 메서드 alertPolicies.create를 사용하여 이 알림 정책을 만들 수 있습니다. JSON 또는 YAML의 알림 정책 표시에 대한 자세한 내용은 샘플 정책을 참조하세요.

이 정책은 Cloud Spanner API 할당량 한도에 대한 할당량 사용량의 비율을 모니터링합니다. 이 예에서는 할당량 한도 결합이 의미가 없으므로 위치가 지정됩니다.

    {
        "combiner": "OR",
        "conditions": [
          {
            "conditionThreshold": {
              "filter": "metric.type=\"serviceruntime.googleapis.com/quota/allocation/usage\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"spanner.googleapis.com\" resource.label.\"location\"=\"asia-east1\"",
              "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\"=\"spanner.googleapis.com\" resource.label.\"location\"=\"asia-east1\"",
              "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 to limit for spanner.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으로 설정됩니다. 이 설정은 개별 시계열의 데이터가 결합되는 방식을 정의합니다.

고급 집계 정렬자: count true
정렬 기간: 1 m

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

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

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

구성
필드

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

Cloud Monitoring API 사용

API 메서드 alertPolicies.create를 사용하여 이 알림 정책을 만들 수 있습니다. JSON 또는 YAML의 알림 정책 표시에 대한 자세한 내용은 샘플 정책을 참조하세요.

이 정책은 Cloud Spanner 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으로 설정됩니다. 이 설정은 개별 시계열의 데이터가 결합되는 방식을 정의합니다.

고급 집계 정렬자: next older
정렬 기간: 1440 m

정렬자가 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를 사용하여 이 알림 정책을 만들 수 있습니다. JSON 또는 YAML의 알림 정책 표시에 대한 자세한 내용은 샘플 정책을 참조하세요.

이 정책은 Cloud Spanner 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으로 설정됩니다. 이 설정은 개별 시계열의 데이터가 결합되는 방식을 정의합니다.

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

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

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으로 설정됩니다. 이 설정은 개별 시계열의 데이터가 결합되는 방식을 정의합니다.

고급 집계 정렬자: rate
정렬 기간: 1 m

정렬자를 rate의 값으로 설정하면 이 DELTA 측정항목의 시계열에 저장된 값이 요금 데이터를 저장하는 새로운 시계열로 변환됩니다. 차트의 Y축에는 초당 할당량 단위가 있습니다. 정렬 기간인 1 분은 이 측정항목의 샘플링 간격과 일치합니다.

quota/limit 시계열

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

목표
필드

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

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

그룹화 기준 비워 두기
애그리게이터 none
고급 집계 정렬자: next older
정렬 기간: 1500 m

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