設定記錄檔 bucket

Cloud de Confiance 控制台

使用 Cloud de Confiance 控制台存取 Cloud de Confiance by S3NS 服務和 API 時，您不需要設定驗證機制。

gcloud

安裝 Google Cloud CLI，然後 使用聯合身分登入 gcloud CLI。 登入後，執行下列指令來初始化 Google Cloud CLI：

gcloud init

REST

如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

安裝 Google Cloud CLI，然後 使用聯合身分登入 gcloud CLI。

詳情請參閱 Cloud de Confiance 驗證說明文件中的「使用 REST 進行驗證」一節。

Cloud de Confiance 控制台

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

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

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

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

2. 點選「建立記錄檔 bucket」。

3. 輸入 bucket 的名稱和說明。

4. 如要選取記錄檔的儲存區域，請按一下「Select log bucket region」(選取記錄檔 bucket 區域) 選單，然後選取區域。

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

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

   建立記錄檔 bucket 後，您也可以更新保留期限。

6. 按一下「建立值區」。

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

gcloud

如要建立記錄檔 bucket，請執行 gcloud logging buckets create 指令：

gcloud logging buckets create BUCKET_ID --location=LOCATION

舉例來說，如要在 global 區域中建立 BUCKET_ID my-bucket 的 bucket，指令如下：

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

REST

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

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

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

   舉例來說，如要在 global 區域中為專案 my-project 建立 bucket，parent 參數應如下所示：projects/my-project/locations/global

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

3. 呼叫同步方法 projects.locations.buckets.create 建立 bucket。

Cloud de Confiance 控制台

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

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

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

名為「Log buckets」(記錄檔 bucket) 的表格會列出與目前Cloud de Confiance 專案相關聯的 bucket。

下表列出每個記錄檔 bucket 的下列屬性：

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

如果 bucket 待 Cloud Logging 刪除，則其表格項目會加上 warning 警告符號。

gcloud

執行 gcloud logging buckets list 指令：

gcloud logging buckets list

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

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

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

gcloud logging buckets describe _Default --location=global

REST

如要列出與 Cloud de Confiance 專案相關聯的記錄檔 bucket，請使用 Logging API 中的 projects.locations.buckets.list。

Cloud de Confiance 控制台

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

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

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

在記錄檔 bucket 上，按一下 more_vert「More」(更多)，然後選取「View bucket details」(查看 bucket 詳細資料)。

對話方塊會列出記錄檔 bucket 的下列屬性：

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

gcloud

執行 gcloud logging buckets describe 指令。

例如，下列指令會回報 _Default bucket 的詳細資料：

gcloud logging buckets describe _Default --location=global

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

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

REST

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

Cloud de Confiance 控制台

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

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

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

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

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

3. 選取「編輯 bucket」。

4. 視需要編輯 bucket。

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。

Cloud de Confiance 控制台

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

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

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

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

2. 針對要更新的值區，按一下 more_vert「More」(更多)，然後選取「Edit bucket」(編輯值區)。

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

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

gcloud

如要更新使用者定義記錄檔 bucket 或專案中 _Default 記錄檔 bucket 的保留期限，請先設定 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

Cloud de Confiance 控制台

Cloud de Confiance 控制台不支援鎖定記錄檔 bucket。

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。

Cloud de Confiance 控制台

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

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

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

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

2. 找出要刪除的值區，然後按一下more_vert「More」(更多)。

   1. 選取「刪除 bucket」。

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

   3. 在「Logs Storage」(記錄檔儲存空間) 頁面中，bucket 會顯示待刪除的指標。7 天後，系統會刪除 bucket，包括當中的所有記錄。

   gcloud

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

   gcloud logging buckets delete BUCKET_ID --location=LOCATION

   REST

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

   還原已刪除的 bucket

   您可以還原或取消刪除處於待刪除狀態的記錄檔 bucket。如要還原記錄檔 bucket，請按照下列步驟操作：

   Cloud de Confiance 控制台

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

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

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

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

   2. 針對要還原的值區，按一下 more_vert「More」(更多)，然後選取「Restore deleted bucket」(還原已刪除的值區)。

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

   4. 在「Logs Storage」(記錄檔儲存空間) 頁面中，記錄檔 bucket 的待刪除指標會移除。

   gcloud

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

   gcloud logging buckets undelete BUCKET_ID --location=LOCATION

   REST

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

   讀取及寫入記錄項目

   您不會直接將記錄寫入記錄檔值區，而是將記錄寫入Cloud de Confiance 資源： Cloud de Confiance 專案、資料夾或組織。接著，上層資源中的接收器會將記錄檔轉送至目的地，包括記錄檔 bucket。如果記錄檔符合接收器的篩選條件，且接收器有權將記錄檔轉送至記錄檔 bucket，接收器就會將記錄檔轉送至記錄檔 bucket 目的地。詳情請參閱「轉送記錄項目」。

   每個記錄檔值區都有一組記錄檢視。如要讀取記錄檔值區中的記錄，您必須具備記錄檔值區的記錄檢視存取權。記錄檔檢視畫面可讓您授予使用者存取權，僅限存取儲存在記錄檔 bucket 中的部分記錄檔。如要進一步瞭解記錄檢視畫面，請參閱「儲存記錄項目」和「設定記錄檔 bucket 的記錄檢視畫面」。

   如要讀取記錄檔 bucket 中的記錄，請按照下列步驟操作：

   Cloud de Confiance 控制台

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

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

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

   2. 如要自訂 Logs Explorer 中顯示的記錄，請按一下「Refine scope」(縮小範圍)，然後選取所需選項。例如，您可以查看儲存在專案中的記錄，或依記錄檢視查看。

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

   詳情請參閱「Logs Explorer 總覽：縮小範圍」。

   gcloud

   如要從記錄檔 bucket 讀取記錄檔，請使用 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 來選取資料。

   如要進一步瞭解篩選語法，請參閱「Logging 查詢語言」。

   疑難排解常見問題

   如果您在使用記錄檔 bucket 時遇到問題，請參閱下列疑難排解步驟和常見問題解答。

   為什麼無法刪除這個 bucket？

   如要刪除 bucket，請按照下列步驟操作：

   • 確認您具備刪除 bucket 的適當權限。如需所需權限清單，請參閱「使用 IAM 控管存取權」。

   • 列出 bucket 的屬性，判斷 bucket 是否已鎖定。如果 bucket 已鎖定，請查看 bucket 的保留期限。在值區中的所有記錄檔都達到值區的保留期限之前，您無法刪除鎖定的值區。

   哪些服務帳戶會將記錄檔轉送至我的 bucket？

   如要判斷是否有任何服務帳戶具備 IAM 權限，可將記錄轉送至 bucket，請按照下列步驟操作：

   1. 前往 Cloud de Confiance 控制台的「IAM」頁面：

      前往「IAM」

      如果您是使用搜尋列尋找這個頁面，請選取子標題為「IAM & Admin」(IAM 與管理) 的結果。

   2. 在「權限」分頁中，依「角色」查看。您會看到一個表格，其中列出與Cloud de Confiance 專案相關聯的所有 IAM 角色和主體。

   3. 在表格的「Filter」(篩選器)文字方塊 filter_list中，輸入「Logs Bucket Writer」(記錄檔 bucket 寫入者)。

      您會看到具備記錄檔 bucket 寫入者角色的主體。如果主體是服務帳戶，其 ID 會包含 s3ns-system.iam.gserviceaccount.com 字串。

   4. 選用：如要移除服務帳戶，使其無法將記錄轉送至 Cloud de Confiance 專案，請選取服務帳戶的核取方塊 check_box_outline_blank，然後按一下「Remove」(移除)。

   為什麼我已將 Cloud de Confiance 專案從_Default接收器中排除，卻仍看到該專案的記錄？

   您可能是在集中式 Cloud de Confiance 專案的記錄檔 bucket 中查看記錄檔，該專案會匯總整個組織的記錄檔。

   如果您使用 Logs Explorer 存取這些記錄，並看到從 _Default 接收器排除的記錄，則檢視畫面可能設為Cloud de Confiance 專案層級。

   如要修正這個問題，請在「Refine scope」(縮小範圍) 選單中選取「Log view」(記錄檢視)，然後選取與Cloud de Confiance 專案中_Default bucket 相關聯的記錄檢視。您應該不會再看到排除的記錄。

   後續步驟

   如要瞭解記錄檔 bucket API 方法，請參閱 LogBucket 參考文件。

   如果您管理組織或資料夾，可以指定子資源的 _Default 和 _Required 記錄檔 bucket 位置。您也可以設定記錄檔 bucket 是否使用 CMEK，以及 _Default 記錄檔接收器的行為。詳情請參閱「調整組織和資料夾的預設設定」。

   如要瞭解如何使用記錄檔 bucket 處理常見用途，請參閱下列主題：

   • 匯總並儲存貴機構的記錄檔。
   • 將記錄檔儲存至特定區域。