Conceptos básicos

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Cloud Logging es parte del conjunto de productos de Google Cloud's operations suite. Incluye almacenamiento para registros, una interfaz de usuario llamada el Explorador de registros y una API para administrar registros de manera programática. Logging te permite leer y escribir entradas de registro, consultar tus registros y controlar cómo enrutar, almacenar y usar los registros.

Proyectos de Cloud y otros recursos

Los registros se asocian, en primer lugar, con proyectos de Google Cloud, aunque otros recursos de Google Cloud, como las organizaciones, las carpetas y las cuentas de facturación, también pueden tener registros.

Entradas de registro

Una entrada de registro registra el estado o describe eventos o transacciones específicos que ocurren en los sistemas informáticos. Las entradas de registro se escriben mediante tu propio código, los servicios de Google Cloud en los que se ejecuta el código, aplicaciones de terceros y la infraestructura de la que depende Google Cloud.

Algunas entradas de registro describen eventos específicos que ocurren dentro del sistema. Puedes usar estas entradas de registro para enviar mensajes que garanticen a los usuarios que las cosas funcionan bien o que proporcionen información cuando algo falle.

Otras entradas de registro pueden describir los detalles de las transacciones que procesa un sistema o componente. Por ejemplo, un balanceador de cargas registra todas las solicitudes que recibe. Un balanceador de cargas también registra información como la URL solicitada y el código de respuesta HTTP, y puede registrar qué backend entregó la solicitud.

Debido a que los registros en los sistemas modernos descienden de los archivos de texto escritos al disco, una entrada de registro es análoga a una línea en un archivo de registro y se puede considerar la unidad básica de registro.

Tu proyecto de Cloud recibe entradas de registro cuando comienzas a usar los servicios que producen entradas de registro, como Compute Engine o BigQuery. También obtienes entradas de registro cuando conectas Cloud Monitoring a AWS, cuando instalas el agente de Logging en tus instancias de máquina virtual (VM) y cuando llamas al método entries.write en la API de Logging.

Una entrada de registro consta lo siguiente de forma mínima:

  • Una marca de tiempo que indica cuándo ocurrió el evento o cuándo Cloud Logging lo recibió.
  • El recurso supervisado que produjo la entrada de registro.
  • Una carga útil, también conocida como mensaje, proporcionada como datos textuales no estructurados o como datos textuales estructurados en formato JSON
  • El nombre del registro al que pertenece.

Las entradas de registro también pueden llevar metadatos asociados. Estos metadatos pueden incluir la gravedad de cada entrada de registro asociada.

Para obtener más información sobre los formatos de datos de entradas de registros, consulta el tipo LogEntry.

Logs

Un registro es una colección con nombre de entradas de registro dentro de un recurso de Google Cloud, como un proyecto de Cloud. Los registros existen solo si contienen entradas de registro.

El nombre de un registro se identifica por la ruta completa del recurso al que pertenecen las entradas de registro, seguida de un ID de registro simple, como syslog, o un ID estructurado que incluye el escritor del registro, como compute.googleapis.com/activity.

Cada entrada de registro posee el nombre de su registro.

Tipos de registros

Para obtener más información sobre los tipos de registros disponibles en Cloud Logging, consulta Registros disponibles.

Período de retención

Las entradas de registro se conservan en Cloud Logging durante un tiempo limitado conocido como período de retención. Una vez pasado ese período, se borran. Los períodos de retención para diferentes tipos de registros se enumeran en la sección Cuotas y límites de Logging.

Puedes configurar los períodos de retención de algunos de tus registros. Para obtener más detalles, consulta Retención personalizada.

Si también deseas crear una copia de seguridad de tus registros, consulta la sección Receptores en esta página.

Consulta y filtro

Una consulta es una expresión en el lenguaje de consulta de Logging que muestra las entradas de registro que coinciden con la expresión. Las consultas se usan en el Explorador de registros y la API de Logging para seleccionar y ver las entradas de registro, como las de una instancia de VM en particular o las que llegan en un período particular con un nivel de gravedad en particular.

Un filtro es una expresión en el lenguaje de consulta de Logging que se usa en los receptores para enrutar los registros que coinciden con la expresión a un destino de almacenamiento. También puedes usar filtros cuando creas métricas basadas en registros para enrutar los registros que coinciden con esa expresión en Cloud Monitoring.

Recursos supervisados

Cada entrada de registro indica de dónde viene mediante el nombre de un recurso supervisado. En los ejemplos, se incluyen instancias de VM de Compute Engine individuales, contenedores de Google Kubernetes Engine, instancias de bases de datos y otros elementos.

Para obtener una lista completa de los tipos de recursos supervisados, consulta Servicios y recursos supervisados.

Enrutador de registros

Todos los registros, incluidos los registros de auditoría, los registros de la plataforma y los registros escritos por el usuario, se envían a la API de Cloud Logging, en la que pasan por el enrutador de registros. El enrutador de registros compara cada entrada de registro con las reglas existentes para determinar qué entradas de registro transferir (almacenar) a los depósitos de registro, qué entradas de registro enrutar a un destino y qué entradas de registro excluir (descartar). )

Para obtener más detalles, consulta Descripción general del enrutamiento y el almacenamiento.

Receptores

Los receptores controlan cómo Cloud Logging enruta los registros. Mediante el uso de receptores, puedes enrutar algunos o todos los registros a destinos compatibles, o excluir las entradas de registro para que no se almacenen en Logging. Un receptor incluye un destino y un filtro que selecciona las entradas de registro que se enrutarán.

Para obtener más información, consulta Descripción general del enrutamiento y el almacenamiento: receptores.

Métricas basadas en registros

Las métricas son una característica de Cloud Monitoring. Una métrica basada en registros es una métrica cuyo valor es la cantidad de entradas de registro que coinciden con una consulta especificada.

Para obtener más información, consulta Descripción general de las métricas basadas en registros.

Control de acceso

La capacidad de acceder a los registros se controla mediante la concesión de funciones o permisos de la administración de identidades y accesos a las principales.

Los principales con la función Lector de Cloud IAM pueden leer la mayoría de los registros. Para poder leer los Registros de auditoría de acceso a los datos o los Registros de Transparencia de acceso, el principal necesita la función Propietario de IAM o una función personalizada con permisos especiales.

Para obtener más información sobre los permisos obligatorios, consulta Control de acceso.