Cloud Bigtable API 稽核記錄

本文列出 Cloud Bigtable API 的稽核方法。 Google Cloud 服務會產生稽核記錄，用以記錄 Google Cloud 資源中的管理和存取活動。如要進一步瞭解 Cloud 稽核記錄，請參閱以下內容：

附註

如果記錄項目超過大小限制，Cloud Logging 會分割該項目，並將資料分配到多個項目中。如要瞭解如何識別及重新組合分割的稽核記錄，請參閱「分割稽核記錄項目」。

服務名稱

如要查看 Cloud Bigtable API 稽核記錄，請按照下列步驟操作：

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

    前往 Logs Explorer

  2. 複製下列查詢並貼到「Logs Explorer」的「Query」欄位，然後點選「Run query」。

        protoPayload.serviceName="bigtable.googleapis.com"

依權限類型區分的方法

每個 IAM 權限都具有 type 屬性，其值為以下四個列舉值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。呼叫方法時，Cloud Bigtable API 會產生一筆稽核記錄，類別取決於執行該方法所需權限的 type 屬性。若方法需要的 IAM 權限，type 屬性值為 DATA_READ、DATA_WRITE 或 ADMIN_READ，就會產生資料存取稽核記錄；若所需 IAM 權限的 type 屬性值為 ADMIN_WRITE，則會產生管理員活動稽核記錄。

下表列出的 API 方法中，如標有 (LRO) 字樣，表示為長時間執行的作業。這類方法通常會產生兩個稽核記錄項目，作業開始和結束時各一個。詳情請參閱「長時間執行的作業稽核記錄」。
權限類型 方法
ADMIN_READ google.bigtable.v2.Bigtable.PingAndWarm
DATA_READ google.bigtable.v2.Bigtable.ExecuteQuery
google.bigtable.v2.Bigtable.GenerateInitialChangeStreamPartitions
google.bigtable.v2.Bigtable.PrepareQuery
google.bigtable.v2.Bigtable.ReadChangeStream
google.bigtable.v2.Bigtable.ReadModifyWriteRow
google.bigtable.v2.Bigtable.ReadRows
google.bigtable.v2.Bigtable.SampleRowKeys
DATA_WRITE google.bigtable.v2.Bigtable.CheckAndMutateRow
google.bigtable.v2.Bigtable.MutateRow
google.bigtable.v2.Bigtable.MutateRows
google.bigtable.v2.Bigtable.ReadModifyWriteRow

API 介面稽核記錄

如要瞭解各方法所需的權限及評估方式，請參閱 Cloud Bigtable API 的 Identity and Access Management 說明文件。

google.bigtable.v2.Bigtable

屬於 google.bigtable.v2.Bigtable 的方法會產生以下稽核記錄。

CheckAndMutateRow

  • 方法：google.bigtable.v2.Bigtable.CheckAndMutateRow
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.tables.mutateRows - DATA_WRITE
  • 方法的作業種類： 非長時間執行或串流作業。
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.CheckAndMutateRow"

ExecuteQuery

  • 方法：google.bigtable.v2.Bigtable.ExecuteQuery
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.instances.executeQuery - DATA_READ
    • bigtable.tables.readRows - DATA_READ
  • 方法的作業種類： 串流 RPC
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.ExecuteQuery"

GenerateInitialChangeStreamPartitions

  • 方法：google.bigtable.v2.Bigtable.GenerateInitialChangeStreamPartitions
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.tables.readRows - DATA_READ
  • 方法的作業種類： 串流 RPC
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.GenerateInitialChangeStreamPartitions"

MutateRow

  • 方法：google.bigtable.v2.Bigtable.MutateRow
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.tables.mutateRows - DATA_WRITE
  • 方法的作業種類： 非長時間執行或串流作業。
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.MutateRow"

MutateRows

  • 方法：google.bigtable.v2.Bigtable.MutateRows
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.tables.mutateRows - DATA_WRITE
  • 方法的作業種類： 串流 RPC
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.MutateRows"

PingAndWarm

  • 方法：google.bigtable.v2.Bigtable.PingAndWarm
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.instances.ping - ADMIN_READ
  • 方法的作業種類： 非長時間執行或串流作業。
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.PingAndWarm"

PrepareQuery

  • 方法：google.bigtable.v2.Bigtable.PrepareQuery
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.instances.executeQuery - DATA_READ
  • 方法的作業種類： 非長時間執行或串流作業。
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.PrepareQuery"

ReadChangeStream

  • 方法：google.bigtable.v2.Bigtable.ReadChangeStream
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.tables.readRows - DATA_READ
  • 方法的作業種類： 串流 RPC
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.ReadChangeStream"

ReadModifyWriteRow

  • 方法：google.bigtable.v2.Bigtable.ReadModifyWriteRow
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.tables.mutateRows - DATA_WRITE
    • bigtable.tables.readRows - DATA_READ
  • 方法的作業種類： 非長時間執行或串流作業。
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.ReadModifyWriteRow"

ReadRows

  • 方法：google.bigtable.v2.Bigtable.ReadRows
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.tables.readRows - DATA_READ
  • 方法的作業種類： 串流 RPC
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.ReadRows"

SampleRowKeys

  • 方法：google.bigtable.v2.Bigtable.SampleRowKeys
  • 稽核記錄類型：資料存取
  • 權限：
    • bigtable.tables.sampleRowKeys - DATA_READ
  • 方法的作業種類： 串流 RPC
  • 篩選條件： protoPayload.methodName="google.bigtable.v2.Bigtable.SampleRowKeys"

不會產生稽核記錄的方法

某些方法可能不會產生稽核記錄，原因包括以下一或多項：

  • 該方法的流量使用量高，若產生稽核記錄，會導致記錄與儲存成本過高。
  • 稽核價值低。
  • 其他稽核記錄或平台記錄已涵蓋該方法的活動。

下列方法不會產生稽核記錄：

  • grpc.lookup.v1.RouteLookupService.RouteLookup