할당량 및 한도

이 페이지에서는 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 일 후
리소스당 로그 범위 수7 100
로그 범위에 포함된 로그 뷰 및 프로젝트 수7 100
로그 범위에 포함된 프로젝트 수7 5

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.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로 나열됩니다.

Cloud Logging API 할당량 변경 요청

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

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

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은 로그 복사, 로그 범위 정의, 로그 탐색기 또는 로그 애널리틱스 페이지를 통해 실행되는 쿼리에 대해 요금을 부과하지 않습니다.

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