Cloud Trace는 API 요청에 대한 비율 할당량과 사용자가 Trace에 전송하는 스팬에 대한 수집 할당량이라는 2가지 유형의 할당량을 적용합니다.
Trace 할당량
다음 표에는 읽기 및 쓰기 작업에 사용할 수 있는 할당량 단위와 스팬 수집에 사용되는 일일 할당량이 요약되어 있습니다. 예를 들어 3개의 API 명령어(GetTrace
, ListTraces
, ListSpan
)에 60초당 총 300개의 할당량이 적용됩니다. 다음은 사용 가능한 모든 할당량 단위를 사용하는 방법의 2가지 예시입니다.
- 60초당
ListTraces
API 호출을 12회 합니다. - 60초당
ListTraces
API 호출은 10회,GetTrace
API 호출은 50회 합니다.
카테고리 | 총 할당량 단위 |
---|---|
읽기 작업1 | 60초당 300회 |
쓰기 작업2 | 60초당 4,800회 |
수집된 스팬3 | 3,000,000개/일~5,000,000,000개/일 |
1 읽기 작업에는 GetTrace
, ListTraces
, ListSpan
이 포함됩니다. ListTraces
를 호출하면 할당량 단위 25개가 사용됩니다. GetTrace
를 호출하면 ListSpan
할당량 단위 1개가 사용됩니다.
2 쓰기 작업에는 PatchTraces
, BatchWrite
, CreateSpan
이 포함됩니다. 각 쓰기 작업은 할당량 단위 1개를 사용합니다.
3 일일 trace 스팬 수집 할당량은 결제 계정 내역 및 할당량 상향 조정 요청에 따라 결정됩니다.
Trace 한도
이 섹션에는 Cloud Trace API를 사용할 때 적용되는 한도가 나와 있습니다.
API 메서드 한도
API 메서드 한도 | 값 |
---|---|
GetTrace 호출당 최대 스팬 수 |
1,000 |
PatchTraces 호출당 최대 스팬 수 |
25,000 |
ListTraces 호출당 최대 trace 수 |
ROOTSPAN 및 MINIMAL 뷰에서 1,000COMPLETE 뷰에서 100 |
스팬 한도
스팬 한도 | 값 |
---|---|
최대 스팬 이름 길이 | 128바이트 |
스팬당 최대 라벨 또는 속성 수 | 32 |
라벨 또는 속성 키의 최대 크기 | 128바이트 |
최대 라벨 또는 속성 값 크기 | 256바이트 |
스팬당 최대 이벤트 수 | 128 |
수집할 스팬의 최대 과거 타임스탬프 | 14일 |
수집할 스팬의 최대 미래 타임스탬프 | 3일 |
스팬 타임스탬프 기준 이벤트의 최대 과거 타임스탬프 | 365일 |
Cloud Trace API v2 batchWrite
를 사용하는 경우 attributes
객체를 만들고 Span
객체에 연결하여 스팬에 주석을 추가할 수 있습니다. 마찬가지로 labels
객체를 만들고 Cloud Trace API v1 patchTraces
메서드를 사용할 때 TraceSpan
객체에 연결하여 스팬에 주석을 추가할 수 있습니다.
trace 한도
trace 한도 | 값 |
---|---|
trace당 최대 스팬 수 | 1,000 |
최대 trace 크기 | 50MB |
Trace 보관 기간
카테고리 | 보관 기간 |
---|---|
Cloud Trace에서 저장되는 스팬 데이터 | 30일 |
분석 보고서 | 30일 |
할당량 관리
이 섹션에서는 할당량 변경을 요청하는 방법과 할당량 사용량을 모니터링하는 방법을 설명합니다.
Cloud Trace API 할당량 변경 요청
Google Cloud 콘솔을 사용하여 더 높거나 더 낮은 Cloud Trace API 한도를 요청할 수 있습니다. 자세한 내용은 할당량 보기 및 관리를 참조하세요.
Edit is not allowed for this quota
오류가 발생하면 지원팀에 문의하여 할당량 변경을 요청할 수 있습니다. 또한 체크박스를 클릭하려면 Google Cloud 프로젝트에서 청구가 사용 설정되어 있어야 합니다.
할당량 사용량 모니터링
할당량을 소진하지 않고 앱 성능에 대한 관찰 가능성을 계속 유지하기 위해 업데이트를 일괄 처리하고 할당량 사용량을 모니터링해야 합니다. 예를 들어 사용량이 기준점을 초과하면 알려주는 알림 정책을 만들 수 있습니다. API 요청 모니터링 및 응답에 대한 자세한 내용은 API 사용량 모니터링을 참조하세요.
Cloud Trace API 및 일일 스팬 수집 할당량을 보려면 할당량 보기 및 관리를 참조하세요.
API 할당량 단위 및 일일 스팬 수집 할당량 단위를 줄이는 방법은 사용량 상한 설정을 참조하세요.
API 할당량 단위 또는 일일 스팬 수집 할당량을 상향 요청하려면 추가 할당량 요청을 참조하세요.
Trace API 할당량 및 비율 trace 스팬 수집을 모니터링하는 알림 정책 생성에 대한 자세한 내용은 할당량 초과 알림 만들기를 참조하세요.