审核日志记录信息

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

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

备注

配置审核日志记录时，请使用服务名称 datastore.googleapis.com 同时配置 datastore.googleapis.com 和 firestore.googleapis.com。配置完成后，Firestore with MongoDB Compatibility API 的日志将包含服务名称 firestore.googleapis.com。

如需查看处理 DATA_READ 或 DATA_WRITE 请求所花的时间，请参阅 AuditLog 的 metadata 对象中的 processing_duration 字段。 processing_duration 用于描述数据库处理请求所花费的时间。这比最终用户延迟时间短。具体而言，不包括网络开销。

服务名称

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

    protoPayload.serviceName="firestore.googleapis.com"
  

方法（按权限类型）

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

识别请求调用方

审核日志条目包含有关执行所记录操作的身份的信息。如需识别请求调用方，请查看 AuditLog 对象中的以下字段：

• 调用者的身份保存在 AuthenticationInfo 字段中。这可能包括用户的 principalEmail。有时，我们会隐去此类信息。

• AuditLog 条目的 requestMetadata 对象中的 callerIp 字段包含调用方的 IP 地址。