Cloud Trace 會強制執行頻率配額、Span 擷取限制和資料保留期限，具體取決於您是使用 Telemetry (OTLP) API 還是 Cloud Trace API 傳送追蹤記錄資料。瞭解這些門檻有助於監控用量，確保您能持續觀測應用程式。
Trace API 配額和限制
本節說明僅適用於 Trace API 的配額和限制。本節列出的配額和限制不適用於 Telemetry API。
Cloud Trace 設有兩種配額：Cloud Trace API 要求的頻率配額，以及傳送至 Trace 的 Span 擷取配額。
配額
下表摘要說明讀取和寫入作業可用的配額單位，以及 Trace API 擷取 span 的每日配額。舉例來說，GetTrace、ListTraces 和 ListSpan 這三個 API 指令每 60 秒的總配額為 300。以下兩種做法都會完全消耗可用配額單位：
- 每 60 秒發出 12 個
ListTracesAPI 呼叫。 - 每 60 秒發出 10 個
ListTracesAPI 呼叫以及 50 個GetTraceAPI 呼叫。
| 類別 | 配額單位總數 |
|---|---|
| 讀取作業1 | 每 60 秒 300 個 |
| 寫入作業2 | 每 60 秒 4,800 個 |
| 3,4 擷取的 span | 每天 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 擷取的 span。透過 Telemetry API 擷取資料不受限制。4 Cloud Trace API 的每日追蹤記錄 span 擷取配額，取決於您的帳單帳戶記錄和配額提高要求。
限制
下表列出 Cloud Trace API 的限制。
| 說明 | 值 |
|---|---|
每個 GetTrace 呼叫的時距數量上限 |
10,000 |
每個 PatchTraces 呼叫的時距數量上限 |
25,000 |
每個 ListTraces 呼叫的追蹤記錄數量上限 |
ROOTSPAN 和 MINIMAL 檢視畫面：1,000COMPLETE 檢視畫面：100 |
| Span 名稱長度上限 | 1,024 個位元組 |
| 每個 Span 的標籤或屬性數量上限 | 1024 |
| 標籤或屬性的鍵大小上限 | 512 個位元組 |
| 標籤或屬性的值大小上限 | 65,532 位元組 |
| 每個 Span 的事件數量上限 | 256 |
| 可擷取 Span 的過去時間戳記上限 | 14 天 |
| 可擷取 Span 的未來時間戳記上限 | 3 天 |
| 事件相對於時間範圍時間戳記的最早時間戳記 | 365 天 |
超過限制不一定會導致 API 呼叫失敗並發生錯誤。舉例來說，如果附加至 Span 的屬性數量超過 1024 個，系統不會回報錯誤。在這種情況下，Cloud Trace API 會使用非確定性演算法，選取 1024 個屬性來擷取。其餘屬性則會捨棄。
Cloud Trace API 提供 GetTrace、PatchTraces 和 ListTraces 端點的詳細資料。
如何為 Span 加上註解，取決於 Cloud Trace API 端點。如果使用 batchWrite 端點，請將屬性新增至 Span 物件。如果使用 patchTraces 端點，請將標籤新增至 TraceSpan 物件。
Telemetry API 限制和配額
本節列出的限制僅適用於使用 Telemetry API 擷取追蹤記錄資料的情況。Telemetry API 實作 OpenTelemetry OTLP API，專為使用 OpenTelemetry SDK 檢測的應用程式設計。本節列出的限制不適用於 Cloud Trace API。
| 說明 | 值 | 注意事項 |
|---|---|---|
| 屬性鍵大小上限 | 512 位元組 | Limit。 |
| 屬性值的大小上限 | 64 KiB | Limit。 |
Span* 物件名稱的大小上限 |
1024 位元組 | Limit。 |
Span* 物件可附加的屬性數量上限 |
1024 | Limit。 |
每個 ResourceSpans* 物件的資源屬性數量上限 |
1024 | Limit。 |
每個 ResourceSpan* 物件的屬性數量上限包括附加至下列類型子物件的屬性： Resource、Span、ScopeSpans、Event 和 Link. |
8192 | Limit。 |
每個 Span* 物件的 Event* 物件數量上限 |
256 | Limit。 |
每個 Span* 物件的 Link* 物件數量上限 |
128 | Limit。 |
Event* 物件名稱的大小上限 |
1024 位元組 | Limit。 |
每個 Event* 物件的屬性數量上限 |
1024 | Limit。 |
每個Link* 物件的屬性數量上限 |
1024 | Limit。 |
| 結構定義網址大小上限 | 8192 位元組 | Limit。 |
| 每分鐘追蹤記錄擷取位元組數上限 | 下列區域為 2.4 GB： 所有其他區域為 300 MB。 |
配額。 |
trace.proto 檔案。
追蹤記錄範圍限制
| 追蹤記錄範圍限制 | 值 |
|---|---|
| 每項專案的追蹤記錄範圍數量上限 | 100 |
| 每個追蹤記錄範圍的檢視畫面數量上限 | 20 |
追蹤記錄保留期限
| 類別 | 保留期限 |
|---|---|
儲存在 _Trace bucket 中的 span |
30 天 |
管理配額
本節說明如何要求變更配額，以及如何監控配額用量。
要求變更 Cloud Trace API 配額
如要判斷是否能使用 Google Cloud 控制台，要求提高或降低 Cloud Trace API 的配額限制，請前往「Quotas & System Limits」(配額與系統限制) 頁面，搜尋所需配額。
- 如果畫面上列出配額，您可以在該頁面要求變更限制。如要瞭解這些步驟，請參閱「查看及管理配額」。
- 如果未列出配額，或您要求更新配額並收到錯誤
Edit is not allowed for this quota，請與支援團隊聯絡，要求變更配額。您必須先啟用Google Cloud 專案的計費功能，才能在 Google Cloud 控制台編輯配額。
監控配額用量
為確保配額不會用盡，以及應用程式效能觀測能力不會中斷，請務必批次處理更新，並監控配額用量。舉例來說，您可以建立警告政策，在用量超過門檻時通知您。如要進一步瞭解監控 API 要求的詳細資訊及相關回應，請參閱監控您的 API 使用量一文。
如要查看 Cloud Trace API 和每日 span 擷取配額，請參閱「查看及管理配額」。
如要瞭解如何減少 API 配額單位和每日 span 擷取配額單位，請參閱「設定用量上限」。
如要申請提高 API 配額單位或每日 span 擷取配額，請參閱「要求更多配額」。
如要進一步瞭解如何建立警告政策，監控 Trace API 配額和速率追蹤記錄 span 擷取，請參閱「建立超出配額警告」。
大量查詢
如要大量查詢追蹤記錄資料，請建立連結的 BigQuery 資料集，然後使用 BigQuery API。
請勿使用 Cloud Trace API 執行大量查詢，因為 Trace API 的呼叫次數會受到頻率限制。