配額與限制

Cloud Trace 強制實行的配額限制分為兩類:一種是 API 要求的頻率配額;另一種則是擷取配額,用來限制您傳送至 Trace 的時距數量。

Trace API 用量限制

API 方法 配額單位總數
GetTrace1
ListTraces2
ListSpan1
每 60 秒 300 個
PatchTraces1
BatchWriteSpans1
CreateSpan1
每 60 秒 4,800 個

1 每個 API 呼叫都會耗用 1 個配額單位。
2 每項 API 呼叫都會耗用 25 個配額單位。

GetTraceListTracesListSpan 這三個 API 指令來說,您每 60 秒共有 300 個配額單位。以下兩種做法都會完全消耗可用配額單位:

  • 每 60 秒發出 12 個 ListTraces API 呼叫。
  • 每 60 秒發出 10 個 ListTraces API 呼叫以及 50 個 GetTrace API 呼叫。

Cloud Trace API 的額外限制與數量上限如下:

限制與上限
每個 GetTrace 呼叫的時距數量上限 1,000
每個 PatchTraces 呼叫的時距數量上限 25,000
每個 ListTraces 呼叫的追蹤記錄數量上限 在 ROOTSPAN/Minimal 檢視表中為 1,000
在 COMPLETE 檢視表中為 100
每項追蹤記錄的時距數量上限 1,000
每項追蹤記錄的位元組數量上限 50 MB
每個時距的標籤/屬性數量上限 32
每個標籤/屬性的金鑰大小 128 個位元組
每個標籤/屬性的值大小 256 個位元組

申請提高 Cloud Trace API 配額

您可以透過 Google Cloud Console 要求放寬 Cloud Trace API 的限制,步驟如下:

  1. 配額頁面,使用核取方塊選取 [Cloud Trace API],然後按一下 [編輯配額]

    您必須先啟用專案的帳單功能,才能勾選核取方塊。

  2. 在「編輯配額」面板中,填妥表單中的「姓名」、「電子郵件」及「電話」等詳細資料,然後按一下 [下一步]

  3. 在「編輯配額」面板中選取服務來展開檢視畫面,然後按照您要求的配額上限在該項服務中編輯配額。然後按一下 [完成]

  4. 按一下 [提交要求]

本頁說明的其他限制為固定限制。

詳請請參閱處理配額一文。

Trace 每日時距擷取限制

每日追蹤記錄中的時距擷取配額,是依據帳單帳戶記錄以及您所提出的配額增加要求而配置。配額分配範圍如下表所示:

類別 配額單位數
可擷取的時距數 每天 3,000,000 - 5,000,000,000 個

配額對計費方式會造成什麼影響?

系統會依據已擷取和掃描的 Trace 時距計算 Cloud Trace 費用。擷取反映的是 Trace 接收的時距數;掃描反映的是由儲存空間擷取的時距數。

每日時距配額定義了可擷取的時距數量限制,如果超出限制就會發生資源用盡錯誤,導致 API 呼叫失敗。API 頻率配額則限制了 API 呼叫的頻率,如果超出限制就會發生資源用盡錯誤,導致 API 呼叫失敗。

每個 API 呼叫都會耗用 API 配額,而每個寫入 API 呼叫同時也會耗用每日時距擷取配額。舉例來說,如要修補 10,000 個時距,您可以:

  • 傳送一個包含 10,000 個時距的 patchTraces 要求。

  • 傳送 10,000 個各自包含 1 個時距的 patchTraces 要求,並在數分鐘內分批發布這些要求,避免超出 API 配額限制。

第一種方式只會使用 1 個 API 配額單位,第二種方式則須使用 10,000 個 API 配額單位。這兩種方式都會使用 10,000 個每日時距擷取配額單位,所需費用也相同,因為計費依據為擷取的時距數量,而非 API 呼叫數量。

追蹤記錄保留期限

類別 保留期限
所有追蹤記錄時距資料 30 天
分析報表 30 天

管理配額

為了確保您未超出用量配額,並全面掌控您的應用程式效能,請定期查看配額用量或建立快訊政策。如要進一步取得監控 API 要求的詳細資訊並瞭解相關回應,請參閱監控您的 API 使用量一文。

  • 請參閱查看配額一節,瞭解如何查看 Cloud Trace API 配額和每日時距擷取配額。

  • 請參閱設定使用量上限一節,瞭解如何調降 API 配額和每日時距擷取配額的單位數。

  • 請參閱要求增加配額一節,瞭解如何申請提高 API 配額單位和每日時距擷取配額。

  • 請參閱建立超過配額快訊一節,進一步瞭解如何建立快訊政策,方便您監控 Trace API 配額和追蹤記錄時距的擷取頻率。