Cloud Trace는 Telemetry (OTLP) API 또는 Cloud Trace API를 사용하여 trace 데이터를 전송하는지 여부에 따라 비율 할당량, 스팬 수집 한도, 데이터 보관 기간을 적용합니다. 이러한 기준점을 이해하면 사용량을 모니터링하여 애플리케이션에 대한 모니터링 가능성을 유지할 수 있습니다.
Trace API 할당량 및 한도
이 섹션에서는 Trace API에만 적용되는 할당량 및 한도에 대한 정보를 제공합니다. 이 섹션에 나열된 할당량 및 한도는 Telemetry API에 적용되지 않습니다.
Cloud Trace는 Cloud Trace API 요청에 대한 비율 할당량과 사용자가 Trace에 전송하는 스팬에 대한 수집 할당량이라는 2가지 유형의 할당량을 적용합니다.
할당량
다음 표에는 읽기 및 쓰기 작업에 사용할 수 있는 할당량 단위와 Trace API의 스팬 수집에 사용되는 일일 할당량이 요약되어 있습니다. 예를 들어 3개의 API 명령어(GetTrace, ListTraces, ListSpan)에 60초당 총 300개의 할당량이 적용됩니다. 다음은 사용 가능한 모든 할당량 단위를 사용하는 방법의 2가지 예시입니다.
- 60초당
ListTracesAPI 호출을 12회 합니다. - 60초당
ListTracesAPI 호출은 10회,GetTraceAPI 호출은 50회 합니다.
| 카테고리 | 총 할당량 단위 |
|---|---|
| 읽기 작업1 | 60초당 300회 |
| 쓰기 작업2 | 60초당 4,800회 |
| 수집된 스팬3,4 | 3,000,000개/일~5,000,000,000개/일 |
1 읽기 작업에는 GetTrace, ListTraces, ListSpan이 포함됩니다. ListTraces를 호출하면 할당량 단위 25개가 사용됩니다. GetTrace를 호출하면 ListSpan 할당량 단위 1개가 사용됩니다. Google Cloud 콘솔에서 Trace 탐색기를 사용하여 trace를 쿼리하고 확인하는 경우에는 이 할당량이 사용되지 않습니다.
2 쓰기 작업에는 PatchTraces, BatchWrite, CreateSpan이 포함됩니다. 각 쓰기 작업은 할당량 단위 1개를 사용합니다.
3 이 할당량은 Cloud Trace API를 사용하여 수집된 스팬에만 적용됩니다.
Telemetry API를 통한 수집은 제한되지 않습니다.
4 Cloud Trace API의 일일 trace 스팬 수집 할당량은 결제 계정 내역 및 할당량 상향 조정 요청에 따라 결정됩니다.
한도
이 표에는 Cloud Trace API의 한도가 나와 있습니다.
| 설명 | 값 |
|---|---|
GetTrace 호출당 최대 스팬 수 |
10,000 |
PatchTraces 호출당 최대 스팬 수 |
25,000 |
ListTraces 호출당 최대 trace 수 |
ROOTSPAN 및 MINIMAL 뷰에서 1,000COMPLETE 뷰에서 100 |
| 최대 스팬 이름 길이 | 1,024바이트 |
| 스팬당 최대 라벨 또는 속성 수 | 1024 |
| 라벨 또는 속성 키의 최대 크기 | 512바이트 |
| 최대 라벨 또는 속성 값 크기 | 65,532바이트 |
| 스팬당 최대 이벤트 수 | 256 |
| 수집할 스팬의 최대 과거 타임스탬프 | 14일 |
| 수집할 스팬의 최대 미래 타임스탬프 | 3일 |
| 스팬 타임스탬프 기준 이벤트의 최대 과거 타임스탬프 | 365일 |
한도를 초과해도 API 호출이 오류로 인해 실패하지 않을 수 있습니다. 예를 들어 스팬에 연결된 속성 수가 1, 024개를 초과하면 오류가 보고되지 않습니다. 대신 이 시나리오에서는 Cloud Trace API가 비결정적 알고리즘을 사용하여 수집할 속성 1,024개를 선택합니다. 나머지 속성은 삭제됩니다.
Cloud Trace API는 GetTrace, PatchTraces, ListTraces 엔드포인트에 대한 세부정보를 제공합니다.
스팬에 주석을 추가하는 방법은 Cloud Trace API 엔드포인트에 따라 다릅니다. batchWrite 엔드포인트를 사용하는 경우 Span 객체에 속성을 추가합니다. patchTraces 엔드포인트를 사용하는 경우 TraceSpan 객체에 라벨을 추가합니다.
Telemetry API 한도 및 할당량
이 섹션에는 Telemetry API를 사용하여 trace 데이터를 수집할 때만 적용되는 한도가 나와 있습니다. OpenTelemetry OTLP API를 구현하는 Telemetry API는 OpenTelemetry SDK 중 하나를 사용하여 계측된 애플리케이션에서 사용하도록 설계되었습니다. 이 섹션에 나열된 한도는 Cloud Trace API에 적용되지 않습니다.
| 설명 | 값 | 참고 |
|---|---|---|
| 속성 키의 최대 크기 | 512바이트 | 한도 |
| 속성 값의 최대 크기 | 64KiB | 제한 |
Span* 객체 이름의 최대 크기 |
1,024바이트 | 한도 |
Span* 객체에 연결된 최대 속성 수 |
1024 | 제한 |
ResourceSpans* 객체당 최대 리소스 속성 수 |
1024 | 한도 |
ResourceSpan* 객체당 최대 속성 수다음 유형의 하위 객체에 연결된 속성 포함: Resource, Span, ScopeSpans,
Event, Link. |
8192 | 제한 |
Span* 객체당 최대 Event* 객체 수 |
256 | 제한 |
Span* 객체당 최대 Link* 객체 수 |
128 | 제한 |
Event* 객체 이름의 최대 크기 |
1,024바이트 | 제한 |
Event* 객체당 최대 속성 수 |
1024 | 한도 |
Link* 객체당 최대 속성 수 |
1024 | 제한 |
| 스키마 URL의 최대 크기 | 8,192바이트 | 제한 |
| 분당 최대 trace 수집 바이트 수 | 다음 리전의 경우 2.4GB: 다른 모든 리전의 경우 300MB |
할당량 |
trace.proto 파일을 참조하세요.
trace 범위 한도
| trace 범위 한도 | 값 |
|---|---|
| 프로젝트당 최대 trace 범위 수 | 100 |
| trace 범위당 최대 뷰 수 | 20 |
Trace 보관 기간
| 카테고리 | 보관 기간 |
|---|---|
_Trace 버킷에 저장된 스팬 |
30일 |
할당량 관리
이 섹션에서는 할당량 변경을 요청하는 방법과 할당량 사용량을 모니터링하는 방법을 설명합니다.
Cloud Trace API 할당량 변경 요청
Google Cloud 콘솔을 사용하여 할당량에 대해 더 높거나 더 낮은 Cloud Trace API 한도를 요청할 수 있는지 확인하려면 할당량 및 시스템 한도 페이지로 이동하여 원하는 할당량을 검색합니다.
- 할당량이 나열되어 있으면 해당 페이지를 사용하여 한도 변경을 요청할 수 있습니다. 이러한 단계에 대한 자세한 내용은 할당량 보기 및 관리를 참조하세요.
- 할당량이 나열되지 않거나 할당량 업데이트를 요청하고
Edit is not allowed for this quota오류가 발생하면 Cloud Customer Care에 문의하여 할당량 변경을 요청하세요. Google Cloud 콘솔에서 할당량을 수정하려면Google Cloud 프로젝트에서 결제가 사용 설정되어 있어야 합니다.
할당량 사용량 모니터링
할당량을 소진하지 않고 앱 성능에 대한 모니터링 가능성을 계속 유지하기 위해 업데이트를 일괄 처리하고 할당량 사용량을 모니터링해야 합니다. 예를 들어 사용량이 기준점을 초과하면 알려주는 알림 정책을 만들 수 있습니다. API 요청 모니터링 및 응답에 대한 자세한 내용은 API 사용량 모니터링을 참조하세요.
Cloud Trace API 및 일일 스팬 수집 할당량을 보려면 할당량 보기 및 관리를 참조하세요.
API 할당량 단위 및 일일 스팬 수집 할당량 단위를 줄이는 방법은 사용량 상한 설정을 참조하세요.
API 할당량 단위 또는 일일 스팬 수집 할당량을 상향 요청하려면 추가 할당량 요청을 참조하세요.
Trace API 할당량 및 비율 trace 스팬 수집을 모니터링하는 알림 정책 생성에 대한 자세한 내용은 할당량 초과 알림 만들기를 참조하세요.
대용량 쿼리
추적 데이터를 대량으로 쿼리하려면 연결된 BigQuery 데이터 세트를 만든 후 BigQuery API를 사용합니다.
Trace API 호출은 비율이 제한되므로 대량 쿼리에 Cloud Trace API를 사용하지 마세요.