trace 데이터를 Google Cloud 프로젝트로 전송하려면 Telemetry (OTLP) API 또는 Cloud Trace API를 사용하면 됩니다. Telemetry API는 OpenTelemetry OTLP API를 구현하며 오픈소스 OpenTelemetry 생태계에 대한 호환성과 지원을 강화합니다. Trace API는 Telemetry API 지원보다 먼저 나온 독점 API입니다. Google Cloud Telemetry API의 한도는 Trace API의 한도보다 더 관대한 경우가 많습니다.
Trace API 할당량 및 한도
이 섹션에서는 Trace API에만 적용되는 할당량과 한도에 대한 정보를 제공합니다. 이 섹션에 나열된 할당량과 한도는 Telemetry API에는 적용되지 않습니다.
Cloud Trace는 2가지 유형의 할당량을 적용합니다. Cloud Trace API 요청의 비율 할당량과 사용자가 Trace에 전송하는 스팬에 대한 수집 할당량입니다.
할당량
다음 표에는 읽기 및 쓰기
작업에 사용할 수 있는 할당량 단위와
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개가 사용됩니다.
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 |
호출당 최대 trace 수ListTraces |
ROOTSPAN 및 MINIMAL 뷰에서 1,000COMPLETE 뷰에서 100 |
| 최대 스팬 이름 길이 | 128바이트 |
| 스팬당 최대 라벨 또는 속성 수 | 32 |
| 라벨 또는 속성 키의 최대 크기 | 128바이트 |
| 최대 라벨 또는 속성 값 크기 | 256바이트 |
| 스팬당 최대 이벤트 수 | 128 |
| 수집할 스팬의 최대 과거 타임스탬프 | 14일 |
| 수집할 스팬의 최대 미래 타임스탬프 | 3일 |
| 스팬 타임스탬프 기준 이벤트의 최대 과거 타임스탬프 | 365일 |
한도를 초과해도 API 호출이 오류와 함께 실패하지 않을 수 있습니다. 예를 들어 스팬에 연결된 속성 수가 32개를 초과해도 오류가 보고되지 않습니다. 대신 이 시나리오에서 Cloud Trace API는 비결정적 알고리즘을 사용하여 수집할 32개의 속성을 선택합니다. 나머지 속성은 삭제됩니다.
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.proto 파일을 참조하세요.
trace 범위 한도
| trace 범위 한도 | 값 |
|---|---|
| 프로젝트당 최대 trace 범위 수 | 100 |
| trace 범위당 최대 프로젝트 수 | 20 |
Trace 보관 기간
| 카테고리 | 보관 기간 |
|---|---|
| Cloud Trace에서 저장되는 스팬 데이터 | 30일 |
_Trace 버킷 |
30일 |
할당량 관리
이 섹션에서는 할당량 변경을 요청하는 방법과 할당량 사용량을 모니터링하는 방법을 설명합니다.
Cloud Trace API 할당량 변경 요청
콘솔을 사용하여 더 높거나 더 낮은 Cloud Trace API 한도를 요청할 수 있습니다. Google Cloud 자세한 내용은 할당량 보기 및 관리를 참조하세요.
Edit is not allowed for this quota 오류가 발생하면 지원팀에 문의하여 할당량 변경을 요청할 수 있습니다. 또한 체크박스를 클릭하려면
Google Cloud 프로젝트에서 청구가 사용 설정되어 있어야 합니다.
할당량 사용량 모니터링
할당량을 소진하지 않고 앱 성능에 대한 관찰 가능성을 계속 유지하기 위해 업데이트를 일괄 처리하고 할당량 사용량을 모니터링해야 합니다. 예를 들어 사용량이 기준점을 초과하면 알려주는 알림 정책을 만들 수 있습니다. API 요청 모니터링 및 응답에 대한 자세한 내용은 API 사용량 모니터링을 참조하세요.
Cloud Trace API 및 일일 스팬 수집 할당량을 보려면 할당량 보기 및 관리를 참조하세요.
API 할당량 단위 및 일일 스팬 수집 할당량 단위를 줄이는 방법은 사용량 상한 설정을 참조하세요.
API 할당량 단위 또는 일일 스팬 수집 할당량을 상향 요청하려면 추가 할당량 요청을 참조하세요.
Trace API 할당량 및 비율 trace 스팬 수집을 모니터링하는 알림 정책 생성에 대한 자세한 내용은 할당량 초과 알림 만들기를 참조하세요.