Geração de registros de auditoria do Spanner

Neste documento, descrevemos a geração de registros de auditoria do Spanner.Os serviços do Google Cloud geram registros de auditoria de 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 aos dados

Observações

Para ver o tempo necessário 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 realizam 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 da propriedade 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.

Os métodos de API na lista a seguir marcados com (LRO) são operações de longa duração (LROs). Esses métodos geralmente geram duas entradas de registro de auditoria: uma quando a operação começa e outra quando ela termina. Para mais informações, consulte Registros de auditoria para operações de longa duração.

Tipo de permissão	Métodos
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

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
  • spanner.instancePartitionOperations.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.adapter.v1.Adapter

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

AdaptMessage

• Método: google.spanner.adapter.v1.Adapter.AdaptMessage
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.databases.adapt - DATA_WRITE
  • spanner.databases.select - 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.adapter.v1.Adapter.AdaptMessage"
  

CreateSession

• Método: google.spanner.adapter.v1.Adapter.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.adapter.v1.Adapter.CreateSession"
  

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.

AddSplitPoints

• Método: google.spanner.admin.database.v1.DatabaseAdmin.AddSplitPoints
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.databases.addSplitPoints - 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.AddSplitPoints"
  

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 registrada quando a operação começa. Para encontrar a entrada de registro correspondente no Explorador 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
  • spanner.databases.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 no Explorador 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
  • spanner.databases.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:
  • spanner.instancePartitions.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.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"
  

DeleteInstancePartition

• Método: google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstancePartition
  
• Tipo de registro de auditoria: atividade do administrador
  
• Permissões:
  • spanner.instancePartitions.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.DeleteInstancePartition"
  

GetIamPolicy

• Método: google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.instances.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.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"
  

GetInstancePartition

• Método: google.spanner.admin.instance.v1.InstanceAdmin.GetInstancePartition
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.instancePartitions.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.GetInstancePartition"
  

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"
  

ListInstancePartitions

• Método: google.spanner.admin.instance.v1.InstanceAdmin.ListInstancePartitions
  
• Tipo de registro de auditoria: acesso a dados
  
• Permissões:
  • spanner.instancePartitions.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.ListInstancePartitions"
  

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.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.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:
  • spanner.instancePartitions.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.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.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.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 e 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.

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

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.databaseRoles.use - DATA_WRITE
  • spanner.databases.beginReadOnlyTransaction - DATA_READ
  • spanner.databases.partitionQuery - DATA_READ
  • spanner.databases.useRoleBasedAccess - 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.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 e 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.

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 e 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"

Métodos que não geram registros de auditoria

Um método pode não gerar registros de auditoria por um ou mais dos seguintes motivos:

• É um método de alto volume que envolve geração de registros significativos e custos de armazenamento.
• Tem pouco valor para a auditoria.
• Outro registro de auditoria ou plataforma já oferece cobertura do método.

Os métodos abaixo não geram registros de auditoria:

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

Duração do tratamento

Para ver o tempo necessário para processar uma solicitação DATA_READ ou DATA_WRITE, consulte o campo processingDurationSeconds no objeto metadata de AuditLog. A processingDurationSeconds ajuda a monitorar as latências de solicitação.

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 e o momento em que 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 a sobrecarga de 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 de latência completa do Spanner.

Por exemplo, este é um registro de auditoria que 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 solicitações ExecuteStreamingSql, StreamingRead, PartitionRead ou PartitionQuery, o campo processingDurationSeconds não é definido. Para calcular a latência de solicitação de streaming e partição, consulte Calcular a latência de solicitação de streaming e partição.