設定記錄檔 bucket

Google Cloud 控制台

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

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

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

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

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

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

4. 選用：升級值區，以便使用 Log Analytics。

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

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

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

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

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

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

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

   您也可以在建立資料夾後更新資料夾，以便套用自訂保留期限。

7. 點選「建立值區」。

   建立記錄值區後，如果您選取了這些選項，記錄功能會升級值區並建立資料集連結。

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

gcloud

如要只建立記錄資料集，請執行 gcloud logging buckets create 指令。如果您想升級記錄檔值區以使用記錄檔分析，請加入 --enable-analytics 和 --async 旗標，並確保將變數 LOCATION 設為支援的區域：

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

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

如果您不想升級記錄檔值區以使用記錄檔分析，請省略 --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 以使用記錄檔分析工具，指令會如下所示：

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

REST

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

1. 將 parent 參數設為建立值區的資源：projects/PROJECT_ID/locations/LOCATION

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

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

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

3. 請執行下列任一操作：

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

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

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

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

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

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

Google Cloud 控制台

如要更新儲存格屬性，請按照下列步驟操作：

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

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

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

2. 找出要更新的資料夾，然後按一下 more_vert「更多」。

3. 選取「編輯值區」。

4. 視需要編輯資料集。

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

gcloud

如要更新儲存格屬性，請執行 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

如要更新儲存格屬性，請在 Logging API 中使用 projects.locations.buckets.patch。

Google Cloud 控制台

如要升級現有值區，以便使用 Log Analytics，請按照下列步驟操作：

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

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

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

2. 找出要升級的資料集。

3. 如果「Log Analytics 可用」欄顯示「Upgrade」，您可以升級記錄檔值區，以便使用 Log Analytics。按一下「升級」。

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

gcloud

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

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

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

REST

如要升級記錄檔值區，以便使用 Log Analytics，請使用 Cloud Logging API 的 projects.locations.buckets.updateAsync 方法。

如下準備方法的引數：

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

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

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

Google Cloud 控制台

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

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

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

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

2. 找出記錄資料集，並確認「可用 Log Analytics」欄顯示「Open」。

   如果這個欄位顯示「Upgrade」，表示記錄檔值區尚未升級，無法使用 Log Analytics。設定 Log Analytics：

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

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

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

   「Edit log bucket」對話方塊隨即開啟。

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

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

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

   記錄在「Logs Storage」頁面上顯示已連結的資料集名稱後，可能需要幾分鐘，BigQuery 才會辨識該資料集。

gcloud

如要為已升級為使用 Log Analytics 的記錄檔值區建立連結資料集，請執行 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

如要鎖定值區，請搭配 --locked 旗標執行 gcloud logging buckets update 指令：

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

例如：

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

REST

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

Google Cloud 控制台

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

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

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

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

下表列出每個記錄資料集的以下屬性：

• 名稱：記錄值區的名稱。
• 說明：值區的說明。
• 保留期限：Cloud Logging 將保留值區資料的天數。
• 區域：值區資料的儲存地理位置。
• 狀態：指出分頁是否已鎖定或解除鎖定。

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

gcloud

執行 gcloud logging buckets list 指令：

gcloud logging buckets list

您會看到記錄資料集的下列屬性：

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

您也可以只查看單一值區的屬性。舉例來說，如要查看 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」的結果。

在記錄值區中，按一下 more_vert「更多」，然後選取「查看值區詳細資料」。

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

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

• Log Analytics：指出值區是否已升級為使用 Log Analytics。
• BigQuery 分析：指出 BigQuery 資料集是否已連結至您的值區。
• BigQuery 資料集：提供 BigQuery 資料集的連結，可在 BigQuery Studio 頁面中開啟。系統也會顯示啟用 BigQuery 連結的日期。

gcloud

執行 gcloud logging buckets describe 指令。

舉例來說，下列指令會回報 _Default 桶的詳細資料：

gcloud logging buckets describe _Default --location=global

您會看到記錄資料夾的下列屬性：

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

REST

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

Google Cloud 控制台

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

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

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

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

2. 找出要刪除的資料集，然後按一下「更多」圖示 more_vert。

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

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

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

      返回「Logs Storage」頁面後，找出要刪除的儲存桶，然後按一下 more_vert「更多」，接著繼續執行後續步驟。

4. 選取「刪除值區」。

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

6. 在「Logs Storage」頁面中，值區會顯示待刪除的標記。值區 (包括其中的所有記錄) 會在 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

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

如果記錄檔 bucket 已連結 BigQuery 資料集，則刪除該 bucket 會發生錯誤。您必須先刪除已連結的資料集，才能刪除記錄值區：

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

Google Cloud 控制台

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

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

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

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

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

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

4. 在「Logs Storage」頁面中，記錄檔 bucket 中已移除待刪除指標。

gcloud

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

gcloud logging buckets undelete BUCKET_ID --location=LOCATION

REST

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

Google Cloud 控制台

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

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

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

2. 如要自訂 Logs Explorer 顯示的記錄，請按一下「Refine scope」，然後選取所需選項。舉例來說，您可以查看儲存在專案中的記錄，或是依據記錄檢視畫面查看記錄。

3. 按一下 [套用]。「Query results」窗格會重新載入，並顯示與您選取的選項相符的記錄。

詳情請參閱「Logs Explorer 總覽：改善範圍」。

gcloud

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

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

REST

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

Google Cloud 控制台

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

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

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

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

2. 找到要更新的資料夾，然後按一下 more_vert「更多」，接著選取「編輯資料夾」。

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

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

gcloud

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

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

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

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