En este documento se describe el modelo de datos que usa Cloud Logging. El modelo de datos especifica el formato en el que se almacenan los datos de registro. También determina las dimensiones sobre las que puedes consultar tus datos de registro.
Modelo de datos
En Cloud Logging, un registro es una colección con nombre de entradas individuales.
Puedes consultar tus datos por el nombre del registro. Los registros se componen de entradas que se ajustan a la estructura LogEntry
.
Cada entrada de registro registra un estado o describe un evento específico, como la creación de una instancia de máquina virtual, y consta como mínimo de lo siguiente:
- Marca de tiempo que indica cuándo se produjo el evento o cuándo lo recibió Cloud Logging.
- Información sobre la fuente de la entrada del registro. Esta fuente se llama recurso monitorizado. Entre los recursos monitorizados se incluyen instancias de Compute Engine y contenedores de Google Kubernetes Engine. Para ver una lista completa de los tipos de recursos supervisados, consulta Recursos y servicios supervisados.
Una carga útil que debe ser una de las siguientes:
textPayload
: estas cargas útiles tienen el formato de una sola cadena.jsonPayload
: estas cargas útiles están estructuradas, por lo que puedes hacer consultas por pares clave-valor. Recomendamos que las aplicaciones siempre escriban datos de registro estructurados.protoPayload
: estas cargas útiles siguen el formato de un archivo proto y los campos se formatean como JSON.
El nombre del registro al que pertenece. El nombre de un registro incluye la ruta completa del recurso al que pertenecen las entradas de registro, seguida de un identificador. Estos son algunos ejemplos de nombres de registros:
projects/my-project/logs/stdout
projects/my-project/compute.googleapis.com/activity
Puedes escribir consultas que recuperen solo las entradas de registro en las que el valor de un campo LogEntry
cumpla determinados criterios. Por ejemplo, puedes mostrar solo las entradas de registro cuyo campo severity
tenga el valor ERROR
.
Tipos de entradas de registro
Los registros de auditoría y Transparencia de acceso proporcionan la información necesaria para cumplir las normativas. Los registros de auditoría proporcionan información sobre las actividades administrativas y los accesos a tus Google Cloud recursos. En los registros de Transparencia de acceso se registran las acciones que lleva a cabo el Google Cloud personal cuando accede a tu Google Cloud contenido. Para ver una lista de los servicios admitidos, consulta los Google Cloud servicios con registros de auditoría y los Google Cloud servicios con registros de Transparencia de acceso.
Los siguientes tipos de entradas de registro se almacenan en el _Required
segmento de registros del Google Cloud proyecto, la cuenta de facturación, la carpeta o la organización en los que se originan:
- Registros de auditoría de la actividad del administrador
- Registros de auditoría de los eventos del sistema
- Registros de auditoría de administrador de Google Workspace
- Registros de auditoría de grupos de G Suite Enterprise
- Registros de auditoría de inicio de sesión
- Registros de Transparencia de acceso
Todas las demás entradas de registro que proceden de un Google Cloud proyecto, una cuenta de facturación, una carpeta o una organización se almacenan en el _Default
segmento de registros. Sin embargo, puede cambiar las entradas de registro que se almacenan en este contenedor de registro.
Siguientes pasos
- Almacenar datos de registro.
- Registrar datos de ruta.
- Información general sobre consultas y visualización de registros