전역 측정항목에서 리전 측정항목으로 API 할당량 마이그레이션

이 문서에서는 리전 API의 할당량 측정항목과 각 측정항목의 한도를 설명합니다. 또한 지역 측정항목을 사용하도록 Cloud Monitoring 대시보드, 알림 정책, 쿼리를 업데이트하는 방법도 설명합니다.

리전 API 할당량 측정항목

전역 할당량 측정항목을 사용한 Compute Engine 리전 API가 리전 측정항목을 사용하도록 마이그레이션됩니다. 전역 API는 전역 측정항목 및 할당량 한도를 계속 사용합니다. 전역 측정항목의 API 비율 제한을 참조하세요.

리전 측정항목 및 한도에 사용되는 메서드에 대한 자세한 내용은 리전 측정항목의 API 비율 한도를 참조하세요.

다음 표에는 전역 API 할당량 측정항목에서 리전 측정항목으로 마이그레이션된 모든 측정항목이 나와 있습니다.

전체 API 할당량 측정항목 리전 API 할당량 측정항목
compute.googleapis.com/default compute.googleapis.com/default_per_region
compute.googleapis.com/read_requests compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests compute.googleapis.com/list_requests_per_region
compute.googleapis.com/operation_read_requests compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/heavy_weight_read_requests compute.googleapis.com/heavy_weight_read_requests_per_region
compute.googleapis.com/heavy_weight_write_requests compute.googleapis.com/heavy_weight_write_requests_per_region
compute.googleapis.com/global_resource_write_requests compute.googleapis.com/global_resource_write_requests_per_region

다음 측정항목에는 전역 API가 없습니다. Cloud Monitoring 대시보드, 알림 또는 쿼리에서 이러한 측정항목을 참조하는 경우 이러한 측정항목을 해당하는 리전 측정항목으로 마이그레이션해야 합니다.

전체 API 할당량 측정항목 리전 API 할당량 측정항목
compute.googleapis.com/simulate_maintenance_event_requests compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/instance_list_referrers_requests compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/get_serial_port_output_requests compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/network_endpoint_write_requests compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/network_endpoint_list_requests compute.googleapis.com/network_endpoint_list_requests_per_region

다음 측정항목에는 지역 또는 영역 API가 없습니다. 따라서 지역 API 할당량 이전에는 변경사항이 필요하지 않습니다.

  • compute.googleapis.com/project_set_common_instance_metadata_requests
  • compute.googleapis.com/license_insert_requests

Cloud Monitoring 측정항목 이전

기존 API 할당량 측정항목에서 지역 API 할당량 측정항목으로 이전할 때는 지역 측정항목을 사용하도록 Cloud Monitoring 대시보드, 알림, 쿼리를 수동으로 업데이트해야 합니다.

지역 측정항목을 사용하도록 Cloud Monitoring 대시보드 업데이트

전 세계 API 할당량 측정항목을 모니터링하는 알림 정책을 지역 측정항목으로 변경하려면 다음 단계를 따르세요.

  1. Google Cloud Console에서 Monitoring을 선택합니다.
  2. 탐색창에서 대시보드를 선택합니다.
  3. 지역별 측정항목을 사용하도록 수정할 대시보드를 선택합니다.
  4. 대시보드 수정을 클릭합니다.

  5. 마이그레이션하려는 측정항목에 해당하는 필터를 수정합니다.

    1. 필터 필드에서 quota_metric을 선택합니다.
    2. 비교 연산자 필드에서 =~를 선택합니다.

    3. 값 필드에 지역 API 할당량의 측정항목 이름을 지정합니다. 예를 들어 quota_metric =~ compute.googleapis.com/read_requests.* 필터는 정규 표현식을 사용하여 할당량 측정항목 compute.googleapis.com/read_requests.*를 사용하는 모든 시계열 데이터를 일치시킵니다.

      지역 측정항목을 사용하도록 필터 값을 수정합니다.

      측정항목에 대한 자세한 내용은 리전 측정항목의 API 비율 한도를 참조하세요.

    4. 완료를 클릭하여 변경사항을 저장합니다.

    5. 선택사항: 리전별 할당량 사용량을 보려면 그룹화 헤더를 확장하고 그룹화 기준 필드에서 location을 선택합니다.

  6. 편집기 닫기를 클릭합니다.

지역 API 할당량 측정항목을 사용하도록 Cloud Monitoring 알림 정책 업데이트

전 세계 API 할당량 측정항목을 모니터링하는 알림 정책을 지역 측정항목으로 변경하려면 다음 단계를 따르세요.

  1. Google Cloud Console에서 Monitoring을 선택합니다.
  2. 탐색 창에서 알림을 선택합니다. 알림 페이지에는 요약 정보, 이슈, 알림 정책을 나열하는 창이 표시됩니다.
  3. 지역별 측정항목을 사용하도록 수정하려는 알림 정책을 클릭합니다.
  4. 수정을 클릭하여 정책을 수정합니다.

  5. 마이그레이션하려는 측정항목에 해당하는 필터를 수정합니다.

    1. 필터 필드에서 quota_metric을 선택합니다.
    2. 비교 연산자 필드에서 =~를 선택합니다.

    3. 값 필드에 지역 API 할당량의 측정항목 이름을 지정합니다. 예를 들어 quota_metric =~ compute.googleapis.com/read_requests.* 필터는 정규 표현식을 사용하여 할당량 측정항목 compute.googleapis.com/read_requests.*를 사용하는 모든 시계열 데이터를 일치시킵니다.

      지역 측정항목을 사용하도록 알림을 수정합니다.

      측정항목에 대한 자세한 내용은 리전 측정항목의 API 비율 한도를 참조하세요.

    4. 완료를 클릭하여 필터의 변경사항을 저장합니다.

    5. 선택사항: 리전 측정항목에 대해 리전별 알림을 원하는 경우 시계열 전체 헤더를 확장하고 시계열 그룹화 기준 필드의 location을 선택합니다.

  6. 정책 저장을 클릭합니다.

지역 할당량 측정항목을 사용하도록 Cloud Monitoring 쿼리 업데이트

MQL 기반 알림 정책의 할당량 측정항목 또는 대시보드의 차트를 변경하려면 쿼리 편집기를 사용하고 쿼리 필터를 수정합니다. 쿼리 편집기 사용을 참고하세요.

쿼리 편집기를 열고 다음 예와 같이 쿼리 측정항목의 필터를 수정합니다.

리전 할당량 측정항목의 정규 표현식

원하는 경우 group-by 작업을 사용하여 위치를 기준으로 알림을 그룹화할 수 있습니다.

위치별 알림 그룹화