容器分析稽核記錄資訊

本頁說明 Container Analysis 在 Cloud 稽核記錄中建立的稽核記錄。

總覽

Google Cloud Platform 服務寫入的稽核記錄可協助您回答有關「人事時地物」的問題。每個 GCP 專案都只會包含直接隸屬於專案本身的資源稽核記錄。而諸如資料夾、機構及帳單帳戶的其他實體,也各有其專屬的稽核記錄。

如需 Cloud 稽核記錄的概要總覽,請參閱 Cloud 稽核記錄。如要深入瞭解 Cloud 稽核記錄,請參閱瞭解稽核記錄

Cloud 稽核記錄會針對每個 GCP 專案、資料夾和機構保留三份稽核記錄:

  • 系統事件稽核記錄
  • 管理員活動稽核記錄
  • 資料存取稽核記錄

容器分析會寫入系統事件稽核記錄,其中包含 Compute Engine 執行系統事件時的記錄項目。根據預設,容器分析會提供這些記錄。

針對修改資源設定或中繼資料等作業的「管理員活動」,容器分析會寫入並預設提供稽核記錄。

針對建立、修改或讀取使用者提供資料等 API 呼叫的「資料存取」,容器分析會寫入稽核記錄,但預設不提供這類稽核記錄。

資料存取稽核記錄分為幾種不同的類別:

  • 資料存取 (ADMIN_READ):讀取資源設定或中繼資料的作業。

    根據預設,Container Analysis 不會提供「管理員讀取」資訊。

  • 資料存取 (DATA_READ):從資源讀取使用者所提供資料的作業。

    根據預設,Container Analysis 不會提供「資料讀取」資訊。

  • 資料存取 (DATA_WRITE):將使用者提供的資料寫入資源的作業。

    根據預設,Container Analysis 不會提供「資料寫入」資訊。

預設不提供的稽核資訊可以設定。詳情請參閱設定資料存取記錄一文。

已稽核的作業

下表概略列出 Container Analysis 中每種稽核記錄類型所對應的 API 作業:

稽核記錄類別 Container Analysis 作業
管理員活動記錄 SetIamPolicy
UpdateScanConfig
資料存取記錄 (ADMIN_READ) GetIamPolicy
GetScanConfig
ListScanConfigs
資料存取記錄 (DATA_READ) GetNote
GetOccurrence
GetOccurrenceNote
GetVulnerabilityOccurrencesSummary
ListNotes
ListNoteOccurrences
ListOccurrences
資料存取記錄 (DATA_WRITE) BatchCreateNotes
BatchCreateOccurrences
CreateNote
CreateOccurrence
DeleteNote
DeleteOccurrence
UpdateNote
UpdateOccurrence

稽核記錄格式

稽核記錄項目 (可在 Stackdriver Logging 中使用記錄檢視器、Stackdriver Logging API 或 Cloud SDK 查看) 包含下列物件:

  • 記錄項目本身,屬於 LogEntry 類型的物件。有用的欄位包括:

    • logName 包含專案識別與稽核記錄類型
    • resource,包含已稽核作業的目標
    • timeStamp,包含已稽核作業的時間
    • protoPayload 包含已稽核的資訊
  • 稽核記錄資料。這是儲存在記錄項目 protoPayload 欄位中的 AuditLog 物件。

  • 選用的服務專屬稽核資訊。這是儲存在 AuditLog 物件中 serviceData 欄位的服務專屬物件。詳情請參閱服務專屬稽核資料

若要瞭解這些物件中的其他欄位、範例內容,以及查詢物件中資訊的範例,請參閱稽核記錄資料類型

記錄名稱

Cloud 稽核記錄資源名稱會指出擁有稽核記錄的專案或其他實體項目,以及記錄中是否包含管理員活動、資料存取或系統事件的稽核記錄資料。例如,下列內容顯示了專案管理員活動記錄與機構資料存取記錄的記錄名稱:

projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity
organizations/[ORGANIZATION_ID]/logs/cloudaudit.googleapis.com%2Fdata_access

服務名稱

Container Analysis 稽核記錄使用服務名稱 containeranalysis.googleapis.com

如要進一步瞭解記錄服務的方式,請參閱將服務對應至資源

資源類型

Container Analysis 稽核記錄使用的資源類型一律為 audited_resource

如需完整清單,請參閱受控資源類型

啟用稽核記錄

系統事件記錄預設為啟用,且無法停用。

根據預設,管理員活動稽核記錄預設為啟用,且無法停用。

根據預設,大多數資料存取稽核記錄都為停用。唯一的例外是 BigQuery 的資料存取稽核記錄,該記錄預設為啟用,且無法停用;BigQuery 資料存取記錄不會計入專案的記錄配額

如要啟用部分或全部的資料存取記錄,請參閱設定資料存取記錄一文。

您設定的資料存取記錄可能會影響 Stackdriver 中的記錄定價。請參閱本頁面中的定價一節。

稽核記錄權限

身分與權限管理系統的權限及角色可以決定您所能查看或匯出的稽核記錄。記錄位於專案和一些其他實體中,包括機構、資料夾和帳單帳戶。詳情請參閱瞭解角色

如要查看管理員活動記錄,您在包含稽核記錄的專案中必須擁有下列其中一個 Cloud IAM 角色:

如要查看「資料存取」記錄,含有稽核記錄的專案必須擁有下列其中一個角色:

如要查看系統事件記錄,您在包含稽核記錄的專案中必須擁有下列其中一個 Cloud IAM 角色:

如果您使用的稽核記錄來自非專案實體,例如機構,請將專案角色變更為適當的機構角色。

查看記錄

您可以採取下列幾種做法來查看稽核記錄項目:

基本檢視器

您可以使用 GCP 主控台中的記錄檢視器基本介面來擷取稽核記錄項目。請執行下列步驟:

  1. 前往 GCP 主控台的「Stackdriver Logging」(Stackdriver 記錄) >「Logs」(記錄) (「Logs Viewer」(記錄檢視器)) 頁面:

    前往「Logs Viewer」(記錄檢視器) 頁面

  2. 在頁面頂端選取現有 GCP 專案,或建立新專案。

  3. 在第一個下拉式選單中,選取您要查看的稽核記錄所屬的資源類型。您可以選取特定資源,或者選取 Global 以涵蓋所有資源。

  4. 在第二個下拉式選單中,請選取您要查看的記錄類型:管理員活動稽核記錄請選取 activity,資料存取稽核記錄請選取 data_access,而系統事件記錄請選取 system_events

    如果您沒有看到上述任一選項,就表示專案中沒有這類型的稽核記錄可供使用。

進階檢視器

您可以使用 GCP 主控台中的記錄檢視器進階介面來擷取稽核記錄項目。請執行下列步驟:

  1. 前往 GCP 主控台的「Stackdriver Logging」(Stackdriver 記錄) >「Logs」(記錄) (「Logs Viewer」(記錄檢視器)) 頁面:

    前往「Logs Viewer」(記錄檢視器) 頁面

  2. 在頁面頂端選取現有 GCP 專案,或建立新專案。

  3. 在第一個下拉式選單中,選取您要查看的稽核記錄所屬的資源類型。您可以選取特定資源,或者選取 Global 以涵蓋所有資源。

  4. 按一下搜尋篩選器方塊最右側的下拉式箭頭 (▾),然後選取 [Convert to advanced filter] (轉換為進階篩選器)

  5. 建立篩選器,以便進一步指定您要查看的記錄項目。如要擷取專案中的所有稽核記錄,請新增下列篩選器,並在每個記錄名稱中提供有效的 [PRODUCT_ID]

      logName = ("projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity" OR
          OR "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events"
          OR "projects/[PROJECT_ID]logs/cloudaudit.googleapis.com%2Fdata_access")
    

    如要進一步瞭解篩選器,請參閱進階記錄篩選器

API

如要使用 Stackdriver Logging API 查看稽核記錄項目,請執行下列步驟:

  1. 前往說明文件中 entries.list 方法的「Try this API」(試用這個 API) 一節。

  2. 將下列內容放入試用這個 API 表單的要求主體部分。按一下已預先填入資料的表單就可以自動填入要求主體,但您必須在每個記錄名稱中提供有效的 [PRODUCT_ID]

      {
        "resourceNames": [
          "projects/[PROJECT_ID]"
        ],
        "pageSize": 5,
        "filter": "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"
      }
    
  3. 按一下 [Execute] (執行)

如要進一步瞭解篩選器,請參閱進階記錄篩選器

SDK

如要使用 Cloud SDK 讀取記錄項目,請執行下列指令,並在每個記錄名稱中提供有效的 [PRODUCT_ID]

gcloud logging read "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)

如要進一步瞭解如何使用 Cloud SDK,請參閱讀取記錄項目

如要查看稽核記錄項目範例,並瞭解如何在其中找到最重要的資訊,請參閱瞭解稽核記錄

匯出稽核記錄

您可以採用與匯出其他類型記錄相同的方式來匯出稽核記錄。關於如何匯出記錄的詳細資訊,請參閱匯出記錄。以下是匯出稽核記錄的一些應用方式:

  • 如要長時間保留稽核記錄,或使用更強大的搜尋功能,您可以將稽核記錄的複本匯出到 Cloud Storage、BigQuery 或 Cloud Pub/Sub。您可以使用 Cloud Pub/Sub 匯出至其他應用程式、其他存放區或是第三方。

  • 如要管理整個機構的稽核記錄,您可以建立匯總匯出接收器,從機構中的任何或所有專案匯出記錄。

  • 如果已啟用的「資料存取」記錄透過記錄配額推送專案,您可從 Logging 匯出及排除「資料存取」記錄。詳情請參閱排除記錄

定價

Stackdriver Logging 不會針對預設為啟用的稽核記錄收費,包括所有管理員活動和系統事件記錄在內。

Stackdriver Logging 會根據您明確要求的資料存取記錄收費。

如要進一步瞭解記錄定價,包括稽核記錄定價,請參閱 Stackdriver 定價

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Container Registry