設定記錄檔 bucket

Google Cloud 控制台

如要在 Google Cloud 專案中建立記錄檔 bucket，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Logs Storage」(記錄檔儲存空間) 頁面：

   前往「Logs Storage」(記錄檔儲存空間)

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

2. 按一下「建立記錄檔值區」。

3. 輸入值區的「名稱」和「說明」。

4. 選用：升級 bucket 以使用 Log Analytics。

   1. 選取「升級即可使用 Log Analytics」。

      將 bucket 升級為使用記錄檔分析功能後，您就能在「記錄檔分析」頁面中，使用 SQL 查詢記錄檔。您也可以繼續使用記錄檔探索工具查看記錄。

   2. 選用：如要在 BigQuery 中查看記錄，請選取「建立連結至這個 bucket 的新 BigQuery 資料集」，然後輸入不重複的資料集名稱。

      選取這個選項後，BigQuery 就能讀取儲存在記錄檔值區中的資料。您現在可以在 BigQuery 介面中查詢，並彙整記錄檔資料，還能存取 Looker Studio 和 Looker 等其他工具的資料。

5. 選用：如要選取記錄的儲存區域，請按一下「選取記錄 bucket 區域」選單，然後選取區域。如果您未選取地區，系統會使用 global 地區，也就是說，記錄可以實際儲存在任何支援的地區。

6. 選用：如要為值區中的記錄檔設定自訂保留期限，請按一下「Next」(下一步)。

   在「保留期限」欄位中，輸入您希望 Cloud Logging 保留記錄檔的天數 (1 到 3,650 天)。如未自訂保留期限，則預設值為 30 days。

   您也可以在建立儲存空間後更新儲存空間，套用自訂保留期限。

7. 點選「建立值區」。

   建立記錄值區後，如果選取了升級值區和建立資料集連結的選項，記錄服務就會升級值區並建立資料集連結。

   完成這些步驟可能需要一些時間。

gcloud

如要只建立記錄儲存空間，請執行 gcloud logging buckets create 指令。如要升級記錄檔 bucket 並使用記錄檔分析，請加入 --enable-analytics 和 --async 旗標，並確保將變數 LOCATION 設為支援的區域：

gcloud logging buckets create BUCKET_ID --location=LOCATION --enable-analytics --async OPTIONAL_FLAGS

--async 標記會強制指令為非同步。非同步方法會傳回 Operation 物件，其中包含方法進度資訊。方法完成後，Operation 物件會包含狀態。詳情請參閱「非同步 API 方法」。

如不想升級記錄檔 bucket 以使用記錄檔分析，請省略 --enable-analytics 和 --async 旗標。

舉例來說，如果您想在 global 地區使用 BUCKET_ID my-bucket 建立值區，指令會如下所示：

gcloud logging buckets create my-bucket --location global --description "My first bucket"

舉例來說，如要在 global 位置建立 BUCKET_ID my-upgraded-bucket bucket，然後升級記錄檔 bucket 以使用記錄檔分析工具，指令會如下所示：

gcloud logging buckets create my-upgraded-bucket --location global \
      --description "My first upgraded bucket" \
      --enable-analytics --retention-days=45

REST

如要建立 bucket，請使用 projects.locations.buckets.create 或 projects.locations.buckets.createAsync 方法。如下準備方法的引數：

1. 將 parent 參數設為要在其中建立 Bucket 的資源： projects/PROJECT_ID/locations/LOCATION

   變數 LOCATION 是指您要儲存記錄的區域。

   舉例來說，如果您想在 global 地區為專案 my-project 建立值區，parent 參數會如下所示：projects/my-project/locations/global

2. 設定 bucketId 參數，例如 my-bucket。

3. 執行下列任一操作：

   • 如要建立記錄檔 bucket，然後升級該 bucket 以使用記錄檔分析工具，請按照下列步驟操作：

     1. 將 LogBucket.analyticsEnabled 布林值設為 true。

     2. 呼叫非同步方法 projects.locations.buckets.createAsync 建立 bucket。

        非同步方法的回應是 Operation 物件。這個物件包含方法進度的相關資訊。方法完成後，Operation 物件會包含狀態。詳情請參閱「非同步 API 方法」。

        createAsync 方法需要幾分鐘才會完成。 如果將 analyticsEnabled 布林值設為 true，這個方法不會產生錯誤訊息或失敗。

   • 否則，請呼叫同步方法 projects.locations.buckets.create 建立 bucket。

Google Cloud 控制台

如要更新 bucket 的屬性，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Logs Storage」(記錄檔儲存空間) 頁面：

   前往「Logs Storage」(記錄檔儲存空間)

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

2. 找到要更新的 bucket，然後按一下「更多」圖示 more_vert。

3. 選取「編輯 bucket」。

4. 視需要編輯儲存空間。

5. 按一下「Update bucket」(更新 bucket)。

gcloud

如要更新 bucket 的屬性，請執行 gcloud logging buckets update 指令：

gcloud logging buckets update BUCKET_ID --location=LOCATION UPDATED_ATTRIBUTES

例如：

gcloud logging buckets update my-bucket --location=global --description "Updated description"

REST

如要更新 bucket 的屬性，請使用 Logging API 中的 projects.locations.buckets.patch。

Google Cloud 控制台

如要升級現有 bucket 以使用記錄檔分析，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Logs Storage」(記錄檔儲存空間) 頁面：

   前往「Logs Storage」(記錄檔儲存空間)

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

2. 找出要升級的儲存空間。

3. 如果「Log Analytics available」(可使用記錄檔分析) 欄顯示「Upgrade」(升級)，表示您可以升級記錄檔 bucket，以便使用記錄檔分析。按一下「升級」。

   開啟對話方塊，按一下「確認」。

gcloud

如要升級記錄檔 bucket 以使用記錄檔分析工具，請執行 gcloud logging buckets update 指令。您必須設定 --enable-analytics 旗標，並建議一併加入 --async 旗標：

gcloud logging buckets update BUCKET_ID --location=LOCATION --enable-analytics --async

--async 標記會強制指令為非同步。非同步方法會傳回 Operation 物件，其中包含方法進度資訊。方法完成後，Operation 物件會包含狀態。詳情請參閱「非同步 API 方法」。

REST

如要升級記錄檔 bucket 以使用記錄檔分析，請使用 Cloud Logging API 的 projects.locations.buckets.updateAsync 方法。

如下準備方法的引數：

1. 將 LogBucket.analyticsEnabled 布林值設為 true。
2. 如要查詢指令的參數，請使用 updateMask=analyticsEnabled。

非同步方法的回應是 Operation 物件。這個物件包含方法進度的相關資訊。方法完成後，Operation 物件會包含狀態。詳情請參閱「非同步 API 方法」一文。

updateAsync可能需要幾分鐘才能完成。

Google Cloud 控制台

如要為現有記錄檔 bucket 建立 BigQuery 資料集連結，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Logs Storage」(記錄檔儲存空間) 頁面：

   前往「Logs Storage」(記錄檔儲存空間)

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

2. 找出記錄檔儲存空間，並確認「可用的記錄檔分析」欄顯示「開啟」。

   如果這個資料欄顯示「升級」，表示記錄檔 bucket 尚未升級，無法使用記錄檔分析。設定 Log Analytics：

   1. 按一下「升級」。
   2. 在對話方塊中按一下「確認」。

   升級完成後，請繼續執行下一個步驟。

3. 在記錄值區中，按一下「更多」圖示 more_vert，然後按一下「編輯值區」。

   「編輯記錄水桶」對話方塊隨即開啟。

4. 選取「建立連至這個 bucket 的新 BigQuery 資料集」，然後輸入新資料集的名稱。

   每個 Google Cloud 專案的資料集名稱不得重複。如果輸入現有資料集的名稱，系統會顯示下列錯誤：Dataset name must be unique in the selected region.

5. 依序按一下「完成」和「更新 bucket」。

   Logging 在「記錄儲存空間」頁面上顯示連結的資料集名稱後，BigQuery 可能需要幾分鐘才能辨識該資料集。

gcloud

如要為已升級的記錄檔 bucket 建立連結的資料集，請執行 gcloud logging links create 指令：

gcloud logging links create LINK_ID --bucket=BUCKET_ID --location=LOCATION

您提供的 LINK_ID 會做為 BigQuery 資料集的名稱，且這個欄位的值在 Google Cloud 專案中不得重複。

links create 指令為非同步性質。非同步方法會傳回 Operation 物件，其中包含方法進度資訊。方法完成後，Operation 物件會包含狀態。詳情請參閱「非同步 API 方法」。

links create 指令需要幾分鐘才能完成。

舉例來說，下列指令會為名為 my-bucket 的記錄值區建立名為 mylink 的連結資料集：

gcloud logging links create mylink --bucket=my-bucket --location=global

每個 Google Cloud 專案的資料集名稱不得重複。如果您嘗試建立與現有資料集同名的資料集，就會收到下列錯誤訊息：

BigQuery dataset with name "LINK_ID" already exists.

如果您嘗試為未升級以使用記錄檔分析工具的記錄檔 bucket 建立連結的資料集，系統會回報下列錯誤：

A link can only be created for an analytics-enabled bucket.

REST

如要為已升級的現有記錄檔 bucket 建立連結的 BigQuery 資料集，請使用 Log Analytics，並呼叫 Cloud Logging API 的非同步 projects.locations.buckets.links.create 方法。

如下準備方法的引數：

1. 建構 create 指令的要求內容。要求主體的格式為 Link 物件。
2. 如要查詢指令的參數，請使用 linkId=LINK_ID。您提供的 LINK_ID 會做為 BigQuery 資料集的名稱，且這個欄位的值在您的 Google Cloud 專案中不得重複。

非同步方法的回應是 Operation 物件。這個物件包含方法進度的相關資訊。方法完成後，Operation 物件會包含狀態。詳情請參閱「非同步 API 方法」。

links.create 方法需要幾分鐘才會完成。

每個 Google Cloud 專案的資料集名稱不得重複。如果您嘗試建立與現有資料集同名的資料集，就會收到下列錯誤訊息：

BigQuery dataset with name "LINK_ID" already exists.

如果您嘗試為未升級以使用記錄檔分析工具的記錄檔 bucket 建立連結的資料集，系統會回報下列錯誤：

A link can only be created for an analytics-enabled bucket.

Google Cloud 控制台

Google Cloud 控制台不支援鎖定記錄檔儲存空間。

gcloud

如要鎖定 bucket，請執行 gcloud logging buckets update 指令並加上 --locked 旗標：

gcloud logging buckets update BUCKET_ID --location=LOCATION --locked

例如：

gcloud logging buckets update my-bucket --location=global --locked

REST

如要鎖定 bucket 的屬性，請在 Logging API 中使用 projects.locations.buckets.patch。將 locked 參數設為 true。

Google Cloud 控制台

在 Google Cloud 控制台中，前往「Logs Storage」(記錄檔儲存空間) 頁面：

前往「Logs Storage」(記錄檔儲存空間)

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

名為「記錄檔值區」的表格會列出與目前專案相關聯的值區。Google Cloud

表格會列出每個記錄檔儲存區的下列屬性：

• 名稱：記錄值區的名稱。
• 說明：值區的說明。
• 保留期限：Cloud Logging 儲存值區資料的天數。
• 區域：儲存 bucket 資料的地理位置。
• 狀態：顯示儲存空間是否已鎖定。

如果 Cloud Logging 正在刪除值區，該值區的表格項目會加上 warning 警告符號。

gcloud

執行 gcloud logging buckets list 指令：

gcloud logging buckets list

您會看到記錄 bucket 的下列屬性：

• LOCATION：儲存值區資料的區域。
• BUCKET_ID：記錄值區的名稱。
• RETENTION_DAYS：Cloud Logging 儲存值區資料的天數。
• LIFECYCLE_STATE：指出 Cloud Logging 是否正在刪除值區。
• LOCKED：儲存空間是否已鎖定或解除鎖定。
• CREATE_TIME：表示 bucket 建立時間的時間戳記。
• UPDATE_TIME：時間戳記，表示 Bucket 上次修改時間。

您也可以只查看一個值區的屬性。舉例來說，如要查看 global 區域中 _Default 記錄儲存空間的詳細資料，請執行 gcloud logging buckets describe 指令：

gcloud logging buckets describe _Default --location=global

REST

如要列出與 Google Cloud 專案相關聯的記錄值區，請使用 Logging API 中的 projects.locations.buckets.list。

Google Cloud 控制台

在 Google Cloud 控制台中，前往「Logs Storage」(記錄檔儲存空間) 頁面：

前往「Logs Storage」(記錄檔儲存空間)

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

在記錄 bucket 上，按一下「更多」圖示 more_vert，然後選取「查看 bucket 詳細資料」。

對話方塊會列出記錄值區的下列屬性：

• 名稱：記錄值區的名稱。
• 說明：記錄檔值區的說明。
• 保留期限：Cloud Logging 儲存值區資料的天數。
• 區域：儲存 bucket 資料的地理位置。

• 記錄檔分析：指出值區是否已升級為使用記錄檔分析。
• BigQuery 分析：指出 BigQuery 資料集是否已連結至值區。
• BigQuery 資料集：提供 BigQuery 資料集的連結，開啟後會前往 BigQuery Studio 頁面。系統也會顯示啟用 BigQuery 連結的日期。

gcloud

執行 gcloud logging buckets describe 指令。

舉例來說，下列指令會回報 _Default 儲存空間的詳細資料：

gcloud logging buckets describe _Default --location=global

您會看到記錄 bucket 的下列屬性：

• createTime：表示 bucket 建立時間的時間戳記。
• description：記錄值區的說明。
• lifecycleState：指出 Cloud Logging 是否正在刪除值區。
• name：記錄值區的名稱。
• retentionDays：Cloud Logging 儲存值區資料的天數。
• updateTime：時間戳記，表示 Bucket 上次修改時間。

REST

如要查看單一記錄儲存空間的詳細資料，請在 Logging API 中使用 projects.locations.buckets.get。

Google Cloud 控制台

如要刪除記錄值區，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Logs Storage」(記錄檔儲存空間) 頁面：

   前往「Logs Storage」(記錄檔儲存空間)

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

2. 找到要刪除的 bucket，然後按一下「更多」。more_vert

3. 如果「BigQuery 中連結的資料集」欄顯示連結，請刪除連結的 BigQuery 資料集：

   1. 按一下「編輯值區」。

   2. 取消勾選「建立連至這個值區的新 BigQuery 資料集」，按一下「完成」，然後按一下「更新 bucket」。

      返回「記錄儲存空間」頁面後，按一下要刪除的 bucket 的「更多」，然後繼續下一個步驟。more_vert

4. 選取「刪除值區」。

5. 在確認面板中，按一下「刪除」。

6. 在「記錄儲存空間」頁面中，值區會顯示待刪除的指標。值區 (包括其中的所有記錄) 會在 7 天後刪除。

gcloud

如要刪除記錄值區，請執行 gcloud logging buckets delete 指令：

gcloud logging buckets delete BUCKET_ID --location=LOCATION

如果記錄檔 bucket 連結了 BigQuery 資料集，您就無法刪除該 bucket：

• 如要列出與記錄值區相關聯的連結，請執行 gcloud logging links list 指令。
• 如要刪除連結的資料集，請執行 gcloud logging links delete 指令。

REST

如要刪除 bucket，請在 Logging API 中使用 projects.locations.buckets.delete。

如果記錄檔 bucket 連結了 BigQuery 資料集，就無法刪除該 bucket。您必須先刪除連結的資料集，才能刪除記錄值區：

• 如要列出與記錄值區相關聯的連結，請執行 projects.locations.buckets.links.list 方法。
• 如要刪除連結的資料集，請執行 projects.locations.buckets.links.delete 方法。

Google Cloud 控制台

如要還原待刪除的記錄 bucket，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Logs Storage」(記錄檔儲存空間) 頁面：

   前往「Logs Storage」(記錄檔儲存空間)

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

2. 找出要還原的值區，然後依序按一下「更多」圖示 more_vert 和「還原已刪除的值區」。

3. 在確認面板中，按一下「還原」。

4. 「記錄檔儲存空間」頁面會移除記錄檔 bucket 的待刪除指標。

gcloud

如要還原待刪除的記錄 bucket，請執行 gcloud logging buckets undelete 指令：

gcloud logging buckets undelete BUCKET_ID --location=LOCATION

REST

如要還原待刪除的 bucket，請在 Logging API 中使用 projects.locations.buckets.undelete。

Google Cloud 控制台

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

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

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

2. 如要自訂記錄檔探索工具中顯示的記錄，請按一下「Refine scope」(縮小範圍)，然後選取選項。舉例來說，您可以查看專案或記錄檢視中儲存的記錄。

3. 按一下 [套用]。「Query results」(查詢結果) 窗格會重新載入，並顯示符合所選選項的記錄。

詳情請參閱「記錄檔總覽：縮小範圍」。

gcloud

如要從記錄值區讀取記錄，請使用 gcloud logging read 指令並新增 LOG_FILTER 選取資料：

gcloud logging read LOG_FILTER --bucket=BUCKET_ID --location=LOCATION --view=LOG_VIEW_ID

REST

如要從記錄 bucket 讀取記錄，請使用 entries.list 方法。設定 resourceNames 指定適當的值區和記錄檢視畫面，並設定 filter 選取資料。

Google Cloud 控制台

如要更新記錄檔 bucket 的保留期限，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Logs Storage」(記錄檔儲存空間) 頁面：

   前往「Logs Storage」(記錄檔儲存空間)

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

2. 找到要更新的 bucket，然後依序點按「更多」more_vert 和「編輯 bucket」。

3. 在「保留」欄位中，輸入您希望 Cloud Logging 保留記錄檔的天數 (1 到 3,650 天)。

4. 按一下「Update bucket」(更新 bucket)。新的保留時間會顯示在「記錄檔值區」清單中。

gcloud

如要更新記錄值區的保留期限，請設定 RETENTION_DAYS 的值，然後執行 gcloud logging buckets update 指令：

gcloud logging buckets update BUCKET_ID  --location=LOCATION --retention-days=RETENTION_DAYS

舉例來說，如要將 global 位置的 _Default bucket 中的記錄保留一年，指令會如下所示：

gcloud logging buckets update _Default --location=global --retention-days=365