Cloud Trace는 API 요청에 대한 비율 할당량과 사용자가 Trace에 전송하는 스팬에 대한 수집 할당량이라는 2가지 유형의 할당량을 적용합니다.
Trace 할당량
다음 표에는 읽기 및 쓰기 작업에 사용할 수 있는 할당량 단위와 스팬 수집에 사용되는 일일 할당량이 요약되어 있습니다. 예를 들어 3개의 API 명령어(GetTrace, ListTraces, ListSpan)에 60초당 총 300개의 할당량이 적용됩니다. 다음은 사용 가능한 모든 할당량 단위를 사용하는 방법의 2가지 예시입니다.
60초당 ListTraces API 호출을 12회 합니다.
60초당 ListTraces API 호출은 10회, GetTrace API 호출은 50회 합니다.
카테고리
총 할당량 단위
읽기 작업1
60초당 300회
쓰기 작업2
60초당 4,800회
수집된 스팬3
3,000,000개/일~5,000,000,000개/일
1 읽기 작업에는 GetTrace, ListTraces, ListSpan이 포함됩니다. ListTraces를 호출하면 할당량 단위 25개가 사용됩니다. GetTrace를 호출하면 ListSpan 할당량 단위 1개가 사용됩니다. 2 쓰기 작업에는 PatchTraces, BatchWrite, CreateSpan이 포함됩니다. 각 쓰기 작업은 할당량 단위 1개를 사용합니다. 3 일일 trace 스팬 수집 할당량은 결제 계정 내역 및 할당량 상향 조정 요청에 따라 결정됩니다.
Cloud Trace API v2 batchWrite를 사용하는 경우 attributes 객체를 만들고 Span 객체에 연결하여 스팬에 주석을 추가할 수 있습니다. 마찬가지로 labels 객체를 만들고 Cloud Trace API v1 patchTraces 메서드를 사용할 때 TraceSpan 객체에 연결하여 스팬에 주석을 추가할 수 있습니다.
이 섹션에서는 할당량 변경을 요청하는 방법과 할당량 사용량을 모니터링하는 방법을 설명합니다.
Cloud Trace API 할당량 변경 요청
Google Cloud 콘솔을 사용하여 더 높거나 더 낮은 Cloud Trace API 한도를 요청할 수 있습니다.
자세한 내용은 할당량 보기 및 관리를 참조하세요.
Edit is not allowed for this quota 오류가 발생하면 지원팀에 문의하여 할당량 변경을 요청할 수 있습니다. 또한 체크박스를 클릭하려면 Google Cloud 프로젝트에서 청구가 사용 설정되어 있어야 합니다.
할당량 사용량 모니터링
할당량을 소진하지 않고 앱 성능에 대한 관찰 가능성을 계속 유지하기 위해 업데이트를 일괄 처리하고 할당량 사용량을 모니터링해야 합니다. 예를 들어 사용량이 기준점을 초과하면 알려주는 알림 정책을 만들 수 있습니다.
API 요청 모니터링 및 응답에 대한 자세한 내용은 API 사용량 모니터링을 참조하세요.
Cloud Trace API 및 일일 스팬 수집 할당량을 보려면 할당량 보기 및 관리를 참조하세요.
API 할당량 단위 및 일일 스팬 수집 할당량 단위를 줄이는 방법은 사용량 상한 설정을 참조하세요.
API 할당량 단위 또는 일일 스팬 수집 할당량을 상향 요청하려면 추가 할당량 요청을 참조하세요.
Trace API 할당량 및 비율 trace 스팬 수집을 모니터링하는 알림 정책 생성에 대한 자세한 내용은 할당량 초과 알림 만들기를 참조하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-12-17(UTC)"],[],[],null,["# Quotas and limits\n\nTo send trace data to your Google Cloud project you can use the\n[Telemetry (OTLP) API](/stackdriver/docs/reference/telemetry/overview) or the\n[Cloud Trace API](/trace/api).\nThe Telemetry API implements the OpenTelemetry OTLP API, and it provides greater\ncompatibility and support for the open source OpenTelemetry ecosystem. The\nTrace API is a proprietary Google Cloud API which\npredates support for the Telemetry API. The limits for the\nTelemetry API are often more generous than for the Trace API.\n\nTrace API quotas and limits\n---------------------------\n\nThis section provides information about quotas and limits that apply only\nto the Trace API. The quotas and limits listed in this section\ndon't apply to the Telemetry API.\n\nCloud Trace enforces two different types of quotas:\na rate quota on your Cloud Trace API requests and an ingestion quota on spans you\nsend to Trace.\n\n### Quotas\n\nThe following table summarizes the quota units available for read and write\noperations, and the daily quota for ingesting spans for the\nTrace API. For example,\nyou have a total of 300 per 60 seconds for the three API\ncommands `GetTrace`, `ListTraces`, and `ListSpan`. Here are two different\nexamples of how you could use all of the available quota units:\n\n- Make 12 `ListTraces` API calls per 60 seconds.\n- Make 10 `ListTraces` API calls and 50 `GetTrace` API calls per 60 seconds.\n\n^1^ Read operations include `GetTrace`, `ListTraces`, `ListSpan`. A call to `ListTraces` consumes 25 quota units. Calls to `GetTrace` consume `ListSpan` 1 quota unit. \n^2^ Write operations include `PatchTraces`, `BatchWrite`, and `CreateSpan`. Each write operation consumes 1 quota unit. \n^3^ Your daily trace span ingestion quota is determined by your billing account history and requests you have made for quota increases.\n\n### Limits\n\nThis table lists the limits for the Cloud Trace API.\n\nExceeding a limit might not result in an API call failing with an error.\nFor example, an error isn't reported when the number of attributes attached\na span exceeds 32. Instead, in this scenario,\nthe Cloud Trace API uses a non-deterministic algorithm to select\n32 attributes to ingest. The remaining\nattributes are discarded.\n\nThe [Cloud Trace API](/trace/api) provides details about the\n[`GetTrace`](/trace/docs/reference/v1/rest/v1/projects.traces/get), [`PatchTraces`](/trace/docs/reference/v1/rest/v1/projects/patchTraces), and\n[`ListTraces`](/trace/docs/reference/v1/rest/v1/projects.traces/list) endpoints.\n\nHow you annotate spans depends on the Cloud Trace API endpoint. If you use the\n`batchWrite` endpoint, then add attributes to the\n[`Span`](/trace/docs/reference/v2/rest/v2/projects.traces/batchWrite#Span) object. If you use the\n`patchTraces` endpoint, then add labels to the\n[`TraceSpan`](/trace/docs/reference/v1/rest/v1/projects.traces#TraceSpan) object.\n\nTelemetry API limits\n--------------------\n\nThis section lists the limits that apply only when the\n[Telemetry API](/stackdriver/docs/reference/telemetry/overview) is used to ingest trace data.\nThe Telemetry API, which implements the OpenTelemetry OTLP API, is\ndesigned for use with applications that are instrumented by using one of\nthe [OpenTelemetry SDKs](https://opentelemetry.io/docs/languages/). The limits listed in this section\ndon't apply to the Cloud Trace API.\n\n^\\*^ For a definition of this structure, see the [OpenTelemetry `trace.proto`](https://github.com/open-telemetry/opentelemetry-proto/blob/v1.5.0/opentelemetry/proto/trace/v1/trace.proto).\n\nLimits on trace scopes\n----------------------\n\nTrace retention periods\n-----------------------\n\nManage your quota\n-----------------\n\nThis section describes how to request a change in a quota and how to monitor\nyour quota usage.\n\n### Request changes to Cloud Trace API quota\n\nYou can request higher or lower Cloud Trace API limits using the\nGoogle Cloud console.\nFor more information, see [View and manage quotas](/docs/quotas/view-manage).\n\nIf you get an error `Edit is not allowed for this quota`, you can\n[contact Support](/stackdriver/docs/getting-support) to request changes to\nthe quota. Note also that billing must be enabled on the\nGoogle Cloud project to click the checkboxes.\n\n### Monitor you quota usage\n\nTo make sure that you don't run out of quota and lose observability into your\napps' performance, ensure that you batch your updates and monitor your\nquota usage. For example, you might create an alerting policy that notifies\nyou when your usage exceeds a threshold.\nFor detailed information on monitoring your API requests and\nunderstanding their responses, see\n[Monitoring your API usage](/apis/docs/monitoring).\n\n- To view your **Cloud Trace API** and your daily span\n ingestion quotas, see [View and manage quotas](/docs/quotas/view-manage).\n\n- To learn how to decrease your API quota units and your daily span\n ingestion quota units, see [Capping usage](/docs/quotas/view-manage#capping_usage).\n\n- To request an increase in your API quota\n units or your daily span ingestion quotas, see\n [Request more quota](/trace/docs/quotas#more-quota).\n\n- See [Creating an over-quota alert](/trace/docs/trace-alerting#over-quota-alert)\n for detailed information on creating alerting policies to monitor your\n Trace API quota and your rate trace span ingestion."]]
