이 페이지에서는 Cloud Logging 사용에 적용되는 한도에 대한 세부정보를 제공합니다.
Logging 스토리지의 월별 할당량을 이해하려면 Cloud Logging 가격 책정 요약을 참조하세요.
Logging 가격 책정에 대한 자세한 내용은 Google Cloud 운영 제품군 가격 책정: Cloud Logging을 참조하세요.
Logging 사용량 한도
Cloud Logging 사용 시 다음 한도가 적용됩니다. 로그 버킷 및 싱크의 수에 대한 제한을 제외하고 이러한 한도는 고정되어 있습니다. 즉, 늘리거나 줄일 수 없습니다.
카테고리 | 최댓값 |
---|---|
로그 항목 크기 | 256 KB1 |
감사 로그 항목 크기 | 512KiB |
라벨 수 | 로그 항목당 64개 |
로그 항목 라벨 키의 길이 | 512 B2 |
로그 항목 라벨 값의 길이 | 64 KB2 |
쿼리 길이 | 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 일 후 |
1 실제 REST API 요청 크기가 아닌 내부 데이터 크기를 기반으로 한 대략적인 한도입니다.
2 Cloud Logging은 연결된 로그 항목이 기록될 때 크기가 초과한 라벨 키 및 값을 자릅니다.
3 이 한도는 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다. 예를 들어 조직에 여러 Google Cloud 프로젝트가 있는 경우 각 Google Cloud 프로젝트에 최대 200개의 싱크를 구성할 수 있습니다. 해당 조직에 대해 조직 수준에서 최대 200개의 싱크를 구성할 수도 있습니다.
4 이 한도는 리소스의 로그 항목이 포함될 수 있는 최대 버킷 수입니다. 자세한 내용은 쿼리에서 오류 반환을 참조하세요.
5 이 한도에는 삭제 대기 중인 버킷이 포함됩니다.
6 타임스탬프가 이러한 범위를 벗어나는 로그 항목은 로그 버킷에서 거부됩니다. Logging API는 타임스탬프가 오래된 항목을 허용하며 이러한 항목은 싱크 대상으로 라우팅될 수 있지만 로그 스토리지에 저장되지 않습니다. Logging API는 타임스탬프가 향후 1일보다 오래된 항목을 거부하고 INVALID_ARGUMENT
오류를 반환합니다.
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 프로젝트별 초당 1GB |
1 entries.write
요청 후 로그가 제외되기 때문에 제외 필터를 사용해도 이 숫자는 감소하지 않습니다.
2이 값이 기본 설정입니다.
3 이 한도는 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다.
4 로그 항목의 logName
필드는 로그 항목의 리소스 이름을 지정합니다.
5 일일 제어 요청 할당량은 제외 및 싱크를 만들고 업데이트하기 위한 API 요청에 적용됩니다. 분당 제어 요청 할당량은 일일 제어 요청 할당량에 포함된 모든 항목과 함께 로그를 삭제하고 로그 기반 측정항목을 관리하는 API 요청에 적용됩니다.
6 내보내기 속도가 할당량을 초과하면 오류가 로그 항목에 기록됩니다. 요약 필드는 싱크 구성 오류를 나타내며 오류 코드는 topic_over_quota
로 나열됩니다.
Cloud Logging API 할당량 변경 요청
Google Cloud 콘솔을 사용하여 더 높거나 더 낮은 Logging API 한도를 요청할 수 있습니다.
할당량 페이지에서 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 |
필터 길이 | 20,000자 |
측정항목 설명자의 길이 | 8,000 B |
측정항목 설명 수 | Google Cloud 프로젝트당 500개2 |
활성 시계열 수1 | 측정항목당 30,000개 |
히스토그램 버킷 수 | 커스텀 배포 측정항목당 200개 |
데이터 보관 | Cloud Monitoring: 데이터 보관 참조 |
1 시계열은 지난 24시간 안에 기록된 데이터 포인트가 있는 경우 활성화됩니다.
2 이 한도는 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다.
로그 보관 기간
버킷에 포함된 로그 유형 또는 다른 위치에서 복사되었는지에 관계없이 다음 Cloud Logging 보관 기간이 로그 버킷에 적용됩니다. 보관 정보는 다음과 같습니다.
로그 버킷 | 기본 보관 기간 | 커스텀 보관 |
---|---|---|
_Required |
400일 | 구성할 수 없음 |
_Default |
30일 | 구성 가능 |
사용자 정의 | 30일 | 구성 가능 |
_Default
및 사용자 정의 로그 버킷의 경우 1일~3650일 사이로 로그를 보관하도록 Cloud Logging을 구성할 수 있습니다. 보관 규칙 설정에 대한 자세한 내용은 커스텀 보관 구성을 참조하세요.