할당량 및 한도

Cloud Trace는 API 요청의 비율 할당량과 사용자가 Trace에 전송하는 스팬에 대한 수집 할당량이라는 2가지 유형의 할당량을 적용합니다.

Trace API 사용량 한도

API 메서드 총 할당량 단위
GetTrace1
ListTraces2
ListSpan1
60초당 300회
PatchTraces1
BatchWriteSpans1
CreateSpan1
60초당 4,800회

1 각 API 호출이 할당량 단위를 1개 사용합니다.
2 각 API 호출이 할당량 단위를 25개 사용합니다.

3개의 API 명령어(GetTrace, ListTraces, ListSpan)에 대해 60초당 총 300개의 할당량 단위가 있습니다. 다음은 사용 가능한 모든 할당량 단위를 사용하는 방법의 2가지 예시입니다.

  • 60초당 ListTraces API 호출을 12회 합니다.
  • 60초당 ListTraces API 호출은 10회, GetTrace API 호출은 50회 합니다.

다음은 Cloud Trace API에 대한 추가 제한 및 한도입니다.

제한 및 한도
GetTrace 호출당 최대 스팬 수 1,000
PatchTraces 호출당 최대 스팬 수 25,000
ListTraces 호출당 최대 trace 수 1,000(ROOTSPAN/최소 뷰)
100(전체 뷰)
Trace당 최대 스팬 수 1,000
trace당 최대 바이트 수 50MB
스팬당 최대 라벨/속성 수 32
라벨/속성당 키 크기 128바이트
라벨/속성당 값 크기 256바이트

추가 Cloud Trace API 할당량 요청

Google Cloud Console을 사용하여 Cloud Trace API 한도 상향을 요청할 수 있습니다.

  1. 할당량 페이지에서 체크박스를 사용하여 Cloud Trace API를 선택한 후 할당량 수정을 클릭합니다.

    체크박스를 클릭하려면 프로젝트에 결제가 사용 설정되어 있어야 합니다.

  2. 할당량 수정 패널에서 이름, 이메일, 전화번호 등의 세부정보로 양식을 작성한 후 다음을 클릭합니다.

  3. 할당량 수정 패널에서 서비스를 선택하여 뷰를 확장한 다음 해당 서비스에서 요청된 한도로 할당량을 수정합니다. 완료를 클릭합니다.

  4. 요청 제출을 클릭합니다.

이 페이지에서 설명하는 다른 한도는 고정된 한도입니다.

자세한 내용은 할당량 작업을 참조하세요.

일일 Trace 스팬 수집 한도

일일 trace 스팬 수집 할당량은 결제 계정 내역 및 할당량 상향 요청에 따라 결정됩니다. 다음 표에서는 할당량 할당의 범위를 나타냅니다.

카테고리 할당량 단위
수집된 스팬 3,000,000개/일 - 5,000,000,000개/일

할당량과 가격의 연관성

Cloud Trace 가격Trace 스팬 수집 및 검색을 바탕으로 책정됩니다. 수집에는 Trace가 받은 스팬 수가 반영됩니다. 검색에는 스토리지에서 검색한 스팬 수가 반영됩니다.

일일 스팬 할당량에 따라 오류를 소진한 리소스로 인해 API 호출이 실패하기 전까지 수집할 수 있는 스팬 수의 한도가 정의됩니다. API 비율 할당량은 리소스 소진 오류로 인해 API 호출이 실패하기 전에 수행할 수 있는 API 호출 비율에 대한 한도를 정의합니다.

API 호출별로 API 할당량이 사용되고, 쓰기 API 호출별로 일일 스팬 수집 할당량이 사용됩니다. 예를 들어, 10,000개의 스팬을 패치해야 하는 경우 다음 작업을 수행할 수 있습니다.

  • 스팬 10,000개를 포함하는 patchTraces 요청 하나를 전송합니다.

  • 스팬을 각각 하나씩 사용하는 10,000개의 patchTraces 요청을 전송하되 API 할당량 한도를 피하기 위해 몇 분에 걸쳐 배포합니다.

첫 번째 방법에서는 1개의 API 할당량 단위를 사용하고 두 번째 방법에서는 10,000개의 API 할당량 단위를 사용한다는 점이 다릅니다. 두 방법 모두 10,000개의 일일 스팬 수집 할당량 단위를 사용합니다. 가격은 API 호출 수가 아닌 수집된 스팬의 수로 결정되기 때문에 두 방법의 가격은 동일합니다.

Trace 보관 기간

카테고리 보관 기간
모든 trace 스팬 데이터 30일
분석 보고서 30일

할당량 관리

할당량을 소진하지 않고 앱 성능을 계속 관찰하기 위해 정기적으로 할당량 사용량을 확인하거나 알림 정책을 만듭니다. API 요청 모니터링 및 응답에 대한 자세한 내용은 API 사용량 모니터링을 참조하세요.

  • Cloud Trace API 및 일일 스팬 수집 할당량을 보려면 할당량 보기를 참조하세요.

  • API 할당량 단위 및 일일 스팬 수집 할당량 단위를 낮추려면 사용량 상한 설정을 참조하세요.

  • API 할당량 단위 또는 일일 스팬 수집 할당량을 높이려면 더 높은 할당량 요청을 참조하세요.

  • Trace API 할당량 및 비율 trace 스팬 수집을 모니터링하는 알림 정책 생성에 대한 자세한 내용은 할당량 초과 알림 만들기를 참조하세요.