Cloud Monitoring에서 간소화된 API 할당량 측정항목 사용

이 문서에서는 Cloud Monitoring 대시보드, 알림 정책, 쿼리에서 간소화된 Compute Engine API 할당량 측정항목을 사용하는 방법을 설명합니다.

간소화된 API 할당량 측정항목

Compute Engine API 할당량의 검색 가능성과 관리성을 개선하기 위해 Google Cloud 측정항목을 더 적은 수의 할당량 그룹으로 통합하여 할당량 측정항목 수를 줄였습니다. 또한 이러한 간소화된 할당량 측정항목은 각 할당량 그룹에 더 높은 한도를 제공합니다.

다음 표에는 기존 API 할당량 측정항목을 통합하는 모든 간소화된 API 할당량 측정항목이 나와 있습니다.

기존 API 할당량 측정항목	간소화된 API 할당량 측정항목
`compute.googleapis.com/list_requests`	`Read requests per minute` `compute.googleapis.com/global_reads`^BETA
`compute.googleapis.com/read_requests`
`compute.googleapis.com/heavy_weight_read_requests`
`compute.googleapis.com/default` Compute Engine 리소스를 나열하는 메서드의 기존 할당량 측정항목입니다.
`compute.googleapis.com/get_macsec_config_requests`
`compute.googleapis.com/license_verification_requests`
`compute.googleapis.com/default` Compute Engine 리소스를 생성, 수정 또는 삭제하는 전역 메서드의 기존 할당량 측정항목입니다.	`Mutation requests per minute` `compute.googleapis.com/global_writes`^BETA
`compute.googleapis.com/global_resource_write_requests`
`compute.googleapis.com/heavy_weight_write_requests`
`compute.googleapis.com/regional_v2_public_advertised_prefixes_delete_requests`
`compute.googleapis.com/regional_v2_public_advertised_prefixes_create_requests`
`compute.googleapis.com/address_move_requests`
`compute.googleapis.com/project_set_common_instance_metadata_requests`
`compute.googleapis.com/regional_v2_public_advertised_prefixes_announce_requests`
`compute.googleapis.com/license_insert_requests`
`compute.googleapis.com/heavy_weight_read_requests_per_region`	`Read requests per minute per region` `compute.googleapis.com/reads_per_region`^BETA
`compute.googleapis.com/read_requests_per_region`
`compute.googleapis.com/list_requests_per_region`
`compute.googleapis.com/default_per_region` Compute Engine 리소스를 나열하는 리전 및 영역 메서드의 기존 할당량 측정항목입니다.
`compute.googleapis.com/license_verification_requests_per_region`
`compute.googleapis.com/instance_list_referrers_requests_per_region`
`compute.googleapis.com/operation_read_requests_per_region`
`compute.googleapis.com/network_endpoint_list_requests_per_region`
`compute.googleapis.com/regional_network_endpoint_list_requests_per_region`
`compute.googleapis.com/get_serial_port_output_requests_per_region`
`compute.googleapis.com/read_requests`
`compute.googleapis.com/heavy_weight_write_requests_per_region`	`Mutation requests per minute per region` `compute.googleapis.com/writes_per_region`^BETA
`compute.googleapis.com/default_per_region` Compute Engine 리소스를 생성, 수정 또는 삭제하는 리전 및 영역 메서드의 기존 할당량 측정항목입니다.
`compute.googleapis.com/global_resource_write_requests_per_region`
`compute.googleapis.com/network_endpoint_write_requests_per_region`
`compute.googleapis.com/regional_network_endpoint_write_requests_per_region`
`compute.googleapis.com/regional_public_delegated_prefixes_create_requests_per_region`
`compute.googleapis.com/address_move_requests_per_region`
`compute.googleapis.com/simulate_maintenance_event_requests_per_region`
`compute.googleapis.com/regional_public_delegated_prefixes_delete_requests_per_region`
`compute.googleapis.com/regional_public_delegated_prefixes_announce_requests_per_region`
`compute.googleapis.com/recommend_locations_requests_per_region`	`RegionInstances RecommendLocations requests per minute per region` `compute.googleapis.com/recommend_locations_per_region`^BETA
`compute.googleapis.com/cache_invalidation_requests`	`Cache invalidation requests per minute` `compute.googleapis.com/global_cache_invalidation_requests`^BETA

Cloud Monitoring에서 간소화된 측정항목 사용

간소화된 API 측정항목에 대한 Compute Engine API 사용량을 모니터링하려면 Cloud Monitoring 대시보드, 알림, 쿼리에 이러한 측정항목의 필터를 추가하세요.

Cloud Monitoring 대시보드에서 간소화된 측정항목 사용

대시보드에서 간소화된 할당량 측정항목을 사용하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Monitoring으로 이동합니다.

Monitoring으로 이동
탐색창에서 대시보드를 선택합니다.
간소화된 측정항목을 사용하도록 수정할 대시보드를 선택합니다.
대시보드 수정을 클릭하고 위젯을 추가합니다.
모니터링하려는 측정항목에 해당하는 필터를 추가합니다.
1. 필터 필드에서 quota_metric을 선택합니다.
2. 비교 연산자 필드에서 =를 선택합니다.
3. 값 필드에 API 할당량의 측정항목 이름을 지정합니다. 예를 들어 quota_metric = compute.googleapis.com/global_reads 필터는 정규 표현식을 사용하여 할당량 측정항목 compute.googleapis.com/global_reads를 사용하는 모든 시계열 데이터를 일치시킵니다.
대시보드에 변경사항을 적용하려면 툴바에서 적용을 클릭합니다.

Cloud Monitoring 알림 정책에서 간소화된 API 할당량 측정항목 사용

간소화된 API 할당량 측정항목의 사용량을 모니터링하는 알림 정책을 만들려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Monitoring으로 이동합니다.

Monitoring으로 이동
탐색 창에서 알림을 선택합니다. 알림 페이지에는 요약 정보, 이슈, 알림 정책을 나열하는 창이 표시됩니다.
정책 만들기를 클릭하여 알림 정책을 추가합니다.
모니터링하려는 측정항목에 해당하는 필터를 추가합니다.
1. 필터 필드에서 quota_metric을 선택합니다.
2. 비교 연산자 필드에서 =를 선택합니다.
3. 값 필드에 간소화된 할당량의 측정항목 이름을 지정합니다. 예를 들어 quota_metric = compute.googleapis.com/global_reads 필터는 정규 표현식을 사용하여 할당량 측정항목 compute.googleapis.com/global_reads를 사용하는 모든 시계열 데이터를 일치시킵니다.
4. 완료를 클릭하여 필터의 변경사항을 저장합니다.
정책 저장을 클릭합니다.

Google Cloud Terraform 제공업체를 사용하여Google Cloud 프로젝트에서 알림 정책을 만들 수도 있습니다. 자세한 내용은 Terraform으로 알림 정책 만들기를 참조하세요.

Cloud Monitoring 쿼리에서 간소화된 할당량 측정항목 사용

MQL 기반 또는 PromQL 기반 알림 정책이나 대시보드의 차트에서 간소화된 할당량 측정항목을 사용하려면 쿼리 편집기를 사용하고 쿼리 필터를 수정합니다. 쿼리 편집기 사용을 참조하세요. 쿼리 편집기를 열고 다음 예와 같이 필터를 추가합니다. MQL:

  fetch consumer_quota
   | metric 'serviceruntime.googleapis.com/quota/rate/net_usage'
   | filter (metric.quota_metric =~ 'compute.googleapis.com/global_reads')
   | align rate(1m)
   | every 1m
   | group_by [], [value_net_usage_aggregate: aggregate(value.net_usage)]

참고: MQL은 2025년 7월 22일에 지원 중단됩니다. PromQL을 사용하여 대시보드를 빌드합니다. 자세한 내용은 MQL 지원 중단을 참조하세요. PromQL:

   sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", 

   quota_metric=~"compute.googleapis.com/globalreads"}[${_interval}]))