Spanner 审核日志记录

本文档介绍了 Spanner 的审核日志记录。Google Cloud 服务会生成审核日志，以记录 Google Cloud 资源中的管理和访问活动。 如需详细了解 Cloud Audit Logs，请参阅以下内容：

• 审核日志类型
• 审核日志条目结构
• 存储和路由审核日志
• Cloud Logging 价格摘要
• 启用数据访问审核日志

备注

如需查看处理 DATA_READ 或 DATA_WRITE 请求所需的时间，请参阅“处理时长”部分。

服务名称

Spanner 审核日志使用服务名称 spanner.googleapis.com。 针对此服务的过滤条件：

    protoPayload.serviceName="spanner.googleapis.com"
  

方法（按权限类型）

执行读取操作的数据访问方法 Read、StreamingRead、ExecuteSql 和 ExecuteStreamingSql（如果在方法的 TransactionSelector 中指定）也可能会启动读写事务。在这种情况下，该方法将同时检查 DATA_READ 和 DATA_WRITE 权限类型。

每个 IAM 权限都有一个 type 属性，该属性的值是一个枚举，可以是以下四个值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。调用方法时 Spanner 生成类别取决于 执行该方法所需权限的 type 属性。 需要 IAM 权限且 type 属性值为 DATA_READ、DATA_WRITE 或 ADMIN_READ 的方法会生成数据访问审核日志。需要 IAM 权限且 type 属性值为 ADMIN_WRITE 的方法会生成管理员活动审核日志。

权限类型	方法
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.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

API 接口审核日志

如需了解如何为每种方法评估哪些权限以及评估哪些权限， 请参阅 Spanner 的 Identity and Access Management 文档。

google.cloud.keyvisualizer.KeyVisualizer

以下审核日志与属于 google.cloud.keyvisualizer.KeyVisualizer 的方法相关联。

GetScan

• 方法：google.cloud.keyvisualizer.KeyVisualizer.GetScan
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.read - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.keyvisualizer.KeyVisualizer.GetScan"
  

google.longrunning.Operations

以下审核日志与属于 google.longrunning.Operations 的方法相关联。

CancelOperation

• 方法：google.longrunning.Operations.CancelOperation
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backupOperations.cancel - ADMIN_WRITE
  • spanner.databaseOperations.cancel - ADMIN_WRITE
  • spanner.instanceOperations.cancel - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.longrunning.Operations.CancelOperation"
  

GetOperation

• 方法：google.longrunning.Operations.GetOperation
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.backupOperations.get - ADMIN_READ
  • spanner.databaseOperations.get - ADMIN_READ
  • spanner.instanceOperations.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.longrunning.Operations.GetOperation"
  

ListOperations

• 方法：google.longrunning.Operations.ListOperations
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.backupOperations.list - ADMIN_READ
  • spanner.databaseOperations.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.longrunning.Operations.ListOperations"
  

google.spanner.admin.database.v1.DatabaseAdmin

以下审核日志与属于 google.spanner.admin.database.v1.DatabaseAdmin 的方法相关联。

ChangeQuorum

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.ChangeQuorum
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.databases.changequorum - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ChangeQuorum"
  

CopyBackup

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.CopyBackup
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backups.copy - ADMIN_WRITE
  • spanner.backups.create - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CopyBackup"
  

CreateBackup

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backups.create - ADMIN_WRITE
  • spanner.databases.createBackup - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup"
  

注意 ：操作完成时记录的条目不包含任何身份验证或授权信息。操作开始时记录的匹配条目中提供了身份验证和授权信息。如需在日志浏览器中查找匹配的日志条目，请点击相应日志条目的 operation.id 字段，然后在菜单中选择显示匹配的条目。

CreateBackupSchedule

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.CreateBackupSchedule
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backupSchedules.create - ADMIN_WRITE
  • spanner.databases.createBackup - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CreateBackupSchedule"
  

CreateDatabase

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.databases.create - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase"
  

DeleteBackup

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backups.delete - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup"
  

DeleteBackupSchedule

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackupSchedule
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backupSchedules.delete - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackupSchedule"
  

DropDatabase

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.databases.drop - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase"
  

GetBackup

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.GetBackup
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.backups.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetBackup"
  

GetBackupSchedule

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.GetBackupSchedule
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.backupSchedules.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetBackupSchedule"
  

GetDatabase

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase"
  

GetDatabaseDdl

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.getDdl - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl"
  

GetIamPolicy

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.GetIamPolicy
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.backups.getIamPolicy - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.GetIamPolicy"
  

ListBackupOperations

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.backupOperations.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations"
  

ListBackupSchedules

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.ListBackupSchedules
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.backupSchedules.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListBackupSchedules"
  

ListBackups

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.ListBackups
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.backups.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListBackups"
  

ListDatabaseOperations

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databaseOperations.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations"
  

ListDatabaseRoles

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseRoles
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databaseRoles.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseRoles"
  

ListDatabases

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases"
  

RestoreDatabase

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backups.restoreDatabase - ADMIN_READ
  • spanner.databases.create - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase"
  

注意 ：虽然恢复数据库需要两个资源（备份和恢复的数据库，可能位于不同的实例）的授权，但是在恢复的数据库实例中，RestoreDatabase 事件仅作为单个条目记录一次。此条目中有两个 authorizationInfo 条目：一个用于数据库，用于检查 spanner.databases.create 权限，另一个用于备份，用于检查 spanner.backups.restoreDatabase 权限。
操作完成时记录的条目不包含任何身份验证或授权信息。身份验证和授权信息在操作开始时记录的匹配条目中提供。如需在日志浏览器中查找匹配的日志条目，请点击日志条目的 operation.id 字段，然后在菜单中选择显示匹配条目。

SetIamPolicy

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backups.setIamPolicy - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy"
  

TestIamPermissions

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.TestIamPermissions
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.TestIamPermissions"
  

UpdateBackup

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backups.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup"
  

UpdateBackupSchedule

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackupSchedule
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.backupSchedules.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackupSchedule"
  

UpdateDatabase

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabase
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.databases.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabase"
  

UpdateDatabaseDdl

• 方法：google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.databases.updateDdl - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl"
  

google.spanner.admin.instance.v1.InstanceAdmin

以下审核日志与属于 google.spanner.admin.instance.v1.InstanceAdmin 的方法相关联。

CreateInstance

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.instances.create - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance"
  

CreateInstanceConfig

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.CreateInstanceConfig
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.instanceConfigs.create - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstanceConfig"
  

CreateInstancePartition

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.CreateInstancePartition
  
• 审核日志类型：管理员活动
  
• 权限：
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstancePartition"
  

DeleteInstance

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.instances.delete - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance"
  

DeleteInstanceConfig

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstanceConfig
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.instanceConfigs.delete - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstanceConfig"
  

GetIamPolicy

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.instances.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy"
  

GetInstance

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.GetInstance
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.instances.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetInstance"
  

GetInstanceConfig

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.instanceConfigs.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig"
  

ListInstanceConfigs

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.instanceConfigs.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs"
  

ListInstances

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.ListInstances
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.instances.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.ListInstances"
  

MoveInstance

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.MoveInstance
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.instances.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.MoveInstance"
  

SetIamPolicy

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.instances.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy"
  

TestIamPermissions

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.instances.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions"
  

UpdateInstance

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.instances.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance"
  

UpdateInstanceConfig

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstanceConfig
  
• 审核日志类型：管理员活动
  
• 权限：
  • spanner.instanceConfigs.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstanceConfig"
  

UpdateInstancePartition

• 方法：google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstancePartition
  
• 审核日志类型：管理员活动
  
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstancePartition"
  

google.spanner.v1.Spanner

以下审核日志与属于 google.spanner.v1.Spanner 的方法相关联。

BatchCreateSessions

• 方法：google.spanner.v1.Spanner.BatchCreateSessions
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.sessions.create - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.BatchCreateSessions"
  

BatchWrite

• 方法：google.spanner.v1.Spanner.BatchWrite
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.write - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作： 流式传输 RPC
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.BatchWrite"
  

BeginTransaction

• 方法：google.spanner.v1.Spanner.BeginTransaction
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.beginReadOnlyTransaction - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.BeginTransaction"
  

注意：对于 ReadOnly 事务，此方法为 DATA_READ；对于 ReadWrite 事务，此方法为 DATA_WRITE。

Commit

• 方法：google.spanner.v1.Spanner.Commit
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.write - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.Commit"
  

CreateSession

• 方法：google.spanner.v1.Spanner.CreateSession
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.sessions.create - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.CreateSession"
  

DeleteSession

• 方法：google.spanner.v1.Spanner.DeleteSession
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.sessions.delete - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.DeleteSession"
  

ExecuteBatchDml

• 方法：google.spanner.v1.Spanner.ExecuteBatchDml
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.write - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.ExecuteBatchDml"
  

ExecuteSql

• 方法：google.spanner.v1.Spanner.ExecuteSql
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.select - DATA_READ
  • spanner.databases.write - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.ExecuteSql"
  

注意 ：如果在方法的 TransactionSelector 中指定，此方法也可能会启动读写事务。在这种情况下，该方法将同时与 DATA_READ 和 DATA_WRITE 权限类型匹配。

ExecuteStreamingSql

• 方法：google.spanner.v1.Spanner.ExecuteStreamingSql
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.select - DATA_READ
• 方法是长时间运行的操作或流式传输操作： 流式传输 RPC
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.ExecuteStreamingSql"
  

注意：注意：如果在方法的 TransactionSelector 中指定，此方法可能还会启动读写事务。在这种情况下，该方法将同时与 DATA_READ 和 DATA_WRITE 权限类型匹配。

GetSession

• 方法：google.spanner.v1.Spanner.GetSession
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.sessions.get - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.GetSession"
  

ListSessions

• 方法：google.spanner.v1.Spanner.ListSessions
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.sessions.list - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.ListSessions"
  

PartitionQuery

• 方法：google.spanner.v1.Spanner.PartitionQuery
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.beginReadOnlyTransaction - DATA_READ
  • spanner.databases.partitionQuery - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.PartitionQuery"
  

PartitionRead

• 方法：google.spanner.v1.Spanner.PartitionRead
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.partitionRead - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.PartitionRead"
  

Read

• 方法：google.spanner.v1.Spanner.Read
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.read - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.Read"
  

注意 ：如果在方法的 TransactionSelector 中指定，此方法也可能会启动读写事务。在这种情况下，该方法将同时与 DATA_READ 和 DATA_WRITE 权限类型匹配。
重要提示：系统不会记录请求的密钥。

Rollback

• 方法：google.spanner.v1.Spanner.Rollback
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.Rollback"
  

StreamingRead

• 方法：google.spanner.v1.Spanner.StreamingRead
  
• 审核日志类型：数据访问
  
• 权限：
  • spanner.databases.beginOrRollbackReadWriteTransaction - DATA_WRITE
  • spanner.databases.read - DATA_READ
• 方法是长时间运行的操作或流式传输操作： 流式传输 RPC
  
• 此方法的过滤条件： protoPayload.methodName="google.spanner.v1.Spanner.StreamingRead"
  

注意 ：如果在方法的 TransactionSelector 中指定，此方法也可能会启动读写事务。在这种情况下，该方法将同时与 DATA_READ 和 DATA_WRITE 权限类型匹配。
重要提示：系统不会记录请求的密钥。

系统事件

系统事件审核日志是 GCP 系统生成的，而不是通过直接用户操作生成的。如需了解详情，请参阅系统事件审核日志。

方法名称	过滤此事件	备注
AutoscaleInstance	protoPayload.methodName="AutoscaleInstance"
CreateScheduledBackup	protoPayload.methodName="CreateScheduledBackup"
OptimizeRestoredDatabase	protoPayload.methodName="OptimizeRestoredDatabase"

处理用时

如需查看处理 DATA_READ 或 DATA_WRITE 请求所花费的时间，请参阅 AuditLog 的 metadata 对象中的 processingDurationSeconds 字段。processingDurationSeconds可帮助您监控 你的请求延迟时间

processingDurationSeconds 用于描述 Spanner API 请求延迟时间。它是 Spanner API 前端收到请求的第一个字节到发送响应的最后一个字节之间的时长（以秒为单位）。处理 API 请求所需的时间 Spanner 后端和 API 层都是延迟时间。 不过，此延迟时间不包括 Spanner 客户端与服务器之间的网络开销或 Google Front End 开销。如需直观呈现 Spanner API 请求中涉及的高层级组件，请参阅 Spanner 端到端延迟时间指南。

例如，以下是包含 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"
}

对于 ExecuteStreamingSql、StreamingRead、PartitionRead 或 PartitionQuery 请求，则不会设置 processingDurationSeconds 字段。如需计算流式传输请求延迟时间和分区请求延迟时间，请参阅计算流式传输请求延迟时间和分区请求延迟时间。