Exclusões de registros

Esta página descreve como excluir registros do processamento usando o Console do Cloud e a API dos Registros.

O Cloud Logging permite que você exclua registros dos buckets de registros adicionando um filtro de exclusão nos coletores de registros que direcionam os registros para os buckets. Usando a linguagem de consulta do Logging, você grava um filtro que define quais registros excluir do bucket de registros.

A página Armazenamento de registros rastreia o volume de registros no seu projeto. O Roteador de registros oferece ferramentas para desativar o processamento de todos os registros ou excluir (descartar) entradas de registro em que você não tem interesse. Assim, é possível minimizar as cobranças dos registros na sua cota mensal. Para mais informações sobre como as entradas de registro excluídas são tratadas, acesse Como funcionam as exclusões nesta página.

Para detalhes sobre os custos do Cloud Logging, consulte Preços. Se você enviar e excluir seus registros de fluxo da nuvem privada virtual do Cloud Logging, serão aplicadas as cobranças de geração de registros de fluxo da VPC.

Monitorar o uso de registros

Para rastrear o volume de registros de seu projeto, acesse a página Armazenamento de registros no console do Cloud Logging:

Acessar o armazenamento de registros

A parte superior da página exibe um resumo das estatísticas dos registros que seu projeto está recebendo:

As seguintes estatísticas são informadas:

• Volume de registros processados deste mês: a quantidade de registros que seu projeto recebeu desde a primeira data do mês atual.

• Volume da ingestão de registros no último mês: a quantidade de registros que o projeto recebeu no último mês.

• Projeção do volume de ingestão de registros : a quantidade estimada de registros que o projeto receberá até o final do mês atual, com base no uso atual.

Os volumes de registro não incluem determinados registros de auditoria: todos os registros de auditoria de atividades do administrador e todos os registros de auditoria de eventos do sistema. Esses registros são gratuitos e não podem ser excluídos ou desativados.

Como funcionam as exclusões

O diagrama a seguir ilustra como as entradas de registro excluídas são tratadas no Cloud Logging:

As condições a seguir se aplicam a entradas de registros excluídas no Logging:

• As entradas de registro excluídas não são contabilizadas na cota do Logging fornecida aos projetos. Consulte Preços do Logging para mais detalhes.

• As entradas de registro excluídas não ficam visíveis no Logs Explorer e não estão disponíveis para o Error Reporting nem para o Cloud Debugger.

• É possível exportar as entradas de registro para fora do Cloud Logging usando coletores de registro que incluem destinos de coletor. Esses mesmos registros também podem ser excluídos da ingestão. Para mais informações, leia Exportações de registros.

• Registros de auditoria que não podem ser desativados também não podem ser excluídos. No entanto, esses tipos de registros de auditoria são gratuitos.

Cuidado:é possível iniciar e depois parar as exclusões. Mas depois que uma entrada de registro for excluída, ela não poderá mais ser recuperada.

Ao criar filtros de exclusão, é possível controlar quais entradas de registro serão excluídas (descartadas). Por exemplo, é possível excluir as entradas de registro de uma única instância de VM em vez de todas as instâncias de VM.

Limites de exclusão

Você pode ter até 50 filtros de exclusão em um projeto.

Programação de exclusão

Os registros são excluídos após serem recebidos pela API Logging. Portanto, a exclusão de registros não reduz o número de entries.write chamadas de API.

Como criar filtros de exclusão

É possível criar um filtro de exclusão para um novo coletor de registros ou para um coletor existente.

Como criar filtros de exclusão para um novo coletor

Para criar um filtro de exclusão para um novo coletor de registros usando o roteador de registros, faça o seguinte:

1. Siga os procedimentos de Criar coletor.

2. Na etapa Escolher registros para filtrar do coletor (opcional), é possível criar o filtro de exclusão para excluir os registros.

3. Clique em Adicionar exclusão.

4. Digite um nome no campo Nome do filtro de exclusão.

5. Insira a Taxa de filtro de exclusão.

   Forneça um número inteiro entre 0 e 100. Os registros de entrada que correspondem ao filtro de exclusão são amostrados de acordo com esse valor.

   Um valor de 0% de amostras 0 dos registros correspondentes ao filtro, portanto, 0 é equivalente à desativação do filtro de exclusão. Um valor de 100% de amostras 100 de todos os registros. Portanto, todos os registros correspondentes ao filtro de exclusão são excluídos do destino. Um valor de 50 de amostras 50% dos registros que correspondem ao filtro de exclusão. Portanto, 50% dos registros que correspondem à exclusão são excluídos, enquantos o outros 50% são roteados para o destino.

   É possível criar até 50 filtros de exclusão por coletor.

6. Na seção Criar um filtro de exclusão, insira uma expressão de filtro que corresponda às entradas de registro que você quer excluir. Para uma visão geral da linguagem de consulta do Logging, consulte Linguagem de consulta do Logging.

7. Clique em Adicionar exclusão para adicionar outros filtros conforme necessário.

8. Quando terminar, clique em Criar coletor.

Ponto principal: se quiser que sua exclusão seja desativada inicialmente quando o coletor for criado, selecione Desativar na seção Criar um filtro de exclusão.

Como criar filtros de exclusão para um coletor existente

Para criar um filtro de exclusão para um coletor de registros existente usando o roteador de registros, faça o seguinte:

1. No menu do Logging, selecione Roteador de registros.

   Acessar o roteador de registros

2. No coletor que você quer adicionar o filtro de exclusão, clique em Mais .

3. Clique em Editar coletor.

4. Na seção Escolher registros para filtrar do coletor (opcional), crie o filtro de exclusão para excluir os registros.

5. Clique em +Adicionar exclusão.

6. Digite um nome no campo Nome do filtro de exclusão.

7. Insira a Taxa de filtro de exclusão.

   Forneça um número inteiro entre 0 e 100. Os registros de entrada que correspondem ao filtro de exclusão são amostrados de acordo com esse valor.

   Um valor de 0% de amostras 0 dos registros correspondentes ao filtro, portanto, 0 é equivalente à desativação do filtro de exclusão. Um valor de 100% de amostras 100 de todos os registros. Portanto, todos os registros correspondentes ao filtro de exclusão são excluídos do destino. Um valor de 50 de amostras 50% dos registros que correspondem ao filtro de exclusão. Portanto, 50% dos registros que correspondem à exclusão são excluídos, enquantos o outros 50% são roteados para o destino.

   É possível criar até 50 filtros de exclusão por coletor.

8. Na seção Criar um filtro de exclusão, insira uma expressão de filtro que corresponda às entradas de registro que você quer excluir. Para uma visão geral da linguagem de consulta do Logging, consulte Linguagem de consulta do Logging.

9. Clique em Adicionar exclusão para adicionar outros filtros conforme necessário.

10. Quando terminar, clique em Atualizar coletor.

Ponto principal: se quiser que sua exclusão seja desativada inicialmente quando o coletor for criado, selecione Desativar na seção Criar um filtro de exclusão.

Filtros para casos de uso comuns

Ao criar um filtro, é possível encontrar uma das seguintes situações:

• Se você editou o filtro para o coletor _Default, talvez queira restaurar o filtro padrão. Para fazer isso, insira o seguinte no campo Criar filtro de inclusão:

  NOT LOG_ID("cloudaudit.googleapis.com/activity") AND NOT \
  LOG_ID("externalaudit.googleapis.com/activity") AND NOT \
  LOG_ID("cloudaudit.googleapis.com/system_event") AND NOT \
  LOG_ID("externalaudit.googleapis.com/system_event") AND NOT \
  LOG_ID("cloudaudit.googleapis.com/access_transparency") AND NOT \
  LOG_ID("externalaudit.googleapis.com/access_transparency")
  

• Talvez você queira encaminhar todos os registros para um destino sem excluí-los. Para fazer isso, deixe o campo Criar filtro de inclusão em branco.

• Talvez você queira excluir todos os registros para chegar a um destino. Para fazer isso, desative o coletor nesse destino.

Como visualizar filtros de exclusão

Para visualizar os filtros de exclusão atuais, faça o seguinte:

1. No menu do Logging, selecione Roteador de registros.

   Acessar o roteador de registros

2. Para o coletor que você quer visualizar os filtros de exclusão, clique em Mais .

3. Selecione Ver detalhes do coletor.

4. Um painel exibe os detalhes do coletor, incluindo os filtros de exclusão.

   

   Neste exemplo, os detalhes do _Default bucket são mostrados e o registro foi desativado, o que é indicado pelo filtro google-ui-logs-ingestion-off.

Como editar exclusões

Edite os filtros de exclusão existentes para excluir mais ou menos entradas de registro.

1. No menu do Logging, selecione Roteador de registros.

   Acessar o roteador de registros

2. No coletor que você quer visualizar, clique em Mais .

3. Clique em Editar coletor.

4. Na seção Criar um filtro de exclusão, edite a expressão de filtro para corresponder às entradas de registro que você quer excluir.

5. Clique em Adicionar exclusão para adicionar outros filtros conforme necessário.

6. Quando terminar, clique em Atualizar coletor.

Como remover exclusões

Para editar, desativar ou excluir um filtro de exclusão, siga o guia Como editar exclusões para excluir a exclusão de um coletor específico.

Ponto principal: verifique todos os seus filtros de exclusão, porque as mesmas entradas de registro podem ser segmentadas por mais de um filtro.

Exclusões na API

Para criar filtros de exclusão na API Logging, use o método projects.exclusions.create.

Também há métodos para visualizar, excluir e atualizar filtros de exclusão.

Há ainda métodos de exclusão na API para registros recebidos por organizações, contas de faturamento e pastas. Essas exclusões só podem ser criadas na API Logging. Elas não são compatíveis com o console do Cloud Logging.

Para exemplos de consultas de registros que podem ser úteis em exclusões, acesse Amostra de consultas.

Amostras de exclusões na API

Para excluir menos de 100% das entradas de registro correspondentes, use a função sample em sua consulta de registros.

Como exportar registros excluídos

É possível exportar entradas de registro para o Cloud Storage, BigQuery ou Pub/Sub antes de excluí-las, para que você não perca permanentemente as entradas de registro excluídas.

Para iniciar a exclusão e a exportação, faça o seguinte:

1. Crie uma consulta que corresponda às entradas de registro que você quer excluir e exportar.

   Dica: grave a consulta para que ela não corresponda aos registros de auditoria ativados por padrão. A correspondência dessas entradas de registro de auditoria não afeta exclusões, mas resulta na exportação de mais entradas de registro.

2. Crie um coletor de exportação usando sua consulta de registros e comece a exportar as entradas de registro correspondentes.

3. Crie um filtro de exclusão usando sua consulta de registros e comece a excluir as entradas de registro correspondentes.

Para interromper as exclusões e exportações, desative o filtro de exclusão antes de parar o coletor de exportação.

Para mais detalhes sobre como exportar registros, consulte Como exportar registros.

Preços de exportação

Os registros exportados não estão sujeitos às cobranças do Cloud Logging, mas é possível que haja cobranças de destino. Para detalhes, consulte a página de preços do produto apropriado:

• Preços do Cloud Storage
• Preços do BigQuery
• Preços do Pub/Sub
• Preços do Cloud Logging

Observe também que, se você enviar e excluir os registros de fluxo da nuvem privada virtual do Cloud Logging, cobranças de geração de registros de fluxo da VPC serão aplicadas além das taxas de destino.