配額與限制

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

Logging 用量限制

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

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

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

Logging API 配額與限制

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

類別 上限
API 使用量 如要查看配額，請前往 API 資訊主頁，選取 API，然後選取「配額」。
API 頁面權杖的有效期限 24 小時
執行中即時追蹤工作階段數 每個 Google Cloud 專案 10 個3
傳回的即時追蹤項目數 每分鐘 60,000
受限制的欄位數量 每個值區 20 個
受限制欄位的大小 800 B
單一 entries.write 要求大小 10 MB
entries.write 要求數量
要取代的配額；詳情請參閱「 各區域的擷取配額」		 每個 Google Cloud 專案每分鐘 120,000 次1, 3；
2025 年 8 月 4 日後無限制；
2025 年 8 月 11 日後移除配額
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 專案每分鐘 60 次2、3
單一 entries.write 指令中的不同資源名稱數量4
 1000
每分鐘 5 個控制要求5 600
每日 5 個控制要求 每項 Google Cloud 專案 1,000 個
單一 entries.list 要求中的 Google Cloud 專案數量或其他資源名稱
 100
並行複製作業數 每個 Google Cloud 專案 1 個3
匯出至 Pub/Sub 主題的速率6 每項專案每分鐘 60 GB Google Cloud

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

各區域的擷取配額

自 2025 年 8 月 4 日起，Cloud Logging 配額將限制每個專案寫入擷取區域的資料量。Google Cloud 自 2025 年 8 月 4 日起，Cloud Logging 將停止限制專案發出的 API entries.write 要求數量。 Google Cloud 這項異動的目的是提升隔離效果，並保護區域資源免於擷取過載。

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

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

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

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

自 2025 年 8 月 4 日起，entries.write要求的配額數量將改為無限制。

2025 年 8 月 11 日起，系統將移除 entries.write 要求數量的配額。

如果 2025 年 8 月 4 日後超出區域配額，系統可能會拒絕您對 Cloud Logging API 的寫入要求，並顯示「資源耗盡」錯誤訊息。如需避免超出配額的建議，請參閱「管理及監控 Logging 配額」。

查看 Cloud Logging API 配額

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

  1. 在 Google Cloud 控制台，前往「配額與系統限制」頁面：

    前往「配額與系統限制」

    如果您是使用搜尋列尋找這個頁面，請選取子標題為「IAM & Admin」(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 bucket 後，您就能與 Logging 外部的稽核人員共用記錄項目，並在 Cloud Storage 中執行指令碼。

  • 如要匯總及分析 Logging 中的記錄檔項目，請將記錄檔項目儲存在記錄檔 bucket 中，然後升級該記錄檔 bucket，以便使用記錄檔分析工具。如需這些步驟的相關資訊，請參閱「設定記錄值區」。

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

記錄指標

使用使用者定義的記錄指標時，請遵守下列限制。 除了指標描述元數量外，這些限制都是固定的，無法增加或減少。

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

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

稽核記錄

下表列出稽核記錄的大小上限。這些值可協助您估算接收端目的地所需的空間。

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

記錄保留期限

無論記錄檔 bucket 包含哪些類型的記錄檔，或是否從其他位置複製，都適用下列 Cloud Logging 保留期限。保留資訊如下：

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

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

定價

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

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

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