이 페이지에서는 Cloud Logging 사용에 적용되는 한도에 대한 세부정보를 제공합니다.
로깅 할당량 및 사용량 한도
다음 표에는 Cloud Logging 사용에 적용되는 할당량과 한도가 나와 있습니다. 일반적으로 할당량 증가를 요청할 수 있습니다. 하지만 한도는 변경할 수 없습니다.
일부 항목은 프로젝트별로 나열되지만 항목이 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아니라고 참고에 표시되어 있습니다. 예를 들어 조직에 여러 Google Cloud 프로젝트가 있는 경우 각 Google Cloud 프로젝트에 최대 200개의 싱크를 구성할 수 있습니다. 해당 조직에 대해 조직 수준에서 최대 200개의 싱크를 구성할 수도 있습니다.
| 카테고리 | 한도 또는 초기 할당량 값의 최댓값 |
참고 |
|---|---|---|
LogEntry 크기 |
256KB | 이 한도는 대략적인 한도로서 실제 REST API 요청 크기가 아닌 내부 데이터 크기를 기반으로 합니다. 늘릴 수 없습니다. |
| 감사 로그 항목 크기 | 512KiB | 늘릴 수 없습니다. |
| 라벨 수 | LogEntry당 64개 |
늘릴 수 없습니다. |
LogEntry 라벨 키 길이 |
512B | Cloud Logging은 연결된 로그 항목이 작성될 때 크기가 초과한 라벨 키를 자릅니다. 늘릴 수 없습니다. |
LogEntry 라벨 값 길이 |
64KB | Cloud Logging은 연결된 로그 항목이 기록될 때 크기가 초과한 라벨 값을 자릅니다. 늘릴 수 없습니다. |
| Logging 쿼리 언어 쿼리 길이 | 20,000자 | 늘릴 수 없습니다. |
| 쿼리 팬아웃 | 버킷 200개 | 이 한도는 리소스의 로그 항목이 포함될 수 있는 최대 버킷 수입니다. 자세한 내용은 쿼리에서 오류 반환을 참고하세요. 늘릴 수 없습니다. 성능상의 이유로 로그 버킷 수를 최소화하고 하나의 리전에 로그 버킷을 만드세요. 서로 다른 리소스에서 생성된 로그 항목을 자주 쿼리해야 하는 경우 로그 항목을 중앙 집중식 로그 버킷 몇 개로 라우팅하는 것이 좋습니다. |
| 싱크 수 | Google Cloud 프로젝트당 200개 | 4,000까지 늘릴 수 있습니다. 이 할당량은 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다. |
| 싱크 포함 필터 길이 | 20,000자 | 늘릴 수 없습니다. |
| 싱크 제외 필터 길이 | 20,000자 | 늘릴 수 없습니다. |
| 제외 필터 수 | 싱크당 50개 | 늘릴 수 없습니다. 제외 필터가 50개를 초과하는 경우 포함 필터를 수정하세요. |
| 로그 버킷 수 | Google Cloud 프로젝트당 100개 | 2,500까지 늘릴 수 있습니다. 이 할당량은 리소스의 로그 항목이 포함될 수 있는 최대 버킷 수이며 삭제 대기 중인 버킷이 포함됩니다. 이 할당량은 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다. 로그 버킷의 최대 수를 늘리면 기본 로그 범위에 프로젝트의 모든 로그 버킷이 포함될 수 없으므로 사용자 환경이 저하될 수 있습니다. |
| 커스텀 색인이 생성된 필드 수 | 로그 버킷당 20개 | 늘릴 수 없습니다. Cloud Logging은 전체 텍스트 색인 생성을 지원합니다. 따라서 맞춤 색인 생성을 정의하지 않는 것이 좋습니다. |
| 로그 뷰 수 | 로그 버킷당 30개 | 단일 로그 버킷에서 1,000개의 로그 뷰로 늘릴 수 있습니다. 로그 뷰의 최대 수를 늘리면 기본 로그 범위에 프로젝트의 모든 로그 버킷이 포함될 수 없으므로 사용자 환경이 저하될 수 있습니다. |
| 로그 버킷에 저장할 수 있는 가장 오래된 타임스탬프 | 로그 버킷의 보관 기간에 따라 결정됩니다. | 기본 보관 기간이 적용된 커스텀 로그 버킷의 경우 이 값은 이전 30일입니다. Logging API는 타임스탬프가 오래된 로그 항목을 허용하며 이러한 로그 항목은 싱크 대상으로 라우팅됩니다. 하지만 타임스탬프가 오래된 로그 항목이 로그 버킷으로 라우팅되면 저장되지 않습니다. |
| 로그 버킷에 저장할 수 있는 향후 타임스탬프 | 최대 1 일 후 | Logging API는 타임스탬프가 향후 1일보다 오래된 항목을 거부하고 INVALID_ARGUMENT 오류를 반환합니다. 늘릴 수 없습니다. |
| 리소스당 로그 범위 수 | 100 | 10,000개까지 늘릴 수 있습니다. |
| 로그 범위에 포함된 로그 뷰 및 프로젝트 수 | 100 | 가능하면 로그 범위에 프로젝트 대신 로그 뷰를 나열하는 것이 좋습니다. 로그 뷰를 나열하면 쿼리 시간이 단축되고 쿼리되는 로그 항목이 명확해집니다. |
| 로그 범위에 포함된 프로젝트 수 | 5 | 가능하면 로그 범위에 프로젝트 대신 로그 뷰를 나열하는 것이 좋습니다. 로그 뷰는 서로 다른 프로젝트에 있을 수 있습니다. |
| Google Cloud 프로젝트당 최대 분석 뷰 수 | 100 | 늘릴 수 없습니다. 이 기능은 공개 미리보기 버전에 있습니다. |
| Google Cloud 프로젝트당 리전별 최대 분석 뷰 수 | 50 | 늘릴 수 없습니다. 이 기능은 공개 미리보기 버전에 있습니다. |
| Google Cloud 프로젝트당 분석 뷰를 저장할 수 있는 최대 리전 수 | 10 | 늘릴 수 없습니다. 이 기능은 공개 미리보기 버전에 있습니다. |
Logging API 할당량 및 한도
Logging API 사용에 다음 한도가 적용됩니다. Logging API 할당량 및 한도 변경을 요청할 수 있습니다. 자세한 내용은 이 페이지의 Cloud Logging API 할당량 변경 요청을 참조하세요.
API 할당량을 보려면 API 대시보드로 이동하여 API를 선택한 후 할당량을 선택합니다.
| 카테고리 | 한도 또는 초기 할당량 값의 최댓값 |
참고 |
|---|---|---|
| API 페이지 토큰의 수명 | 24시간 | 늘릴 수 없습니다. |
| 진행 중인 실시간 테일링 세션 수 | Google Cloud 프로젝트당 10개 | 늘릴 수 없습니다. 이 한도는 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다. |
| 반환된 실시간 테일링 항목 수 | 분당 60,000 | 늘릴 수 없습니다. |
| 제한된 필드 수 | 버킷당 20개 | 늘릴 수 없습니다. |
| 제한된 필드 크기 | 800 B | 늘릴 수 없습니다. |
entries.write 요청 크기 |
10MB | 늘릴 수 없습니다. |
리전별 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 |
할당량 상향 조정을 요청할 수 있습니다. 이 할당량은 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다. 이러한 할당량에 대한 자세한 내용은 리전별 수집 할당량을 참고하세요. 제외 필터를 사용해도 |
entries.list 요청 수 |
프로젝트별 분당 60개 Google Cloud | 늘릴 수 없습니다. 이 한도는 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다. 대량의 로그를 쿼리하려면 BigQuery API를 사용하는 것이 좋습니다. 대량의 로그를 전송하려면 로그 싱크 또는 로그 항목 복사를 사용하는 것이 좋습니다. |
단일 entries.write 명령어의 다양한 리소스 이름 수 |
1000 | 늘릴 수 없습니다. 로그 항목의 |
| 분당 제어 요청 수 | 600 | 늘릴 수 없습니다. 이 할당량은 일일 제어 요청 할당량에 포함된 모든 항목과 함께 로그를 삭제하고 로그 기반 측정항목을 관리하는 API 요청에 적용됩니다. |
| 일일 제어 요청 수 | Google Cloud 프로젝트당 100개 | 늘릴 수 없습니다. 이 할당량은 제외 및 싱크를 만들고 업데이트하기 위한 API 요청에 적용됩니다. |
단일 entries.list 요청의 Google Cloud 프로젝트또는 기타 리소스 이름 수 |
100 | 늘릴 수 없습니다. |
| 동시 복사 작업 수 | Google Cloud 프로젝트당 1개 | 늘릴 수 없습니다. 이 한도는 결제 계정, 폴더, 조직에도 적용되며 계층 구조가 아닙니다. |
| Pub/Sub 주제로 내보내는 비율 | 싱크가 정의된 Google Cloud 프로젝트, 폴더 또는 조직별 분당 60GB | 할당량을 늘리려면 지원 요청을 제출하세요. 할당량 증가는 Pub/Sub 가용성을 기반으로 부여됩니다. 내보내기 비율이 할당량을 초과하면 오류가 로그 항목에 기록됩니다. 요약 필드에 싱크 구성 오류가 있음이 나타나고 오류 코드가 |
리전별 수집 할당량
격리를 개선하고 수집 오버로드로부터 리전별 리소스를 보호하기 위해 Cloud Logging 할당량은Google Cloud 프로젝트별로 수집 리전에 작성된 데이터 양을 제한합니다.
다음 표에는 각 리전의 기본 할당량이 나와 있습니다.
| 수집 리전 | 기본값 |
|---|---|
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 |
리전 할당량의 기본값은 대부분의 사용자의 수집량을 초과합니다. 하지만 할당량이 적용되기 전 지난 6개월 이상 동안 특정 리전의 프로젝트 수집량이 해당 리전의 기본 할당량에 근접하거나 초과하면 초기 할당량에 일회성 자동 증가가 포함됩니다. 따라서 할당량이 위 표의 기본값보다 클 수 있습니다. 할당량 검토에 대한 자세한 내용은 Logging 할당량 검토를 참고하세요.
리전 할당량을 초과하면 Cloud Logging API에 대한 쓰기 요청이 '리소스 부족' 오류 메시지가 표시되면서 거부될 수 있습니다. 할당량 초과를 방지하는 데 도움이 되는 권장사항은 Logging 할당량 관리 및 모니터링을 참고하세요.
Cloud Logging API 할당량 검토
Cloud Logging API 할당량을 검토하려면 다음을 수행합니다.
-
Google Cloud 콘솔에서 할당량 및 시스템 한도 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 IAM 및 관리자인 결과를 선택합니다.
- 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을 구성할 수 있습니다. 보관 규칙 설정에 대한 자세한 내용은 커스텀 보관 구성을 참조하세요.
가격 책정
가격 책정 정보는 Google Cloud Observability 가격 책정 페이지를 참고하세요. 로그 데이터를 다른 Google Cloud 서비스로 라우팅하는 경우 다음 문서를 참고하세요.