本頁面詳細說明 Cloud Logging 的使用限制。
Logging 配額與用量限制
下表列出 Cloud Logging 的使用配額與限制。一般來說，您可以要求增加配額。不過，限制無法變更。
部分項目列為「每個專案」，但附註指出該項目也適用於帳單帳戶、資料夾和機構，且不具階層性。舉例來說，如果機構內有多個 Google Cloud 專案，則每個 Google Cloud 專案最多可設定 200 個接收器；在同一個機構中，您也可以在機構層級設定最多 200 個接收器。
| 類別 | 上限或 初始配額值 |
附註 |
|---|---|---|
大小為
LogEntry |
256 KB | 此限制為概略值，是取決於內部資料大小，而非實際的 REST API 要求大小。無法增加。 |
| 稽核記錄項目大小 | 512 KiB | 無法增加。 |
| 標籤數量 | 每LogEntry 64 個 |
無法增加。 |
LogEntry標籤鍵的長度 |
512 B | Cloud Logging 會在寫入相關聯的記錄項目時，截斷過大的標籤鍵。無法增加。 |
LogEntry 標籤值的長度 |
64 KB | 寫入相關聯的記錄項目時，Cloud Logging 會截斷過大的標籤值。無法增加。 |
| Logging 查詢語言查詢的長度 | 20,000 個字元 | 無法增加。 |
| 查詢擴展 | 200 個 bucket | 這項限制是指資源最多可包含的記錄項目值區數量。詳情請參閱「查詢傳回錯誤」。無法增加。 基於效能考量，請盡量減少記錄檔 bucket 數量，並在一個區域中建立記錄檔 bucket。如果您經常需要查詢來自不同資源的記錄項目，請考慮將記錄項目傳送至幾個集中式記錄檔值區。 |
| 洗臉盆數量 | 每項 Google Cloud 專案 200 個 | 可增加至 4,000。 這項配額也適用於帳單帳戶、資料夾和機構，且不具階層性。 |
| 接收器納入篩選器的長度 | 20,000 個字元 | 無法增加。 |
| 接收器排除篩選器的長度 | 20,000 個字元 | 無法增加。 |
| 排除篩選器數量 | 每個接收器 50 個 | 無法增加。 如果需要超過 50 個排除篩選器，請調整包含篩選器。 |
| 記錄檔值區數量 | 每個 Google Cloud 專案 100 個 | 可提高至 2,500。 這項配額是指資源可包含的記錄項目值區數量上限，包括待刪除的值區。 這項配額也適用於帳單帳戶、資料夾和機構，且不具階層性。 如果增加記錄檔儲存空間的數量上限，使用者體驗可能會變差，因為預設記錄檔範圍無法納入專案中的所有記錄檔儲存空間。 |
| 自訂索引欄位數量 | 每個記錄檔 bucket 20 個 | 無法增加。 Cloud Logging 支援全文索引。因此，我們不建議您定義自訂索引。 |
| 記錄檔檢視次數 | 每個記錄檔 bucket 30 個 | 單一記錄檔儲存空間最多可增加至 1,000 個記錄檔檢視畫面。 如果增加記錄檢視次數上限，使用者體驗可能會變差，因為預設記錄範圍無法納入專案中的所有記錄 bucket。 |
| 可儲存在記錄檔 bucket 中的最早時間戳記 | 取決於記錄檔 bucket 的保留期限。 | 如果是採用預設保留期限的自訂記錄檔 bucket，這個值是過去 30 天。 Logging API 接受時間戳記較舊的記錄項目，並將這些記錄項目轉送至接收器目的地。不過，如果時間戳記較舊的記錄項目會傳送至記錄儲存區，系統就不會儲存這些項目。 |
| 可儲存在記錄檔值區中的未來時間戳記 | 最多可預約 1 天後的行程 | 如果記錄項目的時間戳記超過 1 天，Logging API 會拒絕該項目，並傳回 INVALID_ARGUMENT 錯誤。無法增加。 |
| 每個資源的記錄範圍數量 | 100 | 可提高至 10,000。 |
| 記錄範圍內的記錄檢視和專案數量 | 100 | 建議您盡可能在記錄範圍中列出記錄檢視畫面，而非專案。列出記錄檢視畫面可縮短查詢時間，並清楚顯示要查詢的記錄項目。 |
| 記錄範圍內的專案數量 | 5 | 建議您盡可能在記錄範圍中列出記錄檢視畫面，而非專案。記錄檢視畫面可位於不同專案中。 |
| 每個專案的 Analytics 檢視畫面數量上限 Google Cloud | 100 | 無法增加。 這項功能為公開測試版。 |
| 每個 Google Cloud 專案在每個區域的 Analytics 檢視畫面數量上限 | 50 | 無法增加。 這項功能為公開測試版。 |
| 每個 Google Cloud 專案可儲存 Analytics 檢視區的區域數量上限 | 10 | 無法增加。 這項功能為公開測試版。 |
Logging API 配額與限制
下列限制適用於 Logging API 的使用。您可以要求變更 Logging API 配額和限制；如需操作說明，請參閱本頁的「要求變更 Cloud Logging API 配額」一節。
如要查看 API 配額，請前往 API 資訊主頁，選取 API，然後選取「配額」。
| 類別 | 上限值或 初始配額值 |
附註 |
|---|---|---|
| API 頁面權杖的有效期限 | 24 小時 | 無法增加。 |
| 執行中即時追蹤工作階段數 | 每項 Google Cloud 專案 10 個 | 無法增加。 這項限制也適用於帳單帳戶、資料夾和機構，且不具階層性。 |
| 傳回的即時追蹤項目數 | 每分鐘 60,000 | 無法增加。 |
| 受限制的欄位數量 | 每個值區 20 個 | 無法增加。 |
| 受限制欄位的大小 | 800 B | 無法增加。 |
單一 entries.write 要求大小 |
10 MB | 無法增加。 |
各區域的 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
每分鐘 300 MB，每個 Google Cloud 專案，適用於所有其他區域 |
您可以要求增加配額。 這項配額也適用於帳單帳戶、資料夾和機構，且不具階層性。 如要進一步瞭解這些配額，請參閱 每個區域的擷取配額。 系統會在收到 |
entries.list 要求數 |
每項 Google Cloud 專案每分鐘 60 次 | 無法增加。 這項限制也適用於帳單帳戶、資料夾和機構，且不具階層性。 如要查詢大量記錄，請考慮使用 BigQuery API。如要移轉大量記錄，建議使用記錄接收器或複製記錄項目。 |
單一 entries.write 指令中的不同資源名稱數量 |
1000 | 無法增加。 記錄項目的 |
| 每分鐘控制要求數 | 600 | 無法增加。 這項配額適用於每日控制要求配額中包含的所有項目，以及用於刪除記錄和管理以記錄為準指標的 API 要求。 |
| 每日控制要求數 | 每項 Google Cloud 專案 1,000 個 | 無法增加。 這項配額適用於建立及更新排除條件和接收器的 API 要求。 |
單一 entries.list 要求中的 Google Cloud 專案數量或其他資源名稱 |
100 | 無法增加。 |
| 並行複製作業數 | 每項 Google Cloud 專案 1 個 | 無法增加。 這項限制也適用於帳單帳戶、資料夾和機構，且不具階層性。 |
| 匯出至 Pub/Sub 主題的速率 | 每分鐘 60 GB (每個定義接收器的 Google Cloud 專案、資料夾或機構) | 您可以提出支援要求，提高配額。配額增加的幅度取決於 Pub/Sub 的可用性。 如果匯出率超過配額，系統就會在記錄項目中記錄錯誤。摘要欄位會指出接收器設定錯誤，錯誤代碼則會列為 |
各區域的擷取配額
為提升隔離效果，並避免區域資源因大量擷取資料而過載，Cloud Logging 配額會根據每個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 專案 |
區域配額的預設值高於大多數使用者的擷取量。不過，如果專案在配額強制執行前，過去六個月或更長時間內從某個區域擷取的資料量，接近或超過該區域的預設配額，則初始配額會自動一次性增加。因此，您的配額可能會高於上表中的預設值。如要瞭解如何查看配額，請參閱「查看 Cloud Logging 配額」。
如果超出區域配額，系統可能會拒絕您對 Cloud Logging API 的寫入要求，並顯示「資源耗盡」錯誤訊息。如需避免超出配額的建議，請參閱「管理及監控記錄配額」。
查看 Cloud Logging API 配額
如要查看 Cloud Logging API 配額，請按照下列步驟操作：
-
在 Google Cloud 控制台，前往「配額與系統限制」頁面：
如果您是使用搜尋列尋找這個頁面，請選取子標題為「IAM & Admin」(IAM 與管理) 的結果。
- 篩選 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 bucket。將記錄複製到 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 每個記錄指標都包含篩選條件。如果記錄項目符合篩選條件，就會計入。篩選器是使用 Logging 查詢語言定義。
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 天。如要瞭解如何設定保留規則，請參閱「設定自訂保留規則」。
定價
如要查看定價資訊，請參閱「Google Cloud Observability 定價」頁面。如果將記錄資料傳送至其他 Google Cloud 服務，請參閱下列文件：