Cloud Trace는 원격 분석 (OTLP) API 또는 Cloud Trace API 중 어떤 API를 사용하여 Google Cloud 프로젝트로 trace 데이터를 전송하는지에 따라 비율 할당량, 스팬 수집 한도, 데이터 보관 기간을 적용합니다. 원격 분석 API는 OpenTelemetry OTLP 사양을 구현하고 오픈소스 OpenTelemetry 생태계와의 호환성을 높입니다.
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 탐색기를 사용하여 트레이스를 쿼리하고 보는 것은 이 할당량을 사용하지 않습니다.
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 호출이 실패하지 않을 수 있습니다. 예를 들어 스팬에 연결된 속성 수가 1024개를 초과해도 오류가 보고되지 않습니다. 대신 이 시나리오에서 Cloud Trace API는 비결정적 알고리즘을 사용하여 수집할 1024개의 속성을 선택합니다. 나머지 속성은 삭제됩니다.
Cloud Trace API는 GetTrace, PatchTraces, ListTraces 엔드포인트에 관한 세부정보를 제공합니다.
스팬에 주석을 추가하는 방법은 Cloud Trace API 엔드포인트에 따라 다릅니다. batchWrite 엔드포인트를 사용하는 경우 Span 객체에 속성을 추가합니다. patchTraces 엔드포인트를 사용하는 경우 TraceSpan 객체에 라벨을 추가합니다.
Telemetry API 한도 및 할당량
이 섹션에는 Telemetry API를 사용하여 trace 데이터를 수집할 때만 적용되는 한도가 나와 있습니다. OpenTelemetry OTLP API를 구현하는 원격 분석 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바이트 | 한도 |
| 분당 최대 추적 수집 바이트 수 | 다음 지역의 경우 2.4GB: 다른 모든 지역의 경우 300MB입니다. |
할당량입니다. |
trace.proto 파일을 참고하세요.
trace 범위 제한
| trace 범위 제한 | 값 |
|---|---|
| 프로젝트당 최대 추적 범위 수 | 100 |
| 트레이스 범위당 최대 뷰 수 | 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를 사용하지 마세요.