Audit logging di Spanner

Questo documento descrive l'audit logging per Spanner. Google Cloud i 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:

• Tipi di audit log
• Struttura della voce di audit log
• Archiviazione e routing degli audit log
• Riepilogo dei prezzi di Cloud Logging
• Abilita gli audit log di accesso ai dati

Note

Per visualizzare il tempo impiegato per elaborare una richiesta DATA_READ o DATA_WRITE, consulta la sezione Durata dell'elaborazione.

Nome servizio

Gli audit log di Spanner utilizzano il nome servizio spanner.googleapis.com. Filtra per questo servizio:

    protoPayload.serviceName="spanner.googleapis.com"
  

Metodi per tipo di autorizzazione

I

metodi di accesso ai dati Read, StreamingRead, ExecuteSql e ExecuteStreamingSql che eseguono un'operazione di lettura potrebbero anche avviare una transazione di lettura/scrittura se specificato in TransactionSelector del metodo. In questi casi, il metodo controllerà entrambi i tipi di autorizzazione DATA_READ e DATA_WRITE.

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, Spanner 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.longrunning.Operations.GetOperation google.longrunning.Operations.ListOperations google.spanner.admin.database.v1.DatabaseAdmin.GetBackup google.spanner.admin.database.v1.DatabaseAdmin.GetBackupSchedule google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl google.spanner.admin.database.v1.DatabaseAdmin.GetIamPolicy google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations google.spanner.admin.database.v1.DatabaseAdmin.ListBackupSchedules google.spanner.admin.database.v1.DatabaseAdmin.ListBackups google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseRoles google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases google.spanner.admin.database.v1.DatabaseAdmin.TestIamPermissions google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy google.spanner.admin.instance.v1.InstanceAdmin.GetInstance google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig google.spanner.admin.instance.v1.InstanceAdmin.GetInstancePartition google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs google.spanner.admin.instance.v1.InstanceAdmin.ListInstancePartitions google.spanner.admin.instance.v1.InstanceAdmin.ListInstances google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions
ADMIN_WRITE	google.longrunning.Operations.CancelOperation google.spanner.admin.database.v1.DatabaseAdmin.AddSplitPoints google.spanner.admin.database.v1.DatabaseAdmin.ChangeQuorum (LRO) google.spanner.admin.database.v1.DatabaseAdmin.CopyBackup (LRO) google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup (LRO) google.spanner.admin.database.v1.DatabaseAdmin.CreateBackupSchedule google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase (LRO) google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackupSchedule google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase (LRO) google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackupSchedule google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabase (LRO) google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl (LRO) google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance (LRO) google.spanner.admin.instance.v1.InstanceAdmin.CreateInstanceConfig (LRO) google.spanner.admin.instance.v1.InstanceAdmin.CreateInstancePartition (LRO) google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstanceConfig google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstancePartition google.spanner.admin.instance.v1.InstanceAdmin.MoveInstance (LRO) google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance (LRO) google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstanceConfig (LRO) google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstancePartition (LRO)
DATA_READ	google.cloud.keyvisualizer.KeyVisualizer.GetScan google.spanner.adapter.v1.Adapter.AdaptMessage google.spanner.v1.Spanner.BeginTransaction google.spanner.v1.Spanner.ExecuteSql google.spanner.v1.Spanner.ExecuteStreamingSql google.spanner.v1.Spanner.GetSession google.spanner.v1.Spanner.ListSessions google.spanner.v1.Spanner.PartitionQuery google.spanner.v1.Spanner.PartitionRead google.spanner.v1.Spanner.Read google.spanner.v1.Spanner.StreamingRead
DATA_WRITE	google.spanner.adapter.v1.Adapter.AdaptMessage google.spanner.adapter.v1.Adapter.CreateSession google.spanner.v1.Spanner.BatchCreateSessions google.spanner.v1.Spanner.BatchWrite google.spanner.v1.Spanner.BeginTransaction google.spanner.v1.Spanner.Commit google.spanner.v1.Spanner.CreateSession google.spanner.v1.Spanner.DeleteSession google.spanner.v1.Spanner.ExecuteBatchDml google.spanner.v1.Spanner.Rollback

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 Spanner.

google.cloud.keyvisualizer.KeyVisualizer

I seguenti audit log sono associati ai metodi appartenenti a google.cloud.keyvisualizer.KeyVisualizer.

GetScan

• Metodo: google.cloud.keyvisualizer.KeyVisualizer.GetScan
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.read - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.keyvisualizer.KeyVisualizer.GetScan"
  

google.longrunning.Operations

I seguenti audit log sono associati ai metodi appartenenti a google.longrunning.Operations.

CancelOperation

• Metodo: google.longrunning.Operations.CancelOperation
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backupOperations.cancel - ADMIN_WRITE
  • spanner.databaseOperations.cancel - ADMIN_WRITE
  • spanner.instanceOperations.cancel - ADMIN_WRITE
  • spanner.instancePartitionOperations.cancel - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.CancelOperation"
  

GetOperation

• Metodo: google.longrunning.Operations.GetOperation
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.backupOperations.get - ADMIN_READ
  • spanner.databaseOperations.get - ADMIN_READ
  • spanner.instanceOperations.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.GetOperation"
  

ListOperations

• Metodo: google.longrunning.Operations.ListOperations
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.backupOperations.list - ADMIN_READ
  • spanner.databaseOperations.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.ListOperations"
  

google.spanner.adapter.v1.Adapter

I seguenti audit log sono associati ai metodi appartenenti a google.spanner.adapter.v1.Adapter.

AdaptMessage

• Metodo: google.spanner.adapter.v1.Adapter.AdaptMessage
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.adapt - DATA_WRITE
  • spanner.databases.select - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.adapter.v1.Adapter.AdaptMessage"
  

CreateSession

• Metodo: google.spanner.adapter.v1.Adapter.CreateSession
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.sessions.create - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.adapter.v1.Adapter.CreateSession"
  

google.spanner.admin.database.v1.DatabaseAdmin

I seguenti audit log sono associati ai metodi appartenenti a google.spanner.admin.database.v1.DatabaseAdmin.

AddSplitPoints

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.AddSplitPoints
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.databases.addSplitPoints - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.AddSplitPoints"
  

ChangeQuorum

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.ChangeQuorum
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.databases.changequorum - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ChangeQuorum"
  

CopyBackup

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.CopyBackup
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backups.copy - ADMIN_WRITE
  • spanner.backups.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CopyBackup"
  

CreateBackup

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backups.create - ADMIN_WRITE
  • spanner.databases.createBackup - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup"
  

Nota : la voce registrata al termine dell'operazione non contiene informazioni di autenticazione o autorizzazione. Le informazioni di autenticazione e autorizzazione sono disponibili nella voce corrispondente registrata all'inizio dell'operazione. Per trovare la voce di log corrispondente in Esplora log, fai clic sul campo operation.id della voce di log e poi seleziona Mostra voci corrispondenti nel menu.

CreateBackupSchedule

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.CreateBackupSchedule
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backupSchedules.create - ADMIN_WRITE
  • spanner.databases.createBackup - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CreateBackupSchedule"
  

CreateDatabase

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.databases.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase"
  

DeleteBackup

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backups.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup"
  

DeleteBackupSchedule

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackupSchedule
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backupSchedules.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackupSchedule"
  

DropDatabase

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.databases.drop - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase"
  

GetBackup

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.GetBackup
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.backups.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetBackup"
  

GetBackupSchedule

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.GetBackupSchedule
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.backupSchedules.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetBackupSchedule"
  

GetDatabase

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase"
  

GetDatabaseDdl

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.getDdl - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl"
  

GetIamPolicy

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.GetIamPolicy
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.backups.getIamPolicy - ADMIN_READ
  • spanner.databases.getIamPolicy - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetIamPolicy"
  

ListBackupOperations

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.backupOperations.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations"
  

ListBackupSchedules

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.ListBackupSchedules
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.backupSchedules.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListBackupSchedules"
  

ListBackups

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.ListBackups
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.backups.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListBackups"
  

ListDatabaseOperations

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databaseOperations.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations"
  

ListDatabaseRoles

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseRoles
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databaseRoles.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseRoles"
  

ListDatabases

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases"
  

RestoreDatabase

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backups.restoreDatabase - ADMIN_READ
  • spanner.databases.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase"
  

Nota : anche se il ripristino di un database richiede l'autorizzazione su due risorse (il backup e il database ripristinato, che potrebbero risiedere in istanze diverse), l'evento RestoreDatabase viene registrato una sola volta come singola voce nell'istanza del database ripristinato. All'interno di questa voce, saranno presenti due voci authorizationInfo: una per il database, che controlla l'autorizzazione spanner.databases.create, e una per il backup, che controlla l'autorizzazione spanner.backups.restoreDatabase.
La voce registrata al termine dell'operazione non contiene informazioni di autenticazione o autorizzazione. Le informazioni di autenticazione e autorizzazione sono disponibili nella voce corrispondente registrata all'inizio dell'operazione. Per trovare la voce di log corrispondente in Esplora log, fai clic sul campo operation.id della voce di log e poi seleziona Mostra voci corrispondenti nel menu.

SetIamPolicy

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backups.setIamPolicy - ADMIN_WRITE
  • spanner.databases.setIamPolicy - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy"
  

TestIamPermissions

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.TestIamPermissions
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.TestIamPermissions"
  

UpdateBackup

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backups.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup"
  

UpdateBackupSchedule

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackupSchedule
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.backupSchedules.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackupSchedule"
  

UpdateDatabase

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabase
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.databases.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabase"
  

UpdateDatabaseDdl

• Metodo: google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.databases.updateDdl - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl"
  

google.spanner.admin.instance.v1.InstanceAdmin

I seguenti audit log sono associati ai metodi appartenenti a google.spanner.admin.instance.v1.InstanceAdmin.

CreateInstance

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instances.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance"
  

CreateInstanceConfig

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.CreateInstanceConfig
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instanceConfigs.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstanceConfig"
  

CreateInstancePartition

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.CreateInstancePartition
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instancePartitions.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstancePartition"
  

DeleteInstance

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instances.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance"
  

DeleteInstanceConfig

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstanceConfig
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instanceConfigs.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstanceConfig"
  

DeleteInstancePartition

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstancePartition
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instancePartitions.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstancePartition"
  

GetIamPolicy

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.instances.getIamPolicy - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy"
  

GetInstance

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.GetInstance
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.instances.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetInstance"
  

GetInstanceConfig

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.instanceConfigs.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig"
  

GetInstancePartition

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.GetInstancePartition
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.instancePartitions.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetInstancePartition"
  

ListInstanceConfigs

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.instanceConfigs.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs"
  

ListInstancePartitions

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.ListInstancePartitions
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.instancePartitions.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.ListInstancePartitions"
  

ListInstances

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.ListInstances
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.instances.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.ListInstances"
  

MoveInstance

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.MoveInstance
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instances.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.MoveInstance"
  

SetIamPolicy

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instances.setIamPolicy - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy"
  

TestIamPermissions

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.instances.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions"
  

UpdateInstance

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instances.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance"
  

UpdateInstanceConfig

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstanceConfig
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instanceConfigs.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstanceConfig"
  

UpdateInstancePartition

• Metodo: google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstancePartition
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • spanner.instancePartitions.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstancePartition"
  

google.spanner.v1.Spanner

I seguenti audit log sono associati ai metodi appartenenti a google.spanner.v1.Spanner.

BatchCreateSessions

• Metodo: google.spanner.v1.Spanner.BatchCreateSessions
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.sessions.create - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.BatchCreateSessions"
  

BatchWrite

• Metodo: google.spanner.v1.Spanner.BatchWrite
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.write - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: RPC di streaming
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.BatchWrite"
  

BeginTransaction

• Metodo: google.spanner.v1.Spanner.BeginTransaction
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.beginReadOnlyTransaction - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.BeginTransaction"
  

Nota: questo metodo sarà DATA_READ per una transazione ReadOnly e DATA_WRITE per una transazione ReadWrite.

Commit

• Metodo: google.spanner.v1.Spanner.Commit
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.write - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.Commit"
  

CreateSession

• Metodo: google.spanner.v1.Spanner.CreateSession
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.sessions.create - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.CreateSession"
  

DeleteSession

• Metodo: google.spanner.v1.Spanner.DeleteSession
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.sessions.delete - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.DeleteSession"
  

ExecuteBatchDml

• Metodo: google.spanner.v1.Spanner.ExecuteBatchDml
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.write - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.ExecuteBatchDml"
  

ExecuteSql

• Metodo: google.spanner.v1.Spanner.ExecuteSql
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.select - DATA_READ
  • spanner.databases.write - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.ExecuteSql"
  

Nota: questo metodo potrebbe avviare anche una transazione di lettura/scrittura se specificato in TransactionSelector del metodo. In questi casi, il metodo corrisponderà ai tipi di autorizzazione DATA_READ e DATA_WRITE.

ExecuteStreamingSql

• Metodo: google.spanner.v1.Spanner.ExecuteStreamingSql
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.select - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: RPC di streaming
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.ExecuteStreamingSql"
  

Nota: questo metodo potrebbe avviare anche una transazione di lettura/scrittura se specificato in TransactionSelector del metodo. In questi casi, il metodo corrisponderà ai tipi di autorizzazione DATA_READ e DATA_WRITE.

GetSession

• Metodo: google.spanner.v1.Spanner.GetSession
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.sessions.get - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.GetSession"
  

ListSessions

• Metodo: google.spanner.v1.Spanner.ListSessions
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.sessions.list - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.ListSessions"
  

PartitionQuery

• Metodo: google.spanner.v1.Spanner.PartitionQuery
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databaseRoles.use - DATA_WRITE
  • spanner.databases.beginReadOnlyTransaction - DATA_READ
  • spanner.databases.partitionQuery - DATA_READ
  • spanner.databases.useRoleBasedAccess - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.PartitionQuery"
  

PartitionRead

• Metodo: google.spanner.v1.Spanner.PartitionRead
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.partitionRead - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.PartitionRead"
  

Read

• Metodo: google.spanner.v1.Spanner.Read
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.read - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.Read"
  

Nota: questo metodo potrebbe avviare anche una transazione di lettura/scrittura se specificato in TransactionSelector del metodo. In questi casi, il metodo corrisponderà a entrambi i tipi di autorizzazione DATA_READ e DATA_WRITE.
Importante: le chiavi richieste non vengono registrate.

Rollback

• Metodo: google.spanner.v1.Spanner.Rollback
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.Rollback"
  

StreamingRead

• Metodo: google.spanner.v1.Spanner.StreamingRead
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.read - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: RPC di streaming
  
• Filtra per questo metodo: protoPayload.methodName="google.spanner.v1.Spanner.StreamingRead"
  

Nota: questo metodo potrebbe avviare anche una transazione di lettura/scrittura se specificato in TransactionSelector del metodo. In questi casi, il metodo corrisponderà a entrambi i tipi di autorizzazione DATA_READ e DATA_WRITE.
Importante: le chiavi richieste non vengono registrate.

Eventi di sistema

Gli audit log degli eventi di sistema vengono generati dai sistemi Google Cloud, non dall'azione diretta dell'utente. Per ulteriori informazioni, vedi audit log degli eventi di sistema.

Nome metodo	Filtra per questo evento	Note
AutoscaleInstance	protoPayload.methodName="AutoscaleInstance"
CreateScheduledBackup	protoPayload.methodName="CreateScheduledBackup"
OptimizeRestoredDatabase	protoPayload.methodName="OptimizeRestoredDatabase"

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:

• google.cloud.keyvisualizer.KeyVisualizer.ListScans
• google.longrunning.Operations.WaitOperation

Durata dell'elaborazione

Per visualizzare il tempo impiegato per elaborare una richiesta DATA_READ o DATA_WRITE, fai riferimento al campo processingDurationSeconds all'interno dell'oggetto metadata di AuditLog. processingDurationSeconds ti aiuta a monitorare le latenze delle richieste.

processingDurationSeconds descrive la latenza delle richieste API Spanner. È il periodo di tempo (in secondi) che intercorre tra il momento in cui il frontend dell'API Spanner riceve il primo byte di una richiesta e il momento in cui invia l'ultimo byte di una risposta. Il tempo necessario per elaborare le richieste API sia nel backend Spanner sia nel livello API è la latenza. Tuttavia, questa latenza non include l'overhead di rete o di Google Front End (GFE) tra i client e i server Spanner. Per visualizzare i componenti di alto livello coinvolti in una richiesta API Spanner, consulta la guida alla latenza end-to-end di Spanner.

Ad esempio, di seguito è riportato un log di controllo che contiene informazioni processingDurationSeconds:

{
  "protoPayload": {
    "@type": "type.googleapis.com/google.cloud.audit.AuditLog",
    "authenticationInfo": {...},
    "requestMetadata": {...},
    "serviceName": "spanner.googleapis.com",
    "methodName": "google.spanner.v1.Spanner.Commit",
    "authorizationInfo": [{...}],
    "resourceName": "projects/example-project/instances/example-instance/databases/example-database/sessions/example-session",
    "request": {
      "transactionId": "example-transactionId",
      "@type": "type.googleapis.com/google.spanner.v1.CommitRequest",
      "session": "projects/example-project/instances/example-instance/databases/example-database/sessions/example-session"
    },
    "response": {
      "@type": "type.googleapis.com/google.spanner.v1.CommitResponse",
      "commitTimestamp": "2023-02-13T17:11:10.106602Z"
    },
    "metadata": {
      "@type": "type.googleapis.com/spanner.cloud.instance_v1.QueryPerformanceMetadata",
      "processingDurationSeconds": 0.1932541
    }
  },
  "insertId": "p9ju4gdi7j0",
  "resource": {...},
  "timestamp": "2023-02-13T17:11:10.000093953Z",
  "severity": "INFO",
  "logName": "projects/example-project/logs/cloudaudit.googleapis.com%2Fdata_access",
  "receiveTimestamp": "2023-02-13T17:11:11.170517524Z"
}

Per le richieste ExecuteStreamingSql, StreamingRead, PartitionRead o PartitionQuery, il campo processingDurationSeconds non è impostato. Per calcolare la latenza delle richieste di streaming e partizione, consulta Calcolare la latenza delle richieste di streaming e partizione.