할당량 작업

Google Cloud는 프로젝트 소유자의 리소스 사용에 할당량을 적용하여 프로젝트에서 사용할 수 있는 특정 Google Cloud 리소스의 양을 엄격하게 제한합니다. 할당량은 다음 두 가지 카테고리로 분류됩니다.

  • 비율 할당량: 예를 들어 일일 API 요청 수가 있습니다. 이 할당량은 서비스에 지정된 시간 간격(예: 1분 또는 하루) 후 재설정됩니다.
  • 할당 할당량: 예를 들어 특정 시점에 프로젝트에서 사용한 가상 머신 또는 부하 분산기 수가 있습니다. 이 할당량은 시간이 경과해도 재설정되지 않지만 리소스를 더 이상 사용하지 않으려는 경우 GKE 클러스터 삭제와 같이 명시적으로 해제해야 합니다.

각 할당량 한도는 일일 API 요청 수부터 애플리케이션에서 동시에 사용하는 부하 분산기 수와 같이 계수할 수 있는 특정 리소스를 나타냅니다.

할당량이 적용되는 이유는 다양합니다.

  • 할당량은 예기치 않은 사용량 급증을 차단함으로써 Google Cloud 사용자 커뮤니티를 보호합니다.
  • 또한 리소스 관리에도 도움이 됩니다. 예를 들어 애플리케이션을 개발하고 테스트하는 동안 서비스 사용량에 한도를 설정할 수 있습니다.

동일한 서비스라도 프로젝트에 따라 할당량이 다를 수 있습니다. 예를 들어 무료 체험판 계정을 사용하여 플랫폼을 살펴보는 경우 할당량이 더 제한됩니다. 프로젝트에 결제를 사용 설정하면 대부분의 서비스에 대한 할당량이 늘어납니다. 특정 서비스의 추가 할당량을 명시적으로 요청할 수도 있습니다. Google Cloud 사용량이 점차 늘어나면 할당량도 늘어날 수 있습니다.

프로젝트의 할당량 한도는 서비스 소유자, 프로젝트 소유자 또는 할당량 관리자가 적용하는 할당량 재정의의 영향을 받을 수 있습니다. 서비스 할당량 모델에서 할당량 한도 계산 방식에 대해 자세히 알아볼 수 있습니다.

모니터링과 알림을 구성하여 할당량 사용을 추적하고 할당량 만료 또는 비정상적인 사용량 발생 시 알림을 받을 수 있습니다.

이 페이지에서는 기존 할당량 한도를 찾고 수정하는 방법, 할당량 상향을 요청하는 방법, 할당량 사용을 모니터링하는 방법 등 프로젝트에서 할당량 관련 작업을 수행하는 방법을 설명합니다. API 사용량 모니터링에서 다른 API 사용량 측정항목을 보는 방법을 알아보세요.

권한

Google Cloud Console에서 프로젝트 할당량을 보거나 프로그래매틱 방식으로 액세스하려면 다음 IAM 권한이 필요합니다.

  • resourcemanager.projects.get
  • resourcemanager.folders.get (전체 폴더의 할당량을 보려는 경우)
  • resourcemanager.organizations.get (전체 조직의 할당량을 보려는 경우)
  • serviceusage.quotas.get

IAM 권한 참조에서 이러한 권한이 기본적으로 포함된 역할을 확인할 수 있습니다.

프로젝트, 폴더 또는 조직 수준에서 할당량을 변경하려면 다음 권한도 필요합니다.

  • serviceusage.quotas.update

이 권한은 소유자, 편집자, 할당량 관리자 및 서비스 사용량 관리자 역할에 기본적으로 포함되어 있습니다.

할당량 보기

Google Cloud Console에서 현재 할당량 한도를 확인하는 방법은 두 가지입니다.

  • 할당량 페이지: 프로젝트의 모든 할당량 사용 및 한도 목록을 제공합니다.
  • Cloud Console API 대시보드: 시간 경과에 따른 리소스 사용량을 포함한 특정 API의 할당량 정보를 나열합니다.

Service Usage API를 사용하여 프로그래매틱 방식으로 할당량 사용을 관리할 수 있습니다.

또한 일부 서비스의 경우 명령줄로 할당량 및 리소스 사용 정보에 액세스할 수 있습니다. 예를 들어 Compute Engine에서는 gcloud compute를 사용하여 할당량 정보에 액세스할 수 있습니다.

할당량 측정항목 모니터링 섹션에서 할당량 사용을 모니터링하는 방법과 할당량 알림을 설정하는 방법을 알아볼 수 있습니다.

모든 프로젝트 할당량 보기

프로젝트의 모든 리소스 할당량 사용 및 한도를 확인하려면 다음 안내를 따르세요.

  1. IAM 및 관리자에서 Cloud Console 할당량 페이지로 이동합니다. 이 페이지에는 각 서비스에서 사용 가능한 각 할당량 유형의 항목이 나열됩니다.

  2. 결과를 정렬 및 필터링하여 필요한 정보에 집중합니다.

    • 특정 속성을 보려면 테이블 필터링을 클릭합니다.
    • 목록을 알파벳 순으로 정렬하려면 서비스, 한도 이름, 할당량 상태 또는 세부정보 위에 마우스 포인터를 올려놓습니다.
    • 기본적으로 목록은 가장 많이 사용된 할당량을 먼저 표시하도록 정렬되어(최근 7일 동안의 최고 사용량) 초과될 위험이 있는 한도를 확인하는 데 도움을 제공합니다. 가장 적게 사용된 할당량을 먼저 확인하려면 할당량 상태 화살표를 전환하세요.
    • 특정 할당량의 현재 사용량에 대해 자세히 알아보려면 세부정보 열에서 모든 할당량을 클릭합니다.

할당량 페이지에 나열된 할당량 사용 측정항목은 다음과 같이 계산됩니다.

  • 비율 할당량:
    • 일일 비율 할당량의 경우 나열된 숫자는 현재 24시간 동안의 총 사용량을 나타냅니다.
    • 분당 또는 100초당 할당량의 경우 나열된 숫자는 지난 24시간 동안의 평균 사용량을 나타냅니다.
  • 할당 할당량: 여기에 나열된 숫자는 현재 프로젝트에서 사용 중인 리소스 수(예: 부하 분산기 수)를 나타냅니다.

특정 서비스의 할당량과 그 의미는 각 서비스 문서를 참조하세요. 예를 들어 Compute Engine 할당량은 리소스 할당량에 설명되어 있습니다.

API별 할당량

시간 경과에 따른 사용량을 포함한 특정 API의 상세한 할당량 정보를 보려면 Cloud Console에서 API 할당량 페이지를 참조하세요. API에 따라 이러한 한도에는 일일 요청, 분당 요청, 사용자별 분당 요청이 포함될 수 있습니다. 일부 API의 경우 프로젝트에 결제를 사용 설정할 때까지 한도가 매우 낮게 설정됩니다.

Cloud Console에서 특정 API의 현재 한도를 확인하는 방법은 두 가지입니다.

  • 모든 프로젝트 할당량 보기 섹션의 설명대로 Cloud Console 할당량 페이지를 참조하세요.

  • Cloud Console API 및 서비스 대시보드 페이지로 이동합니다. 이 페이지에서 프로젝트를 선택하고 API 이름을 클릭한 후 할당량을 클릭합니다. 할당량 페이지에 API의 할당량 이름이 표시됩니다. 각 할당량을 펼쳐 시간 경과에 따른 사용량 세부정보와 현재 한도를 자세히 확인할 수 있습니다. 기본적으로 표시되는 한도는 Google에서 설정합니다. 사용량 상한 설정 섹션의 설명에 따라 사용량을 제한할 수 있습니다. 특정 할당량에 Google에서 설정한 한도가 없으면 한도가 무제한으로 표시됩니다.

    • API별 할당량 페이지에 표시되지 않는 할당량도 있습니다. 예를 들어 Compute Engine API에 대한 요청에는 API별 할당량 페이지가 있지만 여기에는 Compute Engine 컴퓨팅 리소스 사용량(할당 할당량)은 포함되지 않습니다. 또한 여러 위치에서 서비스를 사용 중인 경우 API별 할당량 페이지에는 리전 또는 영역의 할당량 한도 및 사용량이 표시되지 않습니다. 위치별로 필터링할 수 있는 프로젝트의 할당량 사용 전체 목록은 프로젝트 할당량 페이지를 참조하세요.

Cloud Console을 사용하여 할당량 관리

리소스 사용량에 따라 프로젝트의 할당량 한도를 상향하거나 하향하고자 하는 경우가 있습니다. 이 섹션에서는 제공된 할당량 한도를 변경하는 방법을 설명합니다. 세부정보 열에서 모든 할당량을 클릭하여 할당량 한도를 확인할 수 있습니다.

할당량 상향 요청

Cloud Console 할당량 페이지에서 할당량 한도가 있는 대부분의 청구 가능 서비스의 할당량 변경을 요청할 수 있습니다.

  1. 할당량 상태 열에서 경고를 클릭합니다. 할당량 패널에 모든 할당량이 나열됩니다.
  2. 변경할 할당량 위치의 체크박스를 선택합니다.
  3. 할당량 수정을 클릭합니다.
  4. 요청 양식을 작성합니다.
  5. 수정된 할당량 한도와 설명(선택사항)을 입력합니다.
  6. 완료를 클릭합니다.
  7. 요청 제출을 클릭합니다.

또는 테이블 필터링을 클릭하여 특정 속성별로 할당량을 쿼리합니다.

요청에 대한 응답으로 이메일이 전송됩니다.

Google Cloud 할당량 요청은 일반적으로 영업일 기준 2일 이내에 신속하게 처리되며 Google Cloud로부터 이메일 확인을 받게 됩니다. 추가 도움이 필요한 경우 이 이메일에 회신하면 됩니다. 할당량을 크게 변경하려는 경우 승인에 더 오랜 시간이 걸릴 수 있습니다.

사용량 상한 설정

직접 할당량 한도를 설정하여 특정 리소스의 사용량을 제한할 수 있습니다. 예를 들어 무료 우대 사용량 한도를 초과하여 사용량 요금이 청구되지 않도록 일일 요청 상한을 설정할 수 있습니다. 할당량 상한을 설정하는 가장 간단한 방법은 API별 할당량 페이지에서 한도를 수정하는 것입니다.

Google Cloud Console에서 IAM 및 관리자 페이지의 할당량으로 이동합니다.

할당량으로 이동

  1. 필터 테이블을 클릭하여 특정 속성별로 할당량을 쿼리합니다.
  2. 설정할 사용량에 대해 모든 할당량을 클릭합니다.
  3. 체크박스를 클릭하여 수정할 속성을 선택합니다.
  4. 할당량 수정을 클릭합니다.
  5. 요청 양식을 작성합니다.
  6. 수정된 할당량 한도와 설명(선택사항)을 입력합니다.
  7. 완료를 클릭합니다.
  8. 요청 제출을 클릭합니다.

이 페이지에 표시되지 않는 할당량을 제한하거나 제공된 최댓값보다 높게 한도를 설정하려면 할당량 상향 요청에 설명된 대로 한도를 수정합니다.

Service Usage API를 사용하여 할당량 관리

Service Usage API를 사용하여 현재 할당량을 가져오고 일부 Google Cloud API 및 서비스의 할당량 사용을 제한할 수 있습니다. 서비스 사용량에 대한 자세한 내용은 다음을 참조하세요.

Service Usage API를 사용하여 할당량 상향을 요청할 수는 없습니다. 이 활동에는 Cloud Console을 사용해야 합니다.

할당량 측정항목 모니터링 및 알림

Cloud Monitoring API 및 UI를 사용하면 할당량 사용, 한도, 오류를 상세히 모니터링할 수 있습니다. 이러한 측정항목을 사용하여 커스텀 대시보드와 알림을 만들면 시간 경과에 따른 할당량 사용을 모니터링하고 할당량 한도가 얼마 남지 않은 경우 등에 알림을 받을 수 있습니다.

Cloud Monitoring은 다양한 측정항목을 지원하므로 필터 및 집계를 조합하여 할당량 사용에 대한 새롭고 유용한 정보를 얻을 수 있습니다. 예를 들어 할당 할당량 사용 측정항목과 Cloud TPU 이름의 quota_metric 필터를 조합하여 사용할 수 있습니다.

{ % include "monitoring/_shared/metrics-explorer/_template_metrics_explorer.html" %}

할당량 한도나 할당량 초과 오류를 보고 싶을 때도 먼저 리소스 유형으로 소비자 할당량을 선택하고 할당량 한도할당량 초과 오류를 선택합니다.

원하는 할당량 사용 정보를 찾았다면 Cloud Monitoring을 사용하여 애플리케이션을 모니터링하고 견고하게 유지하는 데 도움이 되는 커스텀 대시보드 및 알림을 만들 수 있습니다. 자세한 내용은 다음 페이지를 참조하세요.

자세한 내용과 일반적인 할당량 관련 알림 정책의 예시는 Cloud Monitoring 문서의 할당량 측정항목 사용을 참조하세요.

할당량 측정항목에 대한 세부 참조는 Cloud Monitoring 참조 가이드에서 찾을 수 있습니다.

할당량 오류

프로젝트에서 서비스 사용 중에 할당량을 초과하는 경우 Google Cloud는 서비스에 액세스한 방법에 따라 오류를 반환합니다.

  • HTTP/REST 요청 시 할당량을 초과하면 Google Cloud에서 HTTP 429 TOO MANY REQUESTS 상태 코드를 반환합니다.
  • API 요청 시 할당량을 초과하면 Google Cloud에서 HTTP 413 REQUEST ENTITY TOO LARGE 상태 코드를 반환합니다.
  • gRPC를 사용하여 할당량을 초과하면 Google Cloud에서 ResourceExhausted 오류를 반환합니다. 오류가 표시되는 방식은 서비스에 따라 다릅니다.
  • gcloud 명령줄 도구 명령어를 사용하여 할당량을 초과하면 gcloud 명령줄 도구가 할당량 초과 오류 메시지를 출력하고 종료 코드 1을 반환합니다.

비율 할당량은 각 서비스에 해당하는 사전 정의된 시간 간격이 지나면 재설정됩니다. 자세한 내용은 해당 서비스의 할당량 문서를 참조하세요.

Cloud Monitoring을 사용하여 오류 알림과 관련된 할당량 사용을 파악하고 할당량 측정항목 모니터링에 설명된 대로 특정 할당량 오류에 대한 커스텀 알림을 만들 수 있습니다.