Geração de registros de auditoria do Spanner

Este documento descreve o registro de auditoria do Spanner. Os serviços do Google Cloud geram registros de auditoria que registram atividades administrativas e de acesso nos recursos do Google Cloud. Para mais informações sobre os Registros de auditoria do Cloud, consulte:

• Tipos de registros de auditoria
• Estrutura da entrada de registro de auditoria
• Como armazenar e rotear registros de auditoria
• Resumo dos preços do Cloud Logging
• Ativar registros de auditoria de acesso a dados

Observações

Para conferir o tempo que levou para processar uma solicitação DATA_READ ou DATA_WRITE, consulte a seção Duração do processamento.

Nome do serviço

Os registros de auditoria do Spanner usam o nome de serviço spanner.googleapis.com. Filtrar por este serviço:

    protoPayload.serviceName="spanner.googleapis.com"
  

Métodos por tipo de permissão

Os métodos de acesso a dados Read, StreamingRead, ExecuteSql e ExecuteStreamingSql que executam uma operação de leitura também podem iniciar uma transação de leitura/gravação, se especificado no TransactionSelector do método. Nesses casos, o método vai verificar os tipos de permissão DATA_READ e DATA_WRITE.

Cada permissão do IAM tem uma propriedade type, que tem o valor de um tipo enumerado que pode ser um dos quatro valores: ADMIN_READ, ADMIN_WRITE, DATA_READ ou DATA_WRITE. Quando você chama um método, O Spanner gera um registro de auditoria com categoria dependente do type da permissão necessária para executar o método. Métodos que exigem uma permissão do IAM com o valor da propriedade type de DATA_READ, DATA_WRITE ou ADMIN_READ geram registros de auditoria de acesso aos dados. Métodos que exigem uma permissão do IAM com o valor da propriedade type de ADMIN_WRITE geram registros de auditoria de Atividade do administrador.

Tipo de permissão	Métodos
ADMIN_READ	google.longrunning.Operations.GetOperation google.longrunning.Operations.ListOperations google.spanner.admin.database.v1.DatabaseAdmin.CreateBackupSchedule 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.ListInstanceConfigs google.spanner.admin.instance.v1.InstanceAdmin.ListInstances google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions
ADMIN_WRITE	google.longrunning.Operations.CancelOperation google.spanner.admin.database.v1.DatabaseAdmin.ChangeQuorum google.spanner.admin.database.v1.DatabaseAdmin.CopyBackup google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup google.spanner.admin.database.v1.DatabaseAdmin.CreateBackupSchedule google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase 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 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 google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance google.spanner.admin.instance.v1.InstanceAdmin.CreateInstanceConfig google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstanceConfig google.spanner.admin.instance.v1.InstanceAdmin.MoveInstance google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstanceConfig
DATA_READ	google.cloud.keyvisualizer.KeyVisualizer.GetScan google.spanner.v1.Spanner.BeginTransaction 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.v1.Spanner.BatchCreateSessions google.spanner.v1.Spanner.BatchWrite google.spanner.v1.Spanner.Commit google.spanner.v1.Spanner.CreateSession google.spanner.v1.Spanner.DeleteSession google.spanner.v1.Spanner.ExecuteBatchDml google.spanner.v1.Spanner.ExecuteSql google.spanner.v1.Spanner.Rollback

Registros de auditoria da interface da API

Para informações sobre como e quais permissões são avaliadas para cada método, consulte a documentação do Identity and Access Management para o Spanner.

google.cloud.keyvisualizer.KeyVisualizer

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.cloud.keyvisualizer.KeyVisualizer.

GetScan

• Método: google.cloud.keyvisualizer.KeyVisualizer.GetScan
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.read - DATA_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.cloud.keyvisualizer.KeyVisualizer.GetScan"
  

google.longrunning.Operations

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.longrunning.Operations.

CancelOperation

• Método: google.longrunning.Operations.CancelOperation
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backupOperations.cancel - ADMIN_WRITE
  • spanner.databaseOperations.cancel - ADMIN_WRITE
  • spanner.instanceOperations.cancel - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.longrunning.Operations.CancelOperation"
  

GetOperation

• Método: google.longrunning.Operations.GetOperation
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.backupOperations.get - ADMIN_READ
  • spanner.databaseOperations.get - ADMIN_READ
  • spanner.instanceOperations.get - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.longrunning.Operations.GetOperation"
  

ListOperations

• Método: google.longrunning.Operations.ListOperations
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.backupOperations.list - ADMIN_READ
  • spanner.databaseOperations.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.longrunning.Operations.ListOperations"
  

google.spanner.admin.database.v1.DatabaseAdmin

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.spanner.admin.database.v1.DatabaseAdmin.

ChangeQuorum

• Método: google.spanner.admin.database.v1.DatabaseAdmin.ChangeQuorum
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.databases.changequorum - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ChangeQuorum"
  

CopyBackup

• Método: google.spanner.admin.database.v1.DatabaseAdmin.CopyBackup
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backups.copy - ADMIN_WRITE
  • spanner.backups.create - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CopyBackup"
  

CreateBackup

• Método: google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backups.create - ADMIN_WRITE
  • spanner.databases.createBackup - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup"
  

Observação: a entrada registrada quando a operação é concluída não contém informações de autenticação ou autorização. As informações de autenticação e autorização estão disponíveis na entrada correspondente que foi registrada quando a operação começou. Para encontrar a entrada de registro correspondente na Análise de registros, clique no campo operation.id da entrada e selecione Mostrar entradas correspondentes no menu.

CreateBackupSchedule

• Método: google.spanner.admin.database.v1.DatabaseAdmin.CreateBackupSchedule
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backupSchedules.create - ADMIN_WRITE
  • spanner.databases.createBackup - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CreateBackupSchedule"
  

CreateDatabase

• Método: google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.databases.create - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase"
  

DeleteBackup

• Método: google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backups.delete - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup"
  

DeleteBackupSchedule

• Método: google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackupSchedule
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backupSchedules.delete - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackupSchedule"
  

DropDatabase

• Método: google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.databases.drop - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase"
  

GetBackup

• Método: google.spanner.admin.database.v1.DatabaseAdmin.GetBackup
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.backups.get - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetBackup"
  

GetBackupSchedule

• Método: google.spanner.admin.database.v1.DatabaseAdmin.GetBackupSchedule
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.backupSchedules.get - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetBackupSchedule"
  

GetDatabase

• Método: google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.get - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase"
  

GetDatabaseDdl

• Método: google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.getDdl - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl"
  

GetIamPolicy

• Método: google.spanner.admin.database.v1.DatabaseAdmin.GetIamPolicy
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.backups.getIamPolicy - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetIamPolicy"
  

ListBackupOperations

• Método: google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.backupOperations.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations"
  

ListBackupSchedules

• Método: google.spanner.admin.database.v1.DatabaseAdmin.ListBackupSchedules
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.backupSchedules.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListBackupSchedules"
  

ListBackups

• Método: google.spanner.admin.database.v1.DatabaseAdmin.ListBackups
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.backups.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListBackups"
  

ListDatabaseOperations

• Método: google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databaseOperations.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations"
  

ListDatabaseRoles

• Método: google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseRoles
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databaseRoles.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseRoles"
  

ListDatabases

• Método: google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases"
  

RestoreDatabase

• Método: google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backups.restoreDatabase - ADMIN_READ
  • spanner.databases.create - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase"
  

Observação: embora a restauração de um banco de dados exija autorização em dois recursos (o backup e o banco de dados restaurado, que podem residir em instâncias diferentes), o evento RestoreDatabase é registrado apenas uma vez como uma única entrada na instância do banco de dados restaurado. Nessa entrada, haverá duas entradas authorizationInfo: uma para o banco de dados, verificando a permissão spanner.databases.create, e outra para o backup, verificando a permissão spanner.backups.restoreDatabase.
A entrada registrada quando a operação é concluída não contém informações de autenticação ou autorização. As informações de autenticação e autorização estão disponíveis na entrada correspondente registrada quando a operação começa. Para encontrar a entrada de registro correspondente na Análise de registros, clique no campo operation.id da entrada e selecione Mostrar entradas correspondentes no menu.

SetIamPolicy

• Método: google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backups.setIamPolicy - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy"
  

TestIamPermissions

• Método: google.spanner.admin.database.v1.DatabaseAdmin.TestIamPermissions
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.TestIamPermissions"
  

UpdateBackup

• Método: google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backups.update - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup"
  

UpdateBackupSchedule

• Método: google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackupSchedule
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.backupSchedules.update - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackupSchedule"
  

UpdateDatabase

• Método: google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabase
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.databases.update - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabase"
  

UpdateDatabaseDdl

• Método: google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.databases.updateDdl - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl"
  

google.spanner.admin.instance.v1.InstanceAdmin

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.spanner.admin.instance.v1.InstanceAdmin.

CreateInstance

• Método: google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.instances.create - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance"
  

CreateInstanceConfig

• Método: google.spanner.admin.instance.v1.InstanceAdmin.CreateInstanceConfig
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.instanceConfigs.create - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstanceConfig"
  

CreateInstancePartition

• Método: google.spanner.admin.instance.v1.InstanceAdmin.CreateInstancePartition
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstancePartition"
  

DeleteInstance

• Método: google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.instances.delete - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance"
  

DeleteInstanceConfig

• Método: google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstanceConfig
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.instanceConfigs.delete - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstanceConfig"
  

GetIamPolicy

• Método: google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.instances.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy"
  

GetInstance

• Método: google.spanner.admin.instance.v1.InstanceAdmin.GetInstance
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.instances.get - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetInstance"
  

GetInstanceConfig

• Método: google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.instanceConfigs.get - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig"
  

ListInstanceConfigs

• Método: google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.instanceConfigs.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs"
  

ListInstances

• Método: google.spanner.admin.instance.v1.InstanceAdmin.ListInstances
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.instances.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.ListInstances"
  

MoveInstance

• Método: google.spanner.admin.instance.v1.InstanceAdmin.MoveInstance
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.instances.update - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.MoveInstance"
  

SetIamPolicy

• Método: google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.instances.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy"
  

TestIamPermissions

• Método: google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.instances.list - ADMIN_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions"
  

UpdateInstance

• Método: google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.instances.update - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance"
  

UpdateInstanceConfig

• Método: google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstanceConfig
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.instanceConfigs.update - ADMIN_WRITE
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstanceConfig"
  

UpdateInstancePartition

• Método: google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstancePartition
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
• O método é uma operação de streaming ou de longa duração: operação de longa duração
  
• Filtrar para este método: protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstancePartition"
  

google.spanner.v1.Spanner

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.spanner.v1.Spanner.

BatchCreateSessions

• Método: google.spanner.v1.Spanner.BatchCreateSessions
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.sessions.create - DATA_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.BatchCreateSessions"
  

BatchWrite

• Método: google.spanner.v1.Spanner.BatchWrite
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.write - DATA_WRITE
• O método é uma operação de streaming ou de longa duração: RPC de streaming
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.BatchWrite"
  

BeginTransaction

• Método: google.spanner.v1.Spanner.BeginTransaction
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.beginReadOnlyTransaction - DATA_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.BeginTransaction"
  

Observação: esse método será DATA_READ para uma transação ReadOnly e DATA_WRITE para uma transação ReadWrite.

Commit

• Método: google.spanner.v1.Spanner.Commit
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.write - DATA_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.Commit"
  

CreateSession

• Método: google.spanner.v1.Spanner.CreateSession
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.sessions.create - DATA_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.CreateSession"
  

DeleteSession

• Método: google.spanner.v1.Spanner.DeleteSession
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.sessions.delete - DATA_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.DeleteSession"
  

ExecuteBatchDml

• Método: google.spanner.v1.Spanner.ExecuteBatchDml
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.write - DATA_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.ExecuteBatchDml"
  

ExecuteSql

• Método: google.spanner.v1.Spanner.ExecuteSql
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.select - DATA_READ
  • spanner.databases.write - DATA_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.ExecuteSql"
  

Observação : esse método também pode iniciar uma transação de leitura/gravação se especificado no TransactionSelector do método. Nesses casos, o método corresponderá aos tipos de permissão DATA_READ e DATA_WRITE.

ExecuteStreamingSql

• Método: google.spanner.v1.Spanner.ExecuteStreamingSql
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.select - DATA_READ
• O método é uma operação de streaming ou de longa duração: RPC de streaming
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.ExecuteStreamingSql"
  

Observação: esse método também pode iniciar uma transação de leitura e gravação, se especificado no TransactionSelector do método. Nesses casos, o método corresponderá aos tipos de permissão DATA_READ e DATA_WRITE.

GetSession

• Método: google.spanner.v1.Spanner.GetSession
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.sessions.get - DATA_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.GetSession"
  

ListSessions

• Método: google.spanner.v1.Spanner.ListSessions
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.sessions.list - DATA_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.ListSessions"
  

PartitionQuery

• Método: google.spanner.v1.Spanner.PartitionQuery
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.beginReadOnlyTransaction - DATA_READ
  • spanner.databases.partitionQuery - DATA_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.PartitionQuery"
  

PartitionRead

• Método: google.spanner.v1.Spanner.PartitionRead
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.partitionRead - DATA_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.PartitionRead"
  

Read

• Método: google.spanner.v1.Spanner.Read
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.read - DATA_READ
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.Read"
  

Observação : esse método também pode iniciar uma transação de leitura/gravação se especificado no TransactionSelector do método. Nesses casos, o método corresponderá aos tipos de permissão DATA_READ e DATA_WRITE.
Importante: as chaves solicitadas não são registradas.

Rollback

• Método: google.spanner.v1.Spanner.Rollback
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
• O método é uma operação de streaming ou de longa duração: No
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.Rollback"
  

StreamingRead

• Método: google.spanner.v1.Spanner.StreamingRead
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.read - DATA_READ
• O método é uma operação de streaming ou de longa duração: RPC de streaming
  
• Filtrar para este método: protoPayload.methodName="google.spanner.v1.Spanner.StreamingRead"
  

Observação : esse método também pode iniciar uma transação de leitura/gravação se especificado no TransactionSelector do método. Nesses casos, o método vai corresponder aos tipos de permissão DATA_READ e DATA_WRITE.
Importante: as chaves solicitadas não são registradas.

Eventos do sistema

Os registros de auditoria de eventos do sistema são gerados pelos sistemas do GCP, e não por ações diretas do usuário. Para mais informações, consulte Registros de auditoria de eventos do sistema.

Nome do método	Filtrar para este evento	Observações
AutoscaleInstance	protoPayload.methodName="AutoscaleInstance"
CreateScheduledBackup	protoPayload.methodName="CreateScheduledBackup"
OptimizeRestoredDatabase	protoPayload.methodName="OptimizeRestoredDatabase"

Duração do processamento

Para conferir o tempo que levou para processar uma solicitação DATA_READ ou DATA_WRITE, consulte o campo processingDurationSeconds no objeto metadata do AuditLog. O processingDurationSeconds ajuda você a monitorar as latências das solicitações.

processingDurationSeconds descreve a latência da solicitação da API Spanner. É o período (em segundos) entre o momento em que O front-end da API Spanner recebe o primeiro byte de uma solicitação quando ele envia o último byte de uma resposta. O tempo necessário para processar solicitações de API no back-end do Spanner e na camada de API é a latência. No entanto, essa latência não inclui sobrecarga da rede ou do Google Front End entre clientes e servidores do Spanner. Para visualizar os componentes de alto nível envolvidos em uma solicitação da API Spanner, consulte o Guia completo de latência do Spanner.

Por exemplo, o registro de auditoria a seguir contém informações de 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"
}

Para ExecuteStreamingSql, StreamingRead, PartitionRead ou PartitionQuery solicitações, o campo processingDurationSeconds não será definido. Para calcular a streaming e latência de solicitação de partição, consulte Calcule a latência de solicitações de streaming e de partição.