En este documento, se describen los receptores agregados, que te permiten recopilar y enrutar entradas de registro que se originan en recursos dentro de una carpeta o una organización a un destino compatible. Te recomendamos que uses receptores agregados para enrutar tus datos de registros a una ubicación de almacenamiento central.
Acerca de los receptores agregados
Un receptor agregado es similar a un receptor a nivel del proyecto, ya que contiene filtros y un destino. Sin embargo, el Enrutador de registros envía al receptor agregado las siguientes entradas de registro:
- Son todas las entradas de registro que se originan en una carpeta o una organización.
- Todas las entradas de registro que se originan en los recursos secundarios de la carpeta o la organización.
Por ejemplo, si creas un receptor agregado a nivel de la carpeta, el enrutador de registros enviará a ese receptor todas las entradas de registro que se originen en la carpeta o en los recursos secundarios de la carpeta.
Cuando existen receptores agregados en la jerarquía de recursos de una entrada de registro, el enrutador de registros inicialmente envía la entrada de registro a esos receptores. Debido a que los receptores agregados pueden ser interceptores o no interceptores, es posible que el enrutador de registros no envíe una entrada de registro que se enrute a través de un receptor agregado a los receptores a nivel del proyecto.
- Interceptación del receptor agregado
Un receptor agregado interceptor evita que las entradas de registro se enruten a los receptores de los recursos secundarios, excepto a los receptores
_Requiredde los recursos en los que se originan las entradas de registro. Un receptor agregado de interceptación puede ser útil para evitar que se almacenen copias duplicadas de las entradas de registro en varios lugares.Por ejemplo, supongamos que necesitas habilitar los registros de auditoría de acceso a los datos para fines de auditoría. Para simplificar tu análisis, te recomendamos que almacenes estos registros en una ubicación central. Sin embargo, por motivos de seguridad y costos, también deseas evitar que estos registros se almacenen a nivel del proyecto. Para este caso, puedes crear un receptor agregado de interceptación.
- Receptor agregado sin interceptación
Un receptor agregado que no intercepta no afecta la forma en que las entradas de registro se enrutan a otros receptores. Es decir, incluso cuando una entrada de registro coincide con el filtro de un receptor agregado que no intercepta, esa entrada de registro se reenvía a otros receptores en la jerarquía de recursos de la entrada de registro. Un receptor agregado que no intercepta te permite mantener la visibilidad de las entradas de registro en los recursos en los que se generaron.
Por ejemplo, puedes crear un receptor agregado que no intercepte y que enrute todas las entradas de registro generadas a partir de las carpetas que contiene una organización a un bucket de registros central. Las entradas de registro se almacenan en el bucket de registros central. Sin embargo, debido a que el receptor no intercepta, el enrutador de registros también envía entradas de registro a los receptores de registros del recurso en el que se generaron.
Ejemplos de enrutamiento
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.
Destinos admitidos para receptores agregados
En esta sección, se enumeran los destinos admitidos para los receptores agregados.
Interceptación de receptores
El destino de un receptor agregado interceptor debe ser un proyecto deTrusted Cloud .
Los receptores de registros del proyecto de destino redireccionan las entradas de registro a sus destinos. Se admiten todos los destinos, excepto los proyectos. Por ejemplo, los receptores de registros del proyecto de destino pueden redireccionar las entradas de registro a un bucket de registros.
Receptores que no interceptan
El destino de un receptor agregado que no intercepta puede ser cualquiera de los siguientes:
El destino de un receptor puede estar en un recurso diferente al del receptor. Por ejemplo, puedes usar un receptor de registros para enrutar entradas de registro de un proyecto a un bucket de registros almacenado en otro proyecto.
Se admiten los siguientes destinos:
- Trusted Cloud proyecto
Selecciona este destino cuando desees que los receptores de registros del proyecto de destino redireccionen tus entradas de registro o cuando hayas creado un receptor agregado interceptor. Los receptores de registros del proyecto que es el destino del receptor pueden redireccionar las entradas de registro a cualquier destino compatible, excepto a un proyecto.
- Bucket de registros
- Selecciona este destino cuando quieras almacenar tus datos de registro en recursos administrados por Cloud Logging. Los datos de registro almacenados en buckets de registros se pueden ver y analizar con servicios como el Explorador de registros.
- Tema de Pub/Sub
- Selecciona este destino cuando desees exportar tus datos de registro desde Trusted Cloud by S3NS y, luego, usar una integración de terceros. Las entradas de registro se formatean en JSON y, luego, se enrutan a un tema de Pub/Sub.
Prácticas recomendadas
Recomendamos que el destino de un receptor agregado sea un proyecto de Trusted Cloud .
Con este destino, los receptores de registros en el proyecto de destino Trusted Cloud redirigen las entradas de registro.
El receptor _Required solo enruta las entradas de registro que coinciden con su filtro y que se originan en el recurso en el que se define el receptor. Por lo tanto, si deseas almacenar copias adicionales de las entradas de registro que coinciden con el filtro del receptor _Required, debes crear un receptor de registros personalizado o modificar el filtro del receptor de registros _Default.
Cuando crees un receptor de intercepción, te recomendamos que hagas lo siguiente:
Considera si los recursos secundarios necesitan un control independiente del enrutamiento de sus entradas de registro. Si un recurso secundario necesita un control independiente de ciertas entradas de registro, verifica que tu receptor de interceptación no enrute esas entradas de registro.
Agrega información de contacto a la descripción de un receptor de interceptación. Esto puede ser útil si quienes administran el receptor de interceptación son diferentes de quienes administran los proyectos cuyas entradas de registro se interceptan.
Para probar la configuración del receptor, primero crea un receptor agregado que no intercepte para verificar que se enruten las entradas de registro correctas.
¿Qué sigue?
Para obtener información sobre cómo crear un receptor agregado, consulta Recopila y enruta registros a nivel de la organización y de la carpeta a destinos compatibles.
Para ver un instructivo, consulta Agrega y almacena los registros de tu organización.
Para obtener información sobre cómo administrar los receptores existentes, consulta Enruta registros a destinos compatibles: Administra receptores.
Para obtener información sobre cómo ver tus registros en sus destinos, así como sobre cómo se les da formato y se organizan, consulta Visualiza los registros en los destinos de los receptores.