Descripción general de los receptores agregados

Los receptores agregados te permiten recopilar y enrutar entradas de registro de todos los recursos dentro de una carpeta o una organización a un destino compatible. Puedes usar receptores agregados para almacenar tus datos de registro en una ubicación central y controlar si los recursos secundarios almacenan copias duplicadas.

Acerca de los receptores agregados

Un receptor agregado es un receptor a nivel de carpeta o de organización sink que enruta las entradas de registro desde el recurso en el que se define el receptor y todos sus recursos secundarios. Al igual que un receptor a nivel de proyecto, un receptor agregado tiene un destino y un filtro que determina qué entradas de registro enrutar, pero un receptor a nivel de proyecto enruta las entradas de registro solo desde un solo proyecto.

Tipos de receptores agregados

Puedes crear dos tipos de receptores agregados: interceptores y no interceptores , según si deseas que los recursos secundarios también enruten las entradas de registro. Cuando existen receptores agregados en la jerarquía de recursos de una entrada de registro, el enrutador de registros envía la entrada de registro a esos receptores primero, y el tipo de receptor determina lo que sucede a continuación:

Receptor agregado interceptor

Un receptor agregado interceptor evita que las entradas de registro se enruten a los receptores de los recursos secundarios, excepto a los receptores _Required de los recursos en los que se originan las entradas de registro. Un receptor agregado interceptor puede ser útil para evitar que se almacenen copias duplicadas de entradas de registro en varios lugares.

Por ejemplo, supongamos que necesitas habilitar los registros de auditoría de acceso a los datos con fines de auditoría. Para simplificar tu análisis, deseas almacenar 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 interceptor.

Receptor agregado no interceptor

Un receptor agregado no interceptor no afecta la forma en que se enrutan las entradas de registro a otros receptores. Es decir, incluso cuando una entrada de registro coincide con el filtro de un receptor agregado no interceptor, esa entrada de registro se reenvía a otros receptores en la jerarquía de recursos de la entrada de registro. Un receptor agregado no interceptor 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 no interceptor que enrute todas las entradas de registro generadas desde 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 es interceptor, el enrutador de registros también envía entradas de registro a los receptores de registros en el 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, la entrada de registro se envía a los receptores de registros en el proyecto en el que se origina la entrada de registro. Un receptor a nivel de 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 no interceptor

Supongamos que existe un receptor agregado no interceptor 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 no interceptor, sucede lo siguiente:

  1. El receptor agregado no interceptor 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.

  2. El enrutador de registros envía la entrada de registro a los receptores de registros en el proyecto en el que se originó la entrada de registro.

    Un receptor a nivel de 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 interceptor

Supongamos que existe un receptor agregado interceptor 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 interceptor, sucede una de las siguientes acciones:

  • La entrada de registro coincide con el filtro de inclusión, pero no coincide con ningún filtro de exclusión:

    1. La entrada de registro se enruta al destino del receptor agregado interceptor.
    2. La entrada de registro se envía al receptor _Required en 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:

    1. El receptor agregado interceptor no enruta la entrada de registro.

    2. El enrutador de registros envía la entrada de registro a los receptores de registros en el proyecto en el que se originó la entrada de registro.

      Un receptor a nivel de 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.

Receptores interceptores

El destino de un receptor agregado interceptor debe ser un Cloud de Confiance proyecto de.

Los receptores de registros en el proyecto de destino vuelven a enrutar las entradas de registro a sus destinos. Se admiten todos los destinos, excepto los proyectos. Por ejemplo, los receptores de registros en el proyecto de destino pueden volver a enrutar las entradas de registro a un bucket de registros.

Receptores no interceptores

En esta sección, se describen los destinos admitidos para los receptores agregados no interceptores.

El destino de un receptor puede estar en un recurso diferente 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 un proyecto diferente.

Se admiten los siguientes destinos:

Cloud de Confiance proyecto

Selecciona este destino cuando desees que los receptores de registros en el proyecto de destino vuelvan a enrutar tus entradas de registro o cuando hayas creado un receptor agregado interceptor. Los receptores de registros en el proyecto de destino pueden volver a enrutar las entradas de registro a cualquier destino admitido, excepto a un proyecto.

Los receptores de registros creados por el sistema en el proyecto de destino excluyen las entradas de registro que se enrutan al bucket de registros _Required en el proyecto de origen. Por ejemplo, si enrutas registros de actividad de administrador a otro proyecto, los receptores de registros _Required y _Default en el proyecto de destino excluyen esas entradas de registro. Para almacenar esas entradas de registro, en el proyecto de destino actualiza el _Default receptor de registros o crea un receptor de registros personalizado.

Bucket de registros
Selecciona este destino cuando desees 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 Cloud de Confiance by S3NS y, luego, usar una integración de terceros. Las entradas de registro se formatean como JSON y, luego, se enrutan a un tema de Pub/Sub.

Prácticas recomendadas

Recomendamos que el destino de un receptor agregado sea un Cloud de Confiance proyecto. Con este destino, los receptores de registros en el proyecto de destino Cloud de Confiance vuelven a enrutar 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 entradas de registro que coincidan con el filtro del receptor _Required, debes crear un receptor de registros personalizado o modificar el filtro del receptor de registros _Default.

Cuando creas un receptor interceptor, 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 interceptor no enrute esas entradas de registro.

  • Agrega información de contacto a la descripción de un receptor interceptor. Esto puede ser útil si quienes administran el receptor interceptor son diferentes de quienes administran los proyectos cuyas entradas de registro se interceptan.

  • Prueba la configuración del receptor. Para ello, primero crea un receptor agregado no interceptor para verificar que se enruten las entradas de registro correctas.

¿Qué sigue?