將記錄檔儲存至特定區域

本文說明如何使用 _Default 接收器，將記錄項目傳送至特定區域的 Cloud Logging 記錄檔 bucket。如需支援的地區清單，請參閱「位置」。

您也可以為機構或資料夾設定預設設定，為新的 _Default 和 _Required 值區設定預設儲存位置。詳情請參閱「設定預設儲存位置」。

本指南將以將所有記錄重新導向至單一區域為例，逐步說明這個程序。這項程序包含下列步驟：

1. 在指定區域建立記錄檔 bucket，用於儲存記錄。

2. 重新導向 _Default 接收器，將記錄檔傳送至新的記錄檔 bucket。

3. 在 Logs Explorer 中搜尋記錄。

總覽

在 Cloud Logging 中，記錄檔值區是區域資源：用於儲存、建立索引及搜尋記錄的基礎架構位於特定地理位置。除了 global、eu 或 us 區域中的記錄檔值區外，Google Cloud 會管理基礎架構，確保應用程式在記錄檔值區所在區域的可用區中備援可用。

貴機構可能需要將記錄檔資料儲存在特定區域。選擇記錄儲存區域時，主要考量因素包括是否符合貴機構的延遲時間、可用性或法規遵循需求。選擇記錄儲存區域時，請考慮應用程式所用其他Google Cloud 產品和服務的位置。

如果您有資料落地規定，請勿啟用可查詢記錄資料，然後將查詢結果儲存在 global 位置的服務。Gemini Cloud Assist 就是這類服務的例子。

基本概念

下列重要概念適用於記錄的資料區域性。

記錄路由器位置

記錄檔路由器會處理寫入 Cloud Logging API 的所有記錄項目。系統會根據現有規則檢查各個記錄項目，藉此判斷要將哪些記錄項目儲存在 Logging 值區，以及要使用接收器將哪些記錄項目轉送至支援的目的地。為確保記錄檔能順利轉送，記錄檔路由器也會暫時儲存記錄檔，以緩衝任何接收器暫時中斷的情況。

記錄檔路由器會在收到記錄檔的區域中處理記錄檔。 記錄檔路由器可能會根據接收器的定義，或您選擇與其他Google Cloud 服務 (例如 Security Command Center 威脅偵測) 共用記錄檔資料，將記錄檔傳送至不同區域。 無論記錄檔位於哪個區域，接收器都會套用至記錄檔。

記錄檔 bucket 位置

記錄檔 bucket 是Google Cloud 專案、帳單帳戶、資料夾和機構中的容器，用於儲存及整理記錄檔資料。

針對每個 Google Cloud 專案、帳單帳戶、資料夾和機構，記錄會自動建立兩個記錄儲存區：_Required 和 _Default，這兩個儲存區位於 global 位置。現有 bucket 的位置無法變更。不過，貴機構可以建立政策，為這些值區設定不同的預設位置。詳情請參閱「調整機構和資料夾的預設設定」。

您也可以為任何Google Cloud 專案建立使用者定義的記錄檔 bucket。建立使用者定義的記錄檔儲存空間時，可以指定記錄檔儲存空間的位置。記錄檔 bucket 建立完成後，就無法變更位置，但您可以建立新的 bucket，然後使用接收器將記錄項目導向新的記錄檔 bucket。如要瞭解如何設定值區位置，請參閱記錄檔區域化。

注意： 與在 us-west1 等單一區域建立的記錄 bucket 相比，global 區域或多區域中的記錄 bucket 不會提供額外的復原能力。

記錄功能支援同時查詢多個區域的記錄，在這種情況下，系統會在與所查詢 bucket 相同的位置處理查詢，然後在收到查詢的區域中匯總結果，並傳回結果。

記錄檔 bucket 的區域會顯示在「記錄檔儲存空間」頁面和部分對話方塊中。舉例來說，當您前往 Logs Explorer 頁面並使用「Refine scope」(縮小範圍) 選取器列出記錄檢視時，系統也會顯示區域資訊。如果選取器中的區域是 global，系統會以類似 GLOBAL (US-WEST4) 的格式顯示區域和目前的儲存位置。

事前準備

1. 找出要儲存記錄項目的 Google Cloud 專案。
2. 找出要儲存記錄項目的記錄檔 bucket 名稱和位置。
3. 決定要將哪些記錄項目傳送至記錄儲存空間。 本指南包含 _Default 接收器路由的所有記錄。

4. 在 Google Cloud 控制台中啟用 Cloud Shell。

   啟用 Cloud Shell

   Google Cloud 控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。

支援的地區

建立記錄值區時，您可以選擇記錄的儲存位置。 如需支援的地區清單，請參閱「位置」。

建立記錄檔 bucket

注意： 只有在符合特定條件時，Error Reporting 才會評估記錄項目。詳情請參閱「Error Reporting 分析記錄項目時機」。

記錄檔值區會儲存記錄項目。專案、資料夾和機構包含記錄檔接收器，可將記錄項目轉送至記錄檔 bucket 或其他目的地。如果接收器的目的地是記錄檔 bucket，該記錄檔 bucket 可以與記錄檔接收器位於相同資源，也可以位於不同資源。詳情請參閱「設定記錄儲存空間」。

1. 開啟殼層。

   舉例來說，如要使用 Cloud Shell，請執行下列操作：

   1. 前往 Google Cloud 控制台：

      前往 Google Cloud 控制台

   2. 按一下工具列中的 「啟用 Cloud Shell」。

2. 如要建立記錄 bucket，請在殼層中執行 gcloud logging buckets create 指令。執行範例指令前，請先進行下列替換：

   • BUCKET_ID：記錄檔 bucket 的名稱或 ID。
   • LOCATION：記錄 bucket 的位置。
   • PROJECT_ID：專案的 ID。

   指令範例：

   gcloud logging buckets create BUCKET_ID \
     --location=LOCATION \
     --project=PROJECT_ID
   

   注意： 建立 bucket 後，就無法變更 bucket 的位置。

3. 確認 bucket 是否已建立：

   gcloud logging buckets list --project=PROJECT_ID
   

記錄檔 bucket 建立完成後，您可以變更部分屬性，例如說明和資料保留期限。如要進行這些變更，請使用 gcloud logging buckets update 指令。

重新導向 _Default 記錄檔接收器

建立接收器即可將記錄檔轉送至記錄檔 bucket。接收器包含篩選器，可選取要透過接收器匯出的記錄項目，以及目的地。在本指南中，我們會更新現有的 _Default 接收器，將記錄項目轉送至上一個步驟中建立的記錄檔 bucket。

注意： 重新導向 _Default 接收器可確保日後所有記錄檔都會進入區域化記錄檔 bucket，而不是全域的 _Default bucket。您無法變更 _Required 接收器，記錄檔會進入不同的全域 bucket。

如要更新接收器，請執行 gcloud logging sinks update 指令。執行範例指令前，請先進行下列替換：

• _Default：這個範例會更新名為 _Default 的接收器目的地。如要更新其他接收器，請變更這個變數的名稱。
• BUCKET_ID：記錄檔 bucket 的名稱或 ID。
• LOCATION：記錄 bucket 的位置。
• PROJECT_ID：專案的 ID。

指令範例：

gcloud logging sinks update _Default \
  logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID \
  --log-filter='NOT LOG_ID("cloudaudit.googleapis.com/activity") AND NOT
    LOG_ID("externalaudit.googleapis.com/activity") AND NOT
    LOG_ID("cloudaudit.googleapis.com/system_event") AND NOT
    LOG_ID("externalaudit.googleapis.com/system_event") AND NOT
    LOG_ID("cloudaudit.googleapis.com/access_transparency") AND NOT
    LOG_ID("externalaudit.googleapis.com/access_transparency")' \
  --description="Updated the _Default sink to route logs to the LOCATION region"

注意： 建立專案時，_Default 接收器的篩選條件會如上一個指令所示。這個篩選器會排除由 _Required 接收器轉送至 _Required 記錄檔 bucket 的記錄項目，確保記錄項目只會轉送至 _Default 記錄檔 bucket 或 _Required 記錄檔 bucket，不會同時轉送至這兩個記錄檔 bucket。

建立記錄項目，測試接收器

如要確認接收器已正確更新，請完成下列步驟：

1. 使用 gcloud logging write 指令，將測試記錄訊息傳送至區域化值區。執行範例指令前，請先進行下列替換：

   • LOG_NAME：記錄名稱。
   • BUCKET_ID：記錄檔 bucket 的名稱或 ID。
   • PROJECT_ID：專案的 ID。

   指令範例：

   gcloud logging write LOG_NAME "Test to route logs to BUCKET_ID" \
   --project=PROJECT_ID
   

   注意： 測試訊息可能需要幾分鐘才會送達。

2. 查看記錄項目：

   1. 前往 Google Cloud 控制台的 segment「Logs Explorer」頁面：

      前往「Logs Explorer」(記錄檔探索工具)

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

   2. 在工具列中，按一下「縮小範圍」，然後選取「目前專案」。

      Logs Explorer 會設定為顯示專案中的記錄項目。

   3. 在「記錄欄位」窗格中，選取「全域」資源類型。

   4. 測試記錄項目會顯示在「Query results」(查詢結果) 面板中。

在 Google Cloud 控制台中搜尋記錄

如要查看記錄 bucket 中的記錄項目，請前往Google Cloud 控制台，然後完成下列步驟：

1. 前往 Google Cloud 控制台的 segment「Logs Explorer」頁面：

   前往「Logs Explorer」(記錄檔探索工具)

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

2. 選取「調整範圍」。

3. 在「縮小範圍」面板中，選取「記錄檢視畫面」。

4. 選取與 BUCKET_NAME 相關聯的 _AllLogs 檢視畫面。

5. 按一下「套用」。

   Logs Explorer會重新整理，並顯示 bucket 中的記錄。

   如要瞭解如何使用 Logs Explorer，請參閱「使用 Logs Explorer 查看記錄檔」。

後續步驟

• 查看全球各地可用的 Google Cloud 服務。

• 探索其他以位置資訊為準的概念，例如適用於其他 Google Cloud 服務的區域。

• 請參閱下列白皮書，瞭解資料治理的最佳做法：

  • 記錄資料：逐步指南，協助您克服常見的法規遵循挑戰

  • 資料治理：保護及管理記錄檔的原則