Modelo de datos de entrada de registro

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 tus 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 el 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:

  • Una marca de tiempo que indica cuándo ocurrió el evento o cuándo lo recibió Cloud Logging
  • Información sobre la fuente de la entrada de registro. Esta fuente se denomina recurso supervisado. Entre los ejemplos de recursos supervisados, se incluyen instancias individuales de Compute Engine y contenedores de Google Kubernetes Engine. Para obtener una lista completa de los tipos de recurso supervisado, 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 consultarlas 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 tienen formato JSON.

  • Es 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. Los siguientes son ejemplos de nombres de registros:

    • projects/my-project/logs/stdout
    • projects/my-project/compute.googleapis.com/activity

Puedes escribir consultas que recuperen solo aquellas entradas de registro en las que el valor de un campo LogEntry coincida con algunos criterios. Por ejemplo, puedes mostrar solo aquellas entradas de registro cuyo campo severity tenga el valor de ERROR.

Tipos de entradas de registro

Los registros de auditoría y la Transparencia de acceso proporcionan la información necesaria para satisfacer las reglamentaciones de cumplimiento. Los registros de auditoría proporcionan información sobre las actividades administrativas y los accesos dentro de tus Google Cloud recursos. Los registros de transparencia de acceso registran las acciones que realiza el personal de Google Cloud cuando accede a tu Google Cloud contenido. Para obtener una lista de los servicios compatibles, consulta los servicios deGoogle Cloud con registros de auditoría y los servicios deGoogle Cloud con registros de Transparencia de acceso.

El siguiente tipo de entradas de registro se almacena en el bucket de registros _Required en el proyecto, la cuenta de facturación, la carpeta o la organización de Google Cloud en la que se originan:

  • Registros de Transparencia de acceso

Todas las demás entradas de registro que se originan en un Google Cloud proyecto, una cuenta de facturación, una carpeta o una organización se almacenan en el bucket de registro _Default. Sin embargo, puedes cambiar las entradas de registro que se almacenan en este bucket de registros.

¿Qué sigue?