Visão geral dos coletores agregados

Os coletores agregados permitem agrupar e rotear entradas de registro de todos os recursos em uma pasta ou organização para um destino compatível. É possível usar coletores agregados para armazenar os dados de registro em um local central e controlar se os recursos filhos armazenam cópias duplicadas.

Sobre coletores agregados

Um coletor agregado é um coletor no nível da pasta ou da organização que encaminha entradas de registro do recurso em que o coletor está definido e de todos os recursos filhos dele. Assim como um coletor no nível do projeto, um coletor agregado tem um destino e um filtro que determina quais entradas de registro serão roteadas, mas um coletor no nível do projeto roteia entradas de registro apenas de um único projeto.

Tipos de coletores agregados

É possível criar dois tipos de coletores agregados: interceptadores e não interceptadores, dependendo se você quer que os recursos filhos também encaminhem as entradas de registro. Quando há coletores agregados na hierarquia de recursos de uma entrada de registro, o roteador de registros envia a entrada para esses coletores primeiro, e o tipo de coletor determina o que acontece em seguida:

Coletor agregado de interceptação

Um coletor agregado de interceptação impede que as entradas de registro sejam roteadas para coletores em recursos filhos, exceto para os coletores _Required nos recursos em que as entradas de registro se originam. Um coletor agregado de interceptação pode ser útil para evitar que cópias duplicadas de entradas de registro sejam armazenadas em vários lugares.

Por exemplo, suponha que você precise ativar os registros de auditoria de acesso a dados para fins de auditoria. Para simplificar sua análise, você quer armazenar esses registros em um local central. No entanto, por motivos de segurança e custo, você também quer impedir que esses registros sejam armazenados no nível do projeto. Nesse cenário, é possível criar um coletor agregado de interceptação.

Coletor agregado sem interceptação

Um coletor agregado sem interceptação não afeta como as entradas de registro são roteadas para outros coletores. Ou seja, mesmo quando uma entrada de registro corresponde ao filtro de um coletor agregado não interceptador, ela é encaminhada para outros coletores na hierarquia de recursos da entrada de registro. Um coletor agregado sem interceptação permite manter a visibilidade das entradas de registro nos recursos em que foram geradas.

Por exemplo, é possível criar um coletor agregado não interceptador que encaminhe todas as entradas de registro geradas pelas pastas de uma organização para um bucket de registros central. As entradas de registro são armazenadas no bucket de registros central. No entanto, como o coletor não é de interceptação, o roteador de registros também envia entradas de registro para os coletores de registros no recurso em que foram geradas.

Exemplos de roteamento

Nesta seção, mostramos como uma entrada de registro que se origina em um projeto pode fluir pelos coletores na hierarquia de recursos.

Exemplo: não há coletores agregados

Quando não há coletores agregados na hierarquia de recursos da entrada de registro, ela é enviada para os coletores de registros no projeto em que a entrada de registro é originada. Um coletor no nível do projeto encaminha a entrada de registro para o destino do coletor quando ela corresponde ao filtro de inclusão do coletor, mas não corresponde a nenhum dos filtros de exclusão do coletor.

Exemplo: existe um coletor agregado sem interceptação

Suponha que exista um coletor agregado não interceptador na hierarquia de recursos para uma entrada de registro. Depois que o roteador de registros envia a entrada de registro para o coletor agregado sem interceptação, ocorre o seguinte:

  1. O coletor agregado sem interceptação encaminha a entrada de registro para o destino do coletor quando ela corresponde ao filtro de inclusão, mas não corresponde a nenhum filtro de exclusão.

  2. O roteador de registros envia a entrada de registro para os coletores de registros no projeto em que a entrada de registro foi originada.

    Um coletor no nível do projeto encaminha a entrada de registro para o destino do coletor quando ela corresponde ao filtro de inclusão do coletor, mas não corresponde a nenhum dos filtros de exclusão do coletor.

Exemplo: há um coletor agregado de interceptação

Suponha que exista um coletor agregado de interceptação na hierarquia de recursos para uma entrada de registro. Depois que o roteador de registros envia a entrada de registro para o coletor agregado de interceptação, ocorre uma das seguintes situações:

  • A entrada de registro corresponde ao filtro de inclusão, mas não corresponde a nenhum filtro de exclusão:

    1. A entrada de registro é roteada para o destino do coletor agregado de interceptação.
    2. A entrada de registro é enviada para o coletor _Required no projeto em que a entrada de registro foi originada.

  • A entrada de registro não corresponde ao filtro de inclusão ou corresponde a pelo menos um filtro de exclusão:

    1. A entrada de registro não é roteada pelo coletor agregado de interceptação.

    2. O roteador de registros envia a entrada de registro para os coletores de registros no projeto em que a entrada de registro foi originada.

      Um coletor no nível do projeto encaminha a entrada de registro para o destino do coletor quando ela corresponde ao filtro de inclusão do coletor, mas não corresponde a nenhum dos filtros de exclusão do coletor.

Destinos compatíveis com coletores agregados

Nesta seção, listamos os destinos compatíveis com os coletores agregados.

Coletores de interceptação

O destino de um coletor agregado de interceptação precisa ser um projeto doGoogle Cloud .

Os coletores de registros no projeto de destino redirecionam as entradas de registro para os destinos delas. Todos os destinos, exceto projetos, são compatíveis. Por exemplo, os coletores de registros no projeto de destino podem redirecionar as entradas de registro para um bucket de registros.

Coletores sem interceptação

Nesta seção, descrevemos os destinos compatíveis com coletores agregados não interceptadores.

O destino de um coletor pode estar em um recurso diferente do coletor. Por exemplo, é possível usar um coletor de registros para rotear entradas de registro de um projeto para um bucket de registros armazenado em um projeto diferente.

Os seguintes destinos são compatíveis:

Projeto doGoogle Cloud

Selecione esse destino quando quiser que os coletores de registros no projeto de destino redirecionem as entradas de registro ou quando tiver criado um coletor agregado de interceptação. Os coletores de registros no projeto de destino podem redirecionar as entradas de registro para qualquer destino compatível, exceto um projeto.

Os coletores de registros criados pelo sistema no projeto de destino excluem as entradas de registro roteadas para o bucket de registros _Required no projeto de origem. Por exemplo, se você rotear registros de atividade do administrador para outro projeto, os coletores de registros _Required e _Default no projeto de destino vão excluir essas entradas de registro. Para armazenar essas entradas de registro, no projeto de destino, atualize o coletor de registros _Default ou crie um coletor de registros personalizado.

Bucket de registros
Selecione esse destino quando quiser armazenar os dados de registro em recursos gerenciados pelo Cloud Logging. Os dados de registro armazenados em buckets de registro podem ser visualizados e analisados usando serviços como a Análise de Registros.
Tópico do Pub/Sub
Selecione esse destino quando quiser exportar os dados de registro do Google Cloud e usar uma integração de terceiros. As entradas de registro são formatadas como JSON e roteadas para um tópico do Pub/Sub.

Práticas recomendadas

Recomendamos que o destino de um coletor agregado seja um projeto doGoogle Cloud . Com esse destino, os coletores de registros no projeto de destinoGoogle Cloud redirecionam as entradas de registro. O coletor _Required roteia apenas as entradas de registro que correspondem ao filtro e que são originadas no recurso em que o coletor está definido. Portanto, se você quiser armazenar cópias adicionais de entradas de registro que correspondam ao filtro do coletor _Required, crie um coletor de registros personalizado ou modifique o filtro do coletor de registros _Default.

Ao criar um coletor de interceptação, recomendamos que você faça o seguinte:

  • Considere se os recursos filhos precisam de controle independente do roteamento das entradas de registro. Se um recurso filho precisar de controle independente de determinadas entradas de registro, verifique se o coletor de interceptação não encaminha essas entradas de registro.

  • Adicione dados de contato à descrição de um coletor de interceptação. Isso pode ser útil se as pessoas que gerenciam o coletor de interceptação forem diferentes daquelas que gerenciam os projetos com entradas de registro interceptadas.

  • Teste a configuração do coletor criando primeiro um coletor agregado não interceptador para verificar se as entradas de registro corretas estão sendo roteadas.

A seguir