配額與限制

本頁面詳細說明 Cloud Logging 的使用限制。

Logging 用量限制

以下限制適用於 Cloud Logging 的用量。除了記錄區塊和接收器數量的限制之外，這些限制都是固定的，您無法增加或減少這些限制。

類別 最大值
LogEntry 的大小 256 KB1
稽核記錄項目大小 512 KiB
標籤數量 每 LogEntry 64 個
LogEntry 標籤鍵的長度 512 B2
LogEntry 標籤值的長度 64 KB2
Logging 查詢語言查詢長度 20,000 個半形字元
查詢扇形展開4 200 個桶
sink 數量 每個 Google Cloud 專案3 200 個
接收器納入篩選器的長度 20,000 個半形字元
接收器排除篩選器的長度 20,000 個半形字元
排除篩選器數 每個接收器 50 個
記錄值區數量 每個 Google Cloud 專案3、4、5：100 個
自訂索引欄位的數量 每個記錄檔值區 20 個
記錄檢視次數 每個記錄檔 bucket 30 個
可儲存在記錄檔值區中的最早時間戳記6 取決於記錄值區的預設保留期限。 如果自訂記錄檔值區採用預設保留期限，則這個值為過去 30 天。
可儲存在記錄檔值區中的未來時間戳記6 最多 1 天
每個資源的記錄範圍數量 100
記錄範圍內的記錄檢視和專案數量 100
記錄範圍內的專案數 5
每個 Google Cloud 專案7的數據分析資料檢視上限 100
每項 Google Cloud 專案，每個區域的資料分析檢視畫面數量上限7 50
每個 Google Cloud 專案可儲存的數據分析檢視區域數量上限：7 10

1 上述限制概略值是以內部資料大小為準，而非實際的 REST API 要求大小。
2 當 Cloud Logging 寫入相關聯的記錄項目時，會截斷過長的標籤鍵和值。
3 這項限制也適用於帳單帳戶、資料夾和機構，且不具階層性質。舉例來說，如果機構內有多個Google Cloud 專案，您可以為每個 Google Cloud 專案設定最多 200 個接收器；對於同一個機構，您也可以在機構層級設定最多 200 個接收器。
4 此限制是可能包含資源記錄項目的值區數量上限。詳情請參閱「查詢傳回錯誤」。
5 這項限制包括待刪除的資料夾。
6 系統會拒絕超出這些範圍的記錄項目。Logging API 會接受較舊時間戳記的項目，這些項目可以路由至接收目的地，但不會儲存在記錄儲存空間中。Logging API 會拒絕時間戳記在未來 1 天以上的項目，並傳回 INVALID_ARGUMENT 錯誤。
7這項功能目前為公開測試版。

Logging API 配額與限制

以下限制適用於您對 Logging API 的使用情形。您可以要求變更 Logging API 配額和限制。如需操作說明，請參閱本頁的「申請變更 Cloud Logging API 配額」一節。

類別 上限
API 使用量 如要查看您的配額，請前往 API 資訊主頁，選取 API，然後選取「配額」。
API 頁面權杖的有效期限 24 小時
執行中即時追蹤工作階段數 每個 Google Cloud 專案3 10 個
傳回的即時追蹤項目數 每分鐘 60,000
受限制的欄位數量 每個值區 20 個
受限制欄位的大小 800 B
entries.write 要求的大小 10 MB
entries.write 要求數量
配額已取代；詳情請參閱 各區域的攝入配額		 每個 Google Cloud 專案1、3每分鐘 120,000 次
entries.write 要求的頻率 (按區域劃分)
新增配額；詳情請參閱 區域內攝入配額		 每分鐘 4.8 GB (每個 Google Cloud 專案)，適用於asia-east1、asia-northeast1、asia-southeast1、asia-south1、europe-west1、europe-west2、europe-west3、europe-west4、us-central1、us-east4、us-west1 1、3

每分鐘 300 MB (每個 Google Cloud 專案)，適用於所有其他區域1、3
entries.list 要求數 每項 Google Cloud 專案2、3 每分鐘 60 次
單一 entries.write 指令中不同資源名稱的數量
4		 1000
每分鐘 5 個控制要求 600
每日控制要求5 次 每項 Google Cloud 專案 1,000 個
單一 entries.list 要求中的 Google Cloud 專案或其他資源名稱數量
 100
並行複製作業數 每 Google Cloud 專案3 個
匯出至 Pub/Sub 主題的速度6 每項 Google Cloud 專案每分鐘 60 GB

1 系統會在收到 entries.write 要求之後才排除記錄檔，因此使用排除篩選器功能不會降低這個數值。
2：這是預設設定。
3 這項限制也適用於帳單帳戶、資料夾和機構，且不具階層性質。
4 記錄項目的 logName 欄位會指定記錄項目的資源名稱。
5 每日控制要求配額適用於建立及更新排除項目和匯出項目的 API 要求。每分鐘控制要求配額適用於每日控制要求配額中包含的所有項目，以及用於刪除記錄和管理以記錄為基礎的評估指標的 API 要求。
6 如果匯出率超出配額，系統會在記錄項目中記錄錯誤。摘要欄位會指出接收器設定錯誤，並列出 topic_over_quota 錯誤代碼。

個別區域的攝入配額

自 2025 年 4 月 22 日起，Cloud Logging 配額將依專案限制寫入擷取區域的資料量。Google Cloud 屆時，Cloud Logging 將停止限制 Google Cloud 專案entries.write的 API 要求數量。這項異動的目的是改善隔離機制，並保護區域資源免於擷取過載。

下表列出各區域的預設配額：

擷取區域 預設值
asia-east1、asia-northeast1、asia-southeast1、asia-south1、europe-west1、europe-west2、europe-west3、europe-west4、us-central1、us-east4、us-west1 每項 Google Cloud 專案每分鐘 4.8 GB
所有其他區域 每項 Google Cloud 專案每分鐘 300 MB

區域配額的預設值超過大多數使用者的擷取量。不過，如果在 2025 年 4 月 22 日前，您專案在某個地區的前六個月或更長時間內的攝取量接近或超過該地區的預設配額，則初始配額會自動增加一次。因此，您的配額可能會高於上表中的預設值。

您可以在 2025 年 4 月 22 日前查看地區配額，但配額會在該日期後才強制實施。如要瞭解如何查看配額，請參閱「查看記錄配額」。

2025 年 4 月 22 日之後，entries.write 要求數量的配額將變更為無限制。

如果您在 2025 年 4 月 22 日之後超出區域配額，Cloud Logging API 的寫入要求可能會遭到拒絕，並顯示「資源用盡」錯誤訊息。如需避免超出配額的建議，請參閱「管理及監控記錄功能配額」。

查看 Cloud Logging API 配額

如要查看 Cloud Logging API 配額，請按照下列步驟操作：

  1. 在 Google Cloud 控制台，依序前往「Quotas & System Limits」(配額與系統限制) 頁面：

    前往「配額與系統限制」

    如果您是使用搜尋列尋找這個頁面，請選取子標題為「IAM 與管理」的結果。

  2. 篩選 Cloud Logging API 服務的配額清單。

申請調整 Cloud Logging API 配額

您可以使用Google Cloud 控制台要求提高或降低 Logging API 配額上限。詳情請參閱「查看及管理配額」。

如果您收到錯誤訊息 Edit is not allowed for this quota，可以與支援團隊聯絡，要求變更配額。請注意，您必須先為Google Cloud 專案啟用帳單功能，才能點選核取方塊。

管理及監控 Cloud Logging API 配額

如要避免因超出配額而導致服務中斷，您可以採取以下做法：

  • 使用自動配額調整功能監控配額用量，並代為提出提高配額的要求。詳情請參閱「配額調整工具」。
  • 建立配額快訊，以便在用量達到特定門檻時收到通知。詳情請參閱「設定配額快訊」。

最佳化 entries.list 的用量

entries.list 的預期用途是搜尋相符的記錄。此方法不適合用於大量擷取記錄項目。如果您經常耗盡 entries.list 配額，請考慮採用下列做法：

  • 請確認您有效率地使用 Cloud Logging API。詳情請參閱「最佳化 API 用量」。

  • 如果您事先知道要分析的記錄項目超過 entries.list 配額，請設定記錄接收器，將記錄匯出至支援的目的地。

  • 如要在 Logging 外分析記錄項目，您可以回溯複製記錄項目，將 Logging 中現有的記錄項目複製到 Cloud Storage 值區。將記錄複製到 Cloud Storage 值區後，您就能在 Logging 以外與稽核人員分享記錄項目，並在 Cloud Storage 中執行指令碼。

  • 如要匯總及分析記錄檔中的記錄項目，請將記錄項目儲存在記錄檔值區中，然後升級該記錄檔值區，以便使用 Log Analytics。如要瞭解這些步驟，請參閱「設定記錄值區」。

    您可以使用 BigQuery 標準 SQL 查詢記錄檔項目。

記錄指標

以下限制適用於您使用使用者定義的記錄指標。除了指標描述符的數量外，這些限制都是固定的，您無法增加或減少這些限制。

類別 最大值
標籤數量 每項指標 10 個
標籤值的長度 1,024 B
標籤說明的長度 800 B
篩選器長度1 20,000 個半形字元
指標描述元的長度 8,000 B
指標描述元數量 每項 Google Cloud 專案2 500 個
有效的時間序列數量3 每公制單位 30,000
直方圖值區數量 每項自訂分布指標 200 個
資料保留 請參閱「Cloud Monitoring：資料保留」

1 每個記錄指標都包含篩選條件。當記錄項目符合篩選條件時，系統就會計算該記錄項目。您可以使用記錄查詢語言定義篩選器。
2 這項限制也適用於帳單帳戶、資料夾和機構，且不具階層性質。
3您在過去 24 小時內曾寫入資料點的時間序列即為有效。

稽核記錄

稽核記錄的大小上限如以下表所示。這些值可協助您估算匯流程式目的地所需的空間。

稽核記錄類型 大小上限
管理員活動 512 KiB
資料存取權 512 KiB
系統事件 512 KiB
政策遭拒 512 KiB

記錄保留期限

下列 Cloud Logging 保留期限適用於記錄值區，不論值區包含哪些記錄類型，或是否從其他位置複製記錄都一樣。保留資訊如下：

值區 預設保留期限 自訂保留期限
_Required 400 天 無法設定
_Default 30 天 可自行設定
使用者定義 30 天 可自行設定

針對 _Default 和使用者定義的記錄檔值區，您可以將 Cloud Logging 的記錄檔保留期限設為 1 至 3650 天。如要瞭解如何設定保留規則，請參閱「設定自訂保留」一文。

定價

Cloud Logging 不會針對將記錄檔轉送至支援的目的地收費，但目的地可能會收取費用。除了 _Required 記錄檔值區，Cloud Logging 會針對將記錄檔串流至記錄檔值區，以及超過記錄檔值區預設保留期限的儲存空間收取費用。

複製記錄、建立記錄範圍或分析檢視畫面，或是透過 Logs Explorer 或 Log Analytics 頁面發出的查詢，Cloud Logging 不會收取費用。

如需詳細資訊，請參閱下列文件：