Logging di controllo dell'API Cloud Bigtable

Questo documento descrive l'audit logging per l'API Cloud Bigtable. Google Cloud servizi generano audit log che registrano le attività amministrative e di accesso all'interno delle tue Google Cloud risorse. Per ulteriori informazioni su Cloud Audit Logs, consulta quanto segue:

Note

Quando una voce di log supera il limite di dimensioni, Cloud Logging la suddivide e distribuisce i dati in più voci. Per scoprire come identificare e ricomporre i log di controllo suddivisi, vedi Voci del log di controllo suddivise.

Nome servizio

Gli audit log dell'API Cloud Bigtable utilizzano il nome servizio bigtable.googleapis.com. Filtra per questo servizio: 

    protoPayload.serviceName="bigtable.googleapis.com"

Metodi per tipo di autorizzazione

Ogni autorizzazione IAM ha una proprietà type, il cui valore è un enum che può essere uno dei quattro valori: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Quando chiami un metodo, l'API Cloud Bigtable genera un audit log la cui categoria dipende dalla proprietà type dell'autorizzazione richiesta per eseguire il metodo. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type corrispondente a DATA_READ, DATA_WRITE o ADMIN_READ generano audit log degli Accessi ai dati. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type ADMIN_WRITE generano audit log delle Attività di amministrazione.

I metodi API nel seguente elenco contrassegnati con (LRO) sono operazioni a lunga esecuzione (LRO). Questi metodi in genere generano due voci del log di controllo: una all'inizio dell'operazione e un'altra al termine. Per saperne di più, consulta Audit log per le operazioni a lunga esecuzione.
Tipo di autorizzazione Metodi
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

Audit log dell'interfaccia API

Per informazioni su come e quali autorizzazioni vengono valutate per ogni metodo, consulta la documentazione di Identity and Access Management per l'API Cloud Bigtable.

google.bigtable.v2.Bigtable

I seguenti audit log sono associati ai metodi appartenenti a google.bigtable.v2.Bigtable.

CheckAndMutateRow

  • Metodo: google.bigtable.v2.Bigtable.CheckAndMutateRow
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.tables.mutateRows - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.CheckAndMutateRow"

ExecuteQuery

  • Metodo: google.bigtable.v2.Bigtable.ExecuteQuery
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.instances.executeQuery - DATA_READ
    • bigtable.tables.readRows - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: RPC di streaming
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.ExecuteQuery"

GenerateInitialChangeStreamPartitions

  • Metodo: google.bigtable.v2.Bigtable.GenerateInitialChangeStreamPartitions
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.tables.readRows - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: RPC di streaming
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.GenerateInitialChangeStreamPartitions"

MutateRow

  • Metodo: google.bigtable.v2.Bigtable.MutateRow
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.tables.mutateRows - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.MutateRow"

MutateRows

  • Metodo: google.bigtable.v2.Bigtable.MutateRows
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.tables.mutateRows - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: RPC di streaming
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.MutateRows"

PingAndWarm

  • Metodo: google.bigtable.v2.Bigtable.PingAndWarm
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.instances.ping - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.PingAndWarm"

PrepareQuery

  • Metodo: google.bigtable.v2.Bigtable.PrepareQuery
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.instances.executeQuery - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.PrepareQuery"

ReadChangeStream

  • Metodo: google.bigtable.v2.Bigtable.ReadChangeStream
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.tables.readRows - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: RPC di streaming
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.ReadChangeStream"

ReadModifyWriteRow

  • Metodo: google.bigtable.v2.Bigtable.ReadModifyWriteRow
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.tables.mutateRows - DATA_WRITE
    • bigtable.tables.readRows - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.ReadModifyWriteRow"

ReadRows

  • Metodo: google.bigtable.v2.Bigtable.ReadRows
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.tables.readRows - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: RPC di streaming
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.ReadRows"

SampleRowKeys

  • Metodo: google.bigtable.v2.Bigtable.SampleRowKeys
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • bigtable.tables.sampleRowKeys - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: RPC di streaming
  • Filtra per questo metodo: protoPayload.methodName="google.bigtable.v2.Bigtable.SampleRowKeys"

Metodi che non generano audit log

Un metodo potrebbe non generare audit log per uno o più dei seguenti motivi:

  • Si tratta di un metodo ad alto volume che comporta costi significativi per la generazione e l'archiviazione dei log.
  • Ha un valore di auditing basso.
  • Un altro audit log o log della piattaforma fornisce già la copertura del metodo.

I seguenti metodi non generano audit log:

  • grpc.lookup.v1.RouteLookupService.RouteLookup