할당량 및 한도

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를 선택한 후 할당량 수정을 클릭합니다.

    Edit is not allowed for this quota 오류가 발생하면 지원팀에 문의하여 할당량 변경을 요청할 수 있습니다. 또한 체크박스를 클릭하려면 클라우드 프로젝트에서 청구가 사용 설정되어 있어야 합니다.

  2. 할당량 변경 패널에서 서비스를 선택하여 뷰를 확장한 후 새 한도요청 설명 필드를 입력합니다. 다음을 클릭합니다.

  3. 연락처 세부정보 패널에서 양식을 작성합니다.

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

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

일일 Trace 스팬 수집 한도

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

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

할당량과 가격의 연관성

Cloud Trace 가격은 Trace 스팬 수집 및 스캔을 바탕으로 책정됩니다. 지연 시간 데이터는 스팬으로 구성되는 trace로 패키지화됩니다. 스팬은 Cloud Trace 백엔드가 데이터화하여 Cloud Console에서 데이터를 실시간으로 확인하고 보고할 수 있게 합니다. 추적 데이터를 확인할 때, 저장된 스팬은 가져오기 과정에서 스캔됩니다.

일일 스팬 할당량은 리소스 소진 오류로 인해 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 스팬 수집을 모니터링하는 알림 정책 생성에 대한 자세한 내용은 할당량 초과 알림 만들기를 참조하세요.