Puedes usar Cloud Logging para enrutar entradas de registro desde Google Cloud servicios, tus aplicaciones y otros proveedores de servicios en la nube a destinos para su almacenamiento, análisis y exportación a terceros.
De forma predeterminada, Cloud Logging enruta todas las entradas de registro a los buckets de registros en el proyecto, la carpeta o la organización en los que se originan. Sin embargo, puedes configurar receptores de registros para enrutar los datos de registro a buckets personalizados, Cloud Storage, BigQuery o Pub/Sub. Servicios como Cloud Storage y Pub/Sub admiten la exportación de tus datos de registro a herramientas de terceros.
A un alto nivel, esta es la forma en que Cloud Logging enruta y almacena las entradas de registro:
La figura anterior se aplica a los buckets de registros que se encuentran en un proyecto. No puedes crear buckets de registros definidos por el usuario en carpetas ni organizaciones. Además, no puedes extender el período de retención de ningún bucket de registros que se encuentre en una carpeta o una organización.
Enrutamiento en comparación con la exportación de entradas de registro
El enrutamiento es el proceso de mover las entradas de registro que recibe un Google Cloud proyecto, una carpeta o una organización a un destino. Un destino es un servicio que procesa las entradas de registro recibidas y realiza una acción. Por ejemplo, puedes enrutar entradas de registro a un bucket de registros. Este destino analiza las entradas de registro en busca de información de errores y, luego, las escribe en el almacenamiento.
La exportación es el proceso de mover entradas de registro de Google Cloud a una ubicación externa. Por ejemplo, puedes enrutar las entradas de registro a Pub/Sub y, luego, exportarlas a herramientas de terceros.
Cloud Logging usa receptores de registros para enrutar las entradas de registro a destinos. De forma predeterminada, tus entradas de registro se enrutan a uno de los dos buckets de registros de tuGoogle Cloud proyecto, carpeta u organización. Puedes crear receptores de registros para enrutar tus datos de registros a otros destinos. También puedes modificar uno de los receptores de registros creados por el sistema. En este documento, se describen estas opciones.
El Explorador de registros te permite descargar las entradas de registro que se almacenan en buckets de registros al almacenamiento local. Sin embargo, la opción de descarga se limita a 10,000 entradas de registro. Para exportar tus entradas de registro desdeGoogle Cloud, considera estas opciones:
Configura un receptor de registros para enrutar las entradas de registro entrantes a Pub/Sub y, luego, exporta esos datos desde Google Cloud.
Copia las entradas de registro de un bucket de registros a Cloud Storage y, luego, exporta los datos de Google Cloud. Para obtener información sobre cómo copiar registros, consulta Cómo agrupar y enrutar registros de forma retroactiva.
Acerca de los enrutadores de registros
Cada Google Cloud proyecto, cuenta de facturación, carpeta y organización tiene un enrutador de registros, que administra el flujo de entradas de registro a través de los receptores a nivel del recurso. Un enrutador de registros también administra el flujo de una entrada de registro a través de los receptores que se encuentran en la jerarquía de recursos de la entrada. Los receptores controlan cómo se enrutan las entradas de registro a los destinos.
El enrutador de registros almacena una entrada de registro de forma temporal. Este comportamiento protege contra las interrupciones temporales y las fallas que pueden ocurrir cuando una entrada de registro fluye a través de los receptores. El almacenamiento temporal no protege contra los errores de configuración.
El almacenamiento temporal de un enrutador de registros es distinto del almacenamiento a mayor plazo que proporcionan los buckets de Logging.
Se descartan las entradas de registro entrantes con marcas de tiempo que son anteriores al período de retención de registros o que son más de 24 horas posteriores.
Acerca de los receptores de registros
Cuando un receptor de registros recibe una entrada de registro, determina si debe ignorarla o enrutarla al destino del receptor. El receptor de registros compara la entrada de registro con sus filtros para tomar esta decisión. El destino de un receptor puede ser un proyecto, una ubicación de almacenamiento o un servicio como Pub/Sub. Por ejemplo, un receptor puede enrutar entradas de registro a un bucket de registros.
Los receptores de registros pertenecen a un Google Cloud recurso Google Cloud determinado:proyectos, cuentas de facturación, carpetas y organizaciones. Estos recursos también contienen varios receptores de registros. Cuando un recurso recibe una entrada de registro, cada receptor de registro de ese recurso la evalúa de forma independiente. Como resultado, varios receptores de registros pueden enrutar la misma entrada de registro.
De forma predeterminada, los datos de registro se almacenan en el proyecto del que provienen. Sin embargo, existen varios motivos por los que tal vez quieras cambiar esta configuración:
- Centralizar el almacenamiento de tus datos de registro
- Unir tus datos de registro con otros datos de la empresa
- Para organizar tus datos de registro de una manera que te resulte útil.
- Para transmitir tus registros a otras aplicaciones, otros repositorios o a terceros Por ejemplo, es posible que desees exportar tus registros de Google Cloud para poder verlos en una plataforma de terceros. Para exportar tus entradas de registro, crea un receptor de registros que las enrute a Pub/Sub.
Un receptor de registros mal configurado no enruta las entradas de registro. Cuando un receptor está mal configurado, se escriben entradas de registro que informan el detalle del error. Además, se envía un correo electrónico a los contactos esenciales del recurso. Para obtener más información, consulta Solución de problemas: Visualiza errores.
Los receptores de registros no pueden enrutar entradas de registro de forma retroactiva. Es decir, un receptor de registros no puede enrutar una entrada de registro que se recibió antes de que se creara el receptor. Del mismo modo, si un receptor está mal configurado, solo enrutará las entradas de registro que lleguen después de que se resuelva el error de configuración. Sin embargo, puedes copiar de forma retroactiva los datos de registro de un bucket de registros a Cloud Storage. Para obtener más información, consulta Copia registros.
Compatibilidad con organizaciones y carpetas
Para ayudarte a administrar los datos de registro en una organización o carpeta, puedes hacer lo siguiente:
Puedes crear receptores agregados, que enrutan las entradas de registro de una organización o carpeta y sus elementos secundarios al destino especificado por el receptor. Existen dos tipos de receptores agregados:
- Receptores agregados sin interceptación
- Intercepta receptores agregados
Los receptores de interceptación pueden anular el comportamiento de enrutamiento para los recursos que se encuentran más abajo en la jerarquía. Los receptores que no interceptan no afectan el enrutamiento de otros recursos. Cuando un receptor de interceptación en un recurso coincide con una entrada de registro, esta no se envía a los receptores de los recursos secundarios, con la excepción de que siempre se envía al receptor de registros de
_Requireden el recurso en el que se originó.Puedes configurar los parámetros de configuración predeterminados de los recursos para Cloud Logging y especificar la configuración del receptor
_Defaultcreado por el sistema para los recursos nuevos de una organización o carpeta. Por ejemplo, puedes usar estos parámetros de configuración para inhabilitar el receptor de_Defaulto especificar los filtros en ese receptor.
Ejemplos de planificación de ruta
En esta sección, se ilustra cómo una entrada de registro que se origina en un proyecto puede fluir a través de los receptores en su jerarquía de recursos.
Ejemplo: No existen receptores agregados
Cuando no existen receptores agregados en la jerarquía de recursos de la entrada de registro, esta se envía a los receptores de registros del proyecto en el que se originó. Un receptor a nivel del proyecto enruta la entrada de registro al destino del receptor cuando la entrada de registro coincide con el filtro de inclusión del receptor, pero no coincide con ninguno de los filtros de exclusión del receptor.
Ejemplo: Existe un receptor agregado que no intercepta
Supón que existe un receptor agregado que no intercepta en la jerarquía de recursos para una entrada de registro. Después de que el enrutador de registros envía la entrada de registro al receptor agregado que no intercepta, sucede lo siguiente:
El receptor agregado que no intercepta enruta la entrada de registro al destino del receptor cuando la entrada de registro coincide con el filtro de inclusión, pero no coincide con ningún filtro de exclusión.
El Enrutador de registros envía la entrada de registro a los receptores de registros del proyecto en el que se originó la entrada de registro.
Un receptor a nivel del proyecto enruta la entrada de registro al destino del receptor cuando la entrada de registro coincide con el filtro de inclusión del receptor, pero no coincide con ninguno de los filtros de exclusión del receptor.
Ejemplo: Existe un receptor agregado de interceptación
Supón que existe un receptor agregado de interceptación en la jerarquía de recursos para una entrada de registro. Después de que el enrutador de registros envía la entrada de registro al receptor agregado de interceptación, sucede una de las siguientes situaciones:
La entrada de registro coincide con el filtro de inclusión, pero no con ningún filtro de exclusión:
- La entrada de registro se enruta al destino del receptor agregado interceptor.
- La entrada de registro se envía al receptor
_Requireden el proyecto en el que se originó la entrada de registro.
La entrada de registro no coincide con el filtro de inclusión o coincide con al menos un filtro de exclusión:
- La entrada de registro no se enruta a través del receptor agregado interceptor.
El Enrutador de registros envía la entrada de registro a los receptores de registros del proyecto en el que se originó la entrada de registro.
Un receptor a nivel del proyecto enruta la entrada de registro al destino del receptor cuando la entrada de registro coincide con el filtro de inclusión del receptor, pero no coincide con ninguno de los filtros de exclusión del receptor.
Filtros de receptores de registros
Cada receptor de registros contiene un filtro de inclusión y puede contener varios filtros de exclusión. Estos filtros determinan si el receptor de registros enruta una entrada de registro al destino del receptor. Si no especificas ningún filtro, todas las entrada de registro se enrutan al destino del receptor.
Un receptor de registros enruta una entrada de registro según estas reglas:
Si la entrada de registro no coincide con el filtro de inclusión, no se enruta. Cuando un receptor no especifica un filtro de inclusión, todas las entrada de registro coinciden con ese filtro.
Si la entrada de registro coincide con el filtro de inclusión y al menos un filtro de exclusión, no se enruta.
Si la entrada de registro coincide con el filtro de inclusión y no coincide con ningún filtro de exclusión, se enruta al destino del receptor.
Los filtros de un receptor de registros se especifican con el lenguaje de consulta de Logging.
No puedes usar filtros de exclusión para reducir el consumo de tu cuota de la API de entries.write ni la cantidad de llamadas a la API de entries.write. Los filtros de exclusión se aplican después de que la API de Logging recibe las entradas de registro.
Receptores de registros creados por el sistema
Para cada proyecto, cuenta de facturación, carpeta y organización de Google Cloud , Cloud Logging crea dos receptores de registros, uno llamado _Required y el otro llamado _Default. Los filtros de inclusión y exclusión de estos receptores garantizan que cada entrada de registro que se origina en el recurso se enrute a través de uno de estos receptores. Ambos receptores enrutan los datos de registro a un bucket de registros que se encuentra en el mismo recurso que el receptor de registros.
En el resto de esta sección, se proporciona información sobre los filtros y los destinos de los registros creados por el sistema.