할당량 및 한도

이 페이지에서는 Cloud Logging 사용에 적용되는 한도에 대한 세부정보를 제공합니다.

Logging 사용량 한도

Cloud Logging 사용 시 다음 한도가 적용됩니다. 로그 버킷 및 싱크의 수에 대한 제한을 제외하고 이러한 한도는 고정되어 있습니다. 즉, 늘리거나 줄일 수 없습니다.

카테고리 최댓값
LogEntry 크기 256 KB1
감사 로그 항목 크기 512KiB
라벨 수 LogEntry당 64개
LogEntry 라벨 키 길이 512 B2
LogEntry 라벨 값 길이 64 KB2
Logging 쿼리 언어 쿼리 길이 20,000자
쿼리 팬아웃4 버킷 200개
싱크 수 Google Cloud 프로젝트당 200개3
싱크 포함 필터 길이 20,000자
싱크 제외 필터 길이 20,000자
제외 필터 수 싱크당 50개
로그 버킷 수 Google Cloud 프로젝트당 100개3,4,5
커스텀 색인이 생성된 필드 수 로그 버킷당 20개
로그 뷰 수 로그 버킷당 30개
로그 버킷에 저장할 수 있는 가장 오래된 타임스탬프6 로그 버킷의 기본 보관 기간에 따라 결정됩니다. 기본 보관 기간이 적용된 커스텀 로그 버킷의 경우 이 값은 이전 30일입니다.
로그 버킷에 저장할 수 있는 향후 타임스탬프6 최대 1 일 후
리소스당 로그 범위 수 100
로그 범위에 포함된 로그 뷰 및 프로젝트 수 100
로그 범위에 포함된 프로젝트 수 5
Google Cloud 프로젝트당 최대 분석 뷰 수7 100
Google Cloud 프로젝트당 리전별 최대 분석 뷰 수7 50
Google Cloud 프로젝트당 분석 뷰를 저장할 수 있는 최대 리전 수7 10

1 실제 REST API 요청 크기가 아닌 내부 데이터 크기를 기반으로 한 대략적인 한도입니다.
2 Cloud Logging은 연결된 로그 항목이 작성될 때 크기가 초과한 라벨 키와 값을 자릅니다.
3 이 한도는 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다. 예를 들어 조직에 여러 Google Cloud 프로젝트가 있는 경우 각 Google Cloud 프로젝트에 최대 200개의 싱크를 구성할 수 있습니다. 해당 조직에 대해 조직 수준에서 최대 200개의 싱크를 구성할 수도 있습니다.
4 이 한도는 리소스의 로그 항목이 포함될 수 있는 최대 버킷 수입니다. 자세한 내용은 쿼리에서 오류 반환을 참조하세요.
5 이 한도에는 삭제 대기 중인 버킷이 포함됩니다.
6 타임스탬프가 이러한 범위를 벗어나는 로그 항목은 로그 버킷에서 거부됩니다. Logging API는 타임스탬프가 오래된 항목을 허용하며 이러한 항목은 싱크 대상으로 라우팅될 수 있지만 로그 스토리지에 저장되지 않습니다. Logging API는 타임스탬프가 향후 1일보다 오래된 항목을 거부하고 INVALID_ARGUMENT 오류를 반환합니다.
7이 기능은 공개 프리뷰 버전입니다.

Logging API 할당량 및 한도

Logging API 사용에 다음 한도가 적용됩니다. Logging API 할당량 및 한도 변경을 요청할 수 있습니다. 자세한 내용은 이 페이지의 Cloud Logging API 할당량 변경 요청을 참조하세요.

카테고리 최댓값
API 사용량 할당량을 보려면 API 대시보드로 이동하고 API를 선택한 후 할당량을 선택합니다.
API 페이지 토큰의 수명 24시간
진행 중인 실시간 테일링 세션 수 Google Cloud 프로젝트당 10개3
반환된 실시간 테일링 항목 수 분당 60,000
제한된 필드 수 버킷당 20개
제한된 필드 크기 800 B
entries.write 요청 크기 10MB
entries.write 요청 수
할당량이 대체됩니다. 자세한 내용은 리전별 수집 할당량을 참조하세요.		 Google Cloud 프로젝트별 분당 120,000개1, 3
리전별 entries.write 요청 비율
할당량이 추가됩니다. 자세한 내용은 리전별 수집 할당량을 참조하세요.		 asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1 리전에서는 Google Cloud 프로젝트별 분당 4.8GB 1, 3

나머지 모든 리전에서는 Google Cloud 프로젝트별 분당 300MB1, 3
entries.list 요청 수 Google Cloud 프로젝트별 분당 60개2, 3
단일 entries.write 명령어의
다양한 리소스 이름 수4		 1000
분당 제어 요청5 600
일일 제어 요청5 Google Cloud 프로젝트당 1,000개
단일 entries.list 요청의 Google Cloud 프로젝트
또는 기타 리소스 이름 수		 100
동시 복사 작업 수 Google Cloud 프로젝트당 1개3
Pub/Sub 주제로 내보내는 비율6 Google Cloud 프로젝트당 분당 60GB

1 entries.write 요청 후에 로그가 제외되므로 제외 필터를 사용해도 이 수는 줄어들지 않습니다.
2이 값이 기본 설정입니다.
3 이 한도는 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다.
4 로그 항목의 logName 필드는 로그 항목의 리소스 이름을 지정합니다.
5 일일 제어 요청 할당량은 제외 및 싱크를 만들고 업데이트하기 위한 API 요청에 적용됩니다. 분당 제어 요청 할당량은 일일 제어 요청 할당량에 포함된 모든 항목과 함께 로그를 삭제하고 로그 기반 측정항목을 관리하기 위한 API 요청에 적용됩니다.
6 내보내기 비율이 할당량을 초과하면 로그 항목에 오류가 기록됩니다. 요약 필드에 싱크 구성 오류가 표시되고 오류 코드가 topic_over_quota로 나열됩니다.

리전별 수집 할당량

2025년 4월 22일부터 Cloud Logging 할당량은 Google Cloud 프로젝트별로 수집 리전에 작성된 데이터 양을 제한합니다. 이 날부터 Cloud Logging은 Google Cloud 프로젝트의 API entries.write 요청 수를 제한하지 않습니다. 이 변경사항은 격리를 개선하고 수집 오버로드로부터 리전별 리소스를 보호하기 위함입니다.

다음 표에는 각 리전의 기본 할당량이 나와 있습니다.

수집 리전 기본값
asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1 Google Cloud 프로젝트별 분당 4.8GB
나머지 모든 리전 Google Cloud 프로젝트별 분당 300MB

리전 할당량의 기본값은 대부분의 사용자의 수집량을 초과합니다. 하지만 2025년 4월 22일 이전의 지난 6개월 이상 동안 특정 리전의 프로젝트 수집량이 해당 리전의 기본 할당량에 근접하거나 초과하면 초기 할당량에 일회성 자동 증가가 포함됩니다. 따라서 할당량이 위 표의 기본값보다 클 수 있습니다.

2025년 4월 22일 이전에는 리전 할당량을 검토할 수 있지만 이 날짜 이후에 할당량이 적용됩니다. 할당량 검토에 대한 자세한 내용은 Logging 할당량 검토를 참조하세요.

2025년 4월 22일 이후에는 entries.write 요청 수에 대한 할당량이 무제한으로 변경됩니다.

2025년 4월 22일 이후에 리전 할당량을 초과하면 Cloud Logging API에 대한 쓰기 요청이 '리소스 부족' 오류 메시지가 표시되면서 거부될 수 있습니다. 할당량 초과를 방지하는 데 도움이 되는 권장사항은 Logging 할당량 관리 및 모니터링을 참조하세요.

Cloud Logging API 할당량 검토

Cloud Logging API 할당량을 검토하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 할당량 및 시스템 한도 페이지로 이동합니다.

    할당량 및 시스템 한도로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 IAM 및 관리자인 결과를 선택합니다.

  2. Cloud Logging API 서비스의 할당량 목록을 필터링합니다.

Cloud Logging API 할당량 변경 요청

Google Cloud 콘솔을 사용하여 더 높거나 더 낮은 Logging API 한도를 요청할 수 있습니다. 자세한 내용은 할당량 보기 및 관리를 참조하세요.

Edit is not allowed for this quota 오류가 발생하면 지원팀에 문의하여 할당량 변경을 요청할 수 있습니다. 또한 체크박스를 클릭하려면 Google Cloud 프로젝트에서 청구가 사용 설정되어 있어야 합니다.

Cloud Logging API 할당량 관리 및 모니터링

할당량 초과로 인한 서비스 중단을 방지하려면 다음을 수행하면 됩니다.

  • 자동 할당량 조정을 사용하여 할당량 사용량을 모니터링하고 자동으로 할당량 상향 조정을 요청합니다. 자세한 내용은 할당량 조정자를 참조하세요.
  • 할당량에 대한 알림을 만들어 사용량에 대한 알림을 받습니다. 자세한 내용은 할당량 알림 설정을 참조하세요.

entries.list 사용량 최적화

entries.list의 예상 사용량은 일치하는 로그를 검색하는 것입니다. 이 메서드는 대량의 로그 항목을 검색하는 데 적합하지 않습니다. entries.list 할당량이 정기적으로 소진되는 경우 다음 옵션을 고려하세요.

  • Cloud Logging API를 효과적으로 사용하고 있는지 확인합니다. 자세한 내용은 API 사용량 최적화를 참조하세요.

  • 분석하려는 로그 항목이 entries.list 할당량을 초과한다는 것을 알고 있으면 지원되는 대상으로 로그를 내보내도록 로그 싱크를 구성하세요.

  • Logging 외부에서 로그 항목을 분석하려면 Logging에 이미 있는 로그 항목을 Cloud Storage 버킷에 소급하여 복사하면 됩니다. 로그를 Cloud Storage 버킷에 복사하면 Logging 외부의 감사자와 로그 항목을 공유하고 Cloud Storage에서 스크립트를 실행할 수 있습니다.

  • Logging 내에서 로그 항목을 집계하고 분석하려면 로그 항목을 로그 버킷에 저장한 후 로그 애널리틱스를 사용하도록 로그 버킷을 업그레이드합니다. 이 단계에 대한 자세한 내용은 로그 버킷 구성을 참조하세요.

    로그 애널리틱스를 사용하면 BigQuery 표준 SQL을 사용하여 로그 항목을 쿼리할 수 있습니다.

로그 기반 측정항목

사용자 정의 로그 기반 측정항목 사용 시 다음 한도가 적용됩니다. 측정항목 설명 수를 제외하고 이러한 한도는 고정되어 있습니다. 즉, 늘리거나 줄일 수 없습니다.

카테고리 최댓값
라벨 수 측정항목당 10개
라벨 값의 길이 1,024 B
라벨 설명의 길이 800 B
필터 길이1 20,000자
측정항목 설명자의 길이 8,000 B
측정항목 설명 수 Google Cloud 프로젝트당 500개2
활성 시계열 수3 측정항목당 30,000개
히스토그램 버킷 수 커스텀 배포 측정항목당 200개
데이터 보관 Cloud Monitoring: 데이터 보관을 참조하세요.

1 각 로그 기반 측정항목에는 필터가 포함되어 있습니다. 로그 항목이 필터와 일치하면 로그 항목이 계산됩니다. 필터는 Logging 쿼리 언어를 통해 정의됩니다.
2 이 한도는 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다.
3 시계열은 지난 24시간 내에 작성된 데이터 포인트가 있는 경우에 활성화됩니다.

감사 로깅

감사 로그 최대 크기는 다음 표에 나와 있습니다. 이러한 값을 사용하여 싱크 대상에 필요한 공간을 추정할 수 있습니다.

감사 로그 유형 최대 크기
관리자 활동 512KiB
데이터 액세스 512KiB
시스템 이벤트 512KiB
정책이 거부됨 512KiB

로그 보관 기간

버킷에 포함된 로그 유형 또는 다른 위치에서 복사되었는지에 관계없이 다음 Cloud Logging 보관 기간이 로그 버킷에 적용됩니다. 보관 정보는 다음과 같습니다.

버킷 기본 보관 기간 커스텀 보관
_Required 400일 구성할 수 없음
_Default 30일 구성 가능
사용자 정의 30일 구성 가능

_Default 및 사용자 정의 로그 버킷의 경우 1일~3650일 사이로 로그를 보관하도록 Cloud Logging을 구성할 수 있습니다. 보관 규칙 설정에 대한 자세한 내용은 커스텀 보관 구성을 참조하세요.

가격 책정

Cloud Logging은 로그를 지원되는 대상으로 라우팅하는 데 비용을 청구하지 않지만 대상에 요금이 부과될 수 있습니다. _Required 로그 버킷을 제외하고 Cloud Logging은 로그를 로그 버킷으로 스트리밍하고 로그 버킷의 기본 보관 기간보다 긴 스토리지에 대해 요금을 청구합니다.

Cloud Logging에서는 로그 복사, 로그 범위 또는 분석 뷰 생성, 로그 탐색기 또는 로그 애널리틱스 페이지를 통해 실행되는 쿼리에 대한 요금을 청구하지 않습니다.

자세한 내용은 다음 문서를 참조하세요.