如要將追蹤資料傳送至 Google Cloud 專案，可以使用 Telemetry (OTLP) API 或 Cloud Trace API。Telemetry API 會實作 OpenTelemetry OTLP API，並提供更高的相容性，以及對開放原始碼 OpenTelemetry 生態系統的支援。Trace API 是專屬的 Google Cloud API，支援時間早於 Telemetry API。遙測 API 的限制通常比 Trace API 寬鬆。
Trace API 配額與限制
本節提供僅適用於 Trace API 的配額和限制相關資訊。本節列出的配額和限制不適用於 Telemetry API。
Cloud Trace 強制實行的配額限制分為兩類：一種是 Cloud Trace API 要求的頻率配額，另一種則是擷取配額，用來限制傳送至 Trace 的時距數量。
配額
下表摘要列出讀取和寫入作業可用的配額單位，以及 Trace API 的每日時距擷取配額。舉例來說，以 GetTrace、ListTraces 和 ListSpan 這三個 API 指令來說，您每 60 秒共有 300 個配額單位。以下兩種做法都會完全消耗可用配額單位：
- 每 60 秒發出 12 個
ListTracesAPI 呼叫。 - 每 60 秒發出 10 個
ListTracesAPI 呼叫以及 50 個GetTraceAPI 呼叫。
| 類別 | 配額單位總數 |
|---|---|
| 讀取作業1 | 每 60 秒 300 個 |
| 寫入作業2 | 每 60 秒 4,800 個 |
| 擷取的時距數3 | 每天 3,000,000 - 5,000,000,000 個 |
1 讀取作業包括 GetTrace、ListTraces、
ListSpan。呼叫 ListTraces 會耗用 25 個配額單位。呼叫 GetTrace 會耗用 1 個配額單位。ListSpan
2 寫入作業包括 PatchTraces、BatchWrite 和 CreateSpan。每項寫入作業都會耗用 1 個配額單位。
3 每日追蹤記錄時距擷取配額取決於帳單帳戶記錄，以及您提出的配額增加要求。
限制
下表列出 Cloud Trace API 的限制。
| 說明 | 值 |
|---|---|
每個 GetTrace 呼叫的時距數量上限 |
1,000 |
每個 PatchTraces 呼叫的時距數量上限 |
25,000 |
每個 ListTraces 呼叫的追蹤記錄數量上限 |
在 ROOTSPAN 和 MINIMAL 檢視畫面中為 1,000在 COMPLETE 檢視畫面中為 100 |
| 每項追蹤記錄的時距數量上限 | 1,000 |
| 追蹤記錄大小上限 | 50 MB |
| 範圍名稱長度上限 | 128 個位元組 |
| 每個時距的標籤或屬性數量上限 | 32 |
| 標籤或屬性的鍵大小上限 | 128 個位元組 |
| 標籤或屬性的值大小上限 | 256 個位元組 |
| 每個時距的事件數量上限 | 128 |
| 可擷取的時間範圍時間戳記上限 | 14 天 |
| 可擷取的時間範圍未來時間戳記上限 | 3 天 |
| 相對於時距時間戳記的事件時間戳記最久時間 | 365 天 |
超出限制不一定會導致 API 呼叫失敗並傳回錯誤。 舉例來說，如果附加至範圍的屬性數量超過 32 個，系統不會回報錯誤。在此情境中，Cloud Trace API 會改用非決定性演算法，選取要擷取的 32 個屬性。系統會捨棄其餘屬性。
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* 物件名稱大小上限 |
1,024 個位元組 |
附加至 Span* 物件的屬性數量上限 |
1024 |
每個 ResourceSpans* 物件的資源屬性數量上限 |
1024 |
每個 ResourceSpan* 物件的屬性數量上限包括附加至下列類型子項物件的屬性： Resource、Span、ScopeSpans、
Event 和 Link. |
8192 |
每個 Span* 物件的 Event* 物件數量上限 |
256 |
每個 Span* 物件的 Link* 物件數量上限 |
128 |
Event* 物件名稱大小上限 |
1,024 個位元組 |
每個 Event* 物件的屬性數量上限 |
1024 |
每個 Link* 物件的屬性數量上限 |
1024 |
| 結構化資料網址大小上限 | 8192 個位元組 |
trace.proto。
追蹤記錄範圍限制
| 追蹤記錄範圍限制 | 值 |
|---|---|
| 每項專案的追蹤記錄範圍數量上限 | 100 |
| 每個追蹤記錄範圍的專案數量上限 | 20 |
追蹤記錄保留期限
| 類別 | 保留期限 |
|---|---|
| Cloud Trace 儲存的時距資料 | 30 天 |
管理配額
本節說明如何要求變更配額，以及如何監控配額用量。
要求變更 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 配額和追蹤記錄時距的擷取頻率。