Información sobre registros de auditoría

En este documento se describe el registro de auditoría de Firestore con compatibilidad con MongoDB. Google Cloud Los servicios generan registros de auditoría que registran las actividades administrativas y de acceso en tus recursos de Google Cloud .

Para obtener más información sobre los registros de auditoría de Cloud, consulta los siguientes artículos:

Notas

Al configurar el registro de auditoría, usa el nombre de servicio datastore.googleapis.com para configurar tanto datastore.googleapis.com como firestore.googleapis.com. Once configured, logs for the Firestore with MongoDB compatibility API include the service namefirestore.googleapis.com`.

Para ver el tiempo que se ha tardado en procesar una solicitud DATA_READ o DATA_WRITE, consulta el campo processing_duration del objeto metadata de un AuditLog. El campo processing_duration describe el tiempo que ha tardado la base de datos en procesar una solicitud. Es inferior a la latencia del usuario final. En concreto, no incluye la sobrecarga de la red.

Nombre del servicio

Los registros de auditoría de Firestore usan el nombre de servicio firestore.googleapis.com. Filtrar por este servicio:

protoPayload.serviceName="firestore.googleapis.com"

Métodos por tipo de permiso

Cada permiso de gestión de identidades y accesos tiene una propiedad type, cuyo valor es una enumeración que puede ser uno de estos cuatro valores: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Cuando llamas a un método, Firestore genera un registro de auditoría cuya categoría depende de la propiedad type del permiso necesario para ejecutar el método.

Los métodos que requieren un permiso de gestión de identidades y accesos con el valor type de la propiedad DATA_READ, DATA_WRITE o ADMIN_READ generan registros de auditoría de acceso a datos.

Los métodos que requieren un permiso de gestión de identidades y accesos con el valor type de la propiedad ADMIN_WRITE generate Admin Activity (Generar actividad de administrador) generan registros de auditoría de actividad de administrador.

Tipo de permiso Métodos
ADMIN_READ google.cloud.location.Locations.GetLocation
google.cloud.location.Locations.ListLocations
google.firestore.admin.v1.FirestoreAdmin.GetBackup
google.firestore.admin.v1.FirestoreAdmin.GetBackupSchedule
google.firestore.admin.v1.FirestoreAdmin.GetDatabase
google.firestore.admin.v1.FirestoreAdmin.GetField
google.firestore.admin.v1.FirestoreAdmin.GetIndex
google.firestore.admin.v1.FirestoreAdmin.ListBackupSchedules
google.firestore.admin.v1.FirestoreAdmin.ListBackups
google.firestore.admin.v1.FirestoreAdmin.ListDatabases
google.firestore.admin.v1.FirestoreAdmin.ListFields
google.firestore.admin.v1.FirestoreAdmin.ListIndexes
google.firestore.admin.v1beta1.FirestoreAdmin.GetIndex
google.firestore.admin.v1.MongoDBCompatible.ListIndexes
google.firestore.admin.v1.MongoDBCompatible.ListDatabases
ADMIN_WRITE google.firestore.admin.v1.FirestoreAdmin.CreateBackupSchedule
google.firestore.admin.v1.FirestoreAdmin.CreateDatabase
google.firestore.admin.v1.FirestoreAdmin.CreateIndex
google.firestore.admin.v1.FirestoreAdmin.DeleteBackup
google.firestore.admin.v1.FirestoreAdmin.DeleteBackupSchedule
google.firestore.admin.v1.FirestoreAdmin.DeleteDatabase
google.firestore.admin.v1.FirestoreAdmin.DeleteIndex
google.firestore.admin.v1.FirestoreAdmin.RestoreDatabase
google.firestore.admin.v1.FirestoreAdmin.UpdateBackupSchedule
google.firestore.admin.v1.FirestoreAdmin.UpdateDatabase
google.firestore.admin.v1.FirestoreAdmin.UpdateField
google.longrunning.Operations.CancelOperation
google.longrunning.Operations.DeleteOperation
DATA_READ google.firestore.v1.MongoDBCompatible.Find
google.firestore.v1.MongoDBCompatible.Aggregate
google.firestore.v1.MongoDBCompatible.GetMore
google.firestore.v1.MongoDBCompatible.ListCollections
google.firestore.v1.MongoDBCompatible.Count
google.firestore.v1.MongoDBCompatible.Distinct
google.firestore.v1.MongoDBCompatible.CommitTransaction
google.firestore.v1.MongoDBCompatible.AbortTransaction
google.firestore.v1.MongoDBCompatible.EndSessions
google.firestore.v1.MongoDBCompatible.KillCursors
DATA_WRITE google.firestore.v1.MongoDBCompatible.Insert
google.firestore.v1.MongoDBCompatible.Update
google.firestore.v1.MongoDBCompatible.Delete
google.firestore.v1.MongoDBCompatible.FindAndModify
google.firestore.v1.MongoDBCompatible.CreateCollection

Identificar a los autores de las solicitudes

Las entradas del registro de auditoría incluyen información sobre la identidad que ha realizado la operación registrada. Para identificar el elemento que llama a una solicitud, consulta los siguientes campos de un objeto AuditLog:

  • La identidad de la persona que llama se almacena en el campo AuthenticationInfo. Esto puede incluir el principalEmail del usuario. Esta información se oculta en ocasiones.

  • El campo callerIp del objeto requestMetadata de una entrada AuditLog incluye la dirección IP de la persona que llama.