Cloud Trace 會根據您用來將追蹤資料傳送至 Google Cloud 專案的 API (遙測 (OTLP) API 或 Cloud Trace API)，強制執行頻率配額、時距擷取限制和資料保留期限。Telemetry API 會實作 OpenTelemetry OTLP 規格，並與開放原始碼 OpenTelemetry 生態系統提供更高的相容性。
追蹤 Trace API 配額和限制
本節提供僅適用於 Trace API 的配額和限制相關資訊。本節列出的配額和限制不適用於 Telemetry API。
Cloud Trace 會強制執行兩種配額：Cloud Trace API 要求的頻率配額，以及傳送至 Trace 的時距擷取配額。
配額
下表彙整讀取和寫入作業可用的配額單位，以及 Trace API 擷取範圍的每日配額。舉例來說，這三個 API 指令 (GetTrace、ListTraces 和 ListSpan) 的總數為每 60 秒 300 個。以下兩種做法都會完全消耗可用配額單位：
- 每 60 秒發出 12 個
ListTracesAPI 呼叫。 - 每 60 秒發出 10 個
ListTracesAPI 呼叫以及 50 個GetTraceAPI 呼叫。
| 類別 | 配額單位總數 |
|---|---|
| 讀取作業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 Explorer 查詢及查看追蹤記錄，不會消耗這項配額。
2 寫入作業包括 PatchTraces、BatchWrite 和 CreateSpan。每項寫入作業會消耗 1 個配額單位。
3 這項配額僅適用於使用 Cloud Trace API 擷取的範圍。
透過 Telemetry API 擷取資料不受限制。
4 Cloud Trace API 的每日追蹤時距擷取配額，取決於您的帳單帳戶記錄，以及您提出的配額增加要求。
限制
下表列出 Cloud Trace API 的限制。
| 說明 | 值 |
|---|---|
每個 GetTrace 呼叫的時距數量上限 |
10,000 |
每個 PatchTraces 呼叫的時距數量上限 |
25,000 |
每個 ListTraces 呼叫的追蹤記錄數量上限 |
ROOTSPAN 和 MINIMAL 檢視畫面中的 1,000 個COMPLETE 檢視畫面中的 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 擷取追蹤記錄資料時適用的限制。Telemetry API 會實作 OpenTelemetry OTLP API，專為搭配使用OpenTelemetry SDK 檢測的應用程式而設計。本節列出的限制不適用於 Cloud Trace API。
| 說明 | 值 | 注意事項 |
|---|---|---|
| 屬性鍵大小上限 | 512 位元組 | 限制。 |
| 屬性值大小上限 | 64 KiB | 限制。 |
Span* 物件名稱大小上限 |
1024 位元組 | 限制。 |
附加至 Span* 物件的屬性數量上限 |
1024 | 限制。 |
每個 ResourceSpans* 物件的資源屬性數量上限 |
1024 | 限制。 |
每個 ResourceSpan* 物件的屬性數量上限包括附加至下列類型子物件的屬性： Resource、Span、ScopeSpans、
Event 和 Link. |
8192 | 限制。 |
每個 Span* 物件的 Event* 物件數量上限 |
256 | 限制。 |
每個 Span* 物件的 Link* 物件數量上限 |
128 | 限制。 |
Event* 物件名稱大小上限 |
1024 位元組 | 限制。 |
每個 Event* 物件的屬性數量上限 |
1024 | 限制。 |
每個 Link* 物件的屬性數量上限 |
1024 | 限制。 |
| 結構化資料網址大小上限 | 8192 個位元組 | 限制。 |
| 每分鐘的追蹤擷取位元組數上限 | 下列區域為 2.4 GB： 所有其他地區為 300 MB。 |
配額。 |
trace.proto 檔案。
追蹤記錄範圍限制
| 追蹤記錄範圍限制 | 值 |
|---|---|
| 每項專案的追蹤記錄範圍數量上限 | 100 |
| 每個追蹤記錄範圍的檢視畫面數量上限 | 20 |
追蹤記錄保留期限
| 類別 | 保留期限 |
|---|---|
儲存在 _Trace bucket 中的範圍 |
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 配額和追蹤記錄時距的擷取頻率。
大量查詢
如要大量查詢追蹤記錄資料，請建立連結的 BigQuery 資料集，然後使用 BigQuery API。
請勿使用 Cloud Trace API 進行大量查詢，因為對 Trace API 的呼叫會受到速率限制。