Encaminhar registros para destinos compatíveis

É possível usar coletores de registros no Cloud Logging para rotear entradas de registro do seu Cloud de Confiance projeto para destinos compatíveis para armazenamento de longo prazo, análise ou transmissão.

Um coletor realiza uma ação de gravação e, portanto, precisa de autorização para gravar no destino. Quando o destino é um bucket de registros no mesmo projeto que o gravador, ele é autorizado automaticamente. Para todos os outros destinos, o coletor precisa estar anexado a uma conta de serviço que tenha recebido as permissões necessárias para gravar dados no destino.

Quando uma conta de serviço é necessária, o Cloud Logging a cria e gerencia automaticamente. No entanto, talvez seja necessário modificar as permissões concedidas à conta de serviço. Não é necessário usar a conta de serviço criada pelo Logging. É possível criar e gerenciar uma conta de serviço usada por gravadores em vários projetos. Para mais informações, consulte Configurar gravadores de registros com contas de serviço gerenciado pelo usuário.

Visão geral

Este documento descreve como criar um gravador e configurar as opções que podem aparecer ao usar o console Cloud de Confiance , a Google Cloud CLI ou a API.

Os coletores pertencem a um determinado recurso Cloud de Confiance : um projeto Cloud de Confiance , uma conta de faturamento, uma pasta ou uma organização. Quando o recurso recebe uma entrada de registro, todos os coletores nele processam a entrada. Quando uma entrada de registro corresponde aos filtros do coletor, ela é roteada para o destino do coletor.

Normalmente, os coletores encaminham apenas as entradas de registro originadas em um recurso. No entanto, para pastas e organizações, é possível criar coletores agregados. Esses coletores encaminham entradas de registro originadas na pasta ou organização e nos recursos filhos. Este documento não aborda coletores agregados. Para mais informações, consulte Visão geral dos coletores agregados.

Para criar e gerenciar coletores, use o console Cloud de Confiance , a API Cloud Logging e a Google Cloud CLI. Recomendamos que você use o console Cloud de Confiance pelos seguintes motivos:

  • É possível configurar destinos de coletor como parte do fluxo para criar um coletor.
  • É possível visualizar quais entradas de registro correspondem aos filtros do coletor.
  • Algumas etapas de autorização são simplificadas.

Recomendamos que você revise a configuração do coletor de registros ao fazer mudanças no armazenamento de registros. Por exemplo, se você excluir o destino de um coletor de registros, exclua o coletor correspondente.

Para informações sobre como visualizar e gerenciar seus coletores de registros, consulte a seção Gerenciar coletores deste documento.

Destinos possíveis

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

Os seguintes destinos são compatíveis:

Projeto doCloud de Confiance

Selecione esse destino quando quiser que os coletores de registros no projeto de destino redirecionem suas entradas de registro ou quando você 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ê encaminhar registros de atividades 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 registros 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 registros do Cloud de Confiance by S3NS 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.

Limitações de destino

Esta seção descreve limitações específicas do destino:

  • Ao configurar um destino de gravador, forneça o caminho totalmente qualificado e use o endpoint global do serviço. Não há suporte para endpoints de serviço regionais (REPs), como pubsub.LOCATION.rep.googleapis.com.

  • Não é possível rotear registros para um tópico do Pub/Sub que impõe restrições em trânsito. O registro em registros não pode garantir que as solicitações de publicação sejam originadas de uma região permitida, o que causa erros de configuração topic_region_not_allowed e registros descartados.

  • As seguintes limitações se aplicam quando o destino de um coletor de registros é um projeto do Cloud de Confiance :

    • Há um limite de um salto.
    • O coletor de registros _Required no projeto de destino roteia entradas de registro para o bucket de registros _Required do projeto quando as entradas de registro correspondem ao filtro do coletor e são originadas no projeto de destino.
    • O coletor de registros _Default no projeto de destino roteia entradas de registro que correspondem ao filtro de inclusão e não correspondem a nenhum filtro de exclusão. O coletor de registros _Default exclui algumas entradas de registro. Por exemplo, esse coletor não encaminha entradas de registro de atividade do administrador e de eventos do sistema. É possível modificar esse coletor.
    • Somente os coletores agregados que estão na hierarquia de recursos de uma entrada de registro processam a entrada.

    Por exemplo, suponha que o destino de um coletor de registros no projeto A seja o projeto B. Nesse caso, as seguintes regras se aplicam:

    • Devido ao limite de um salto, os coletores de registros no projeto B não podem redirecionar entradas de registro para outro projeto Cloud de Confiance .
    • O bucket de registros _Required do projeto B armazena apenas entradas de registro originadas no projeto B. Esse bucket de registros não armazena entradas de registro originadas em outros recursos, incluindo as que se originam no projeto A.
    • Se os projetos A e B tiverem hierarquias de recursos diferentes, uma entrada de registro que um coletor de registros no projeto A encaminha para o projeto B não será enviada aos coletores agregados na hierarquia de recursos do projeto B.
    • Se os projetos A e B tiverem a mesma hierarquia de recursos, as entradas de registro serão enviadas aos coletores agregados nessa hierarquia. Se uma entrada de registro não for interceptada por um coletor agregado, o roteador de registros vai enviar a entrada para os coletores no projeto A.

Antes de começar

As instruções neste documento descrevem a criação e o gerenciamento de coletores no nível do projetoCloud de Confiance . Você pode usar o mesmo procedimento para criar um coletor que roteia entradas de registro originadas em uma organização, pasta ou conta de faturamento.

Para começar, faça o seguinte:

  1. Ative a API Cloud Logging, se ela ainda não estiver ativada.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão com o papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão com o papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar a API

  2. Verifique se o seu Cloud de Confiance projeto contém entradas de registro que podem ser vistas na Análise de registros.

  3. Para receber as permissões necessárias para criar, modificar ou excluir um gravador, peça ao administrador para conceder a você o papel do IAM de Gravador de configuração de registros (roles/logging.configWriter) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

    Para informações sobre como conceder papéis do IAM, consulte o Guia de controle de acesso do Logging.

  4. Verifique se você tem um recurso em um destino compatível ou pode criar um.

    Para encaminhar entradas de registro a um destino, ele precisa existir antes da criação do coletor. É possível criar o destino em qualquer projetoCloud de Confiance em qualquer organização.

  5. Antes de criar um coletor, revise as limitações que se aplicam ao destino dele. Para mais informações, consulte a seção Limitações de destino neste documento.

  6. Selecione a interface que você planeja usar:

    Console

    Quando você usa o console Cloud de Confiance para acessar os serviços e as APIs Cloud de Confiance by S3NS , não é necessário configurar a autenticação.

    gcloud

    Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando: 

    gcloud init

    REST

    Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Cloud de Confiance .

Criar um coletor

Nesta seção, descrevemos como criar um gravador em um projeto Cloud de Confiance . É possível criar até 200 gravadores por projeto do Cloud de Confiance . Para conferir o número e o volume de entradas de registro encaminhadas, consulte as métricas logging.googleapis.com/exports/.

Use a linguagem de consulta do Logging para criar uma expressão de filtro que corresponda às entradas de registro que você quer incluir. Não coloque informações sensíveis em filtros de gravador. Os coletores de registros são tratados como dados de serviço.

Quando uma consulta contém várias instruções, é possível especificar como elas são unidas ou confiar no Cloud Logging para adicionar implicitamente a restrição conjuntiva, AND, entre as instruções. Por exemplo, suponha que uma consulta ou caixa de diálogo de filtro contenha duas instruções, resource.type = "gce_instance" e severity >= "ERROR". A consulta real é resource.type = "gce_instance" AND severity >= "ERROR". O Cloud Logging oferece suporte a restrições disjuntivas, OR, e conjuntivas, AND. Ao usar instruções OR, recomendamos agrupar as cláusulas com parênteses.

Para criar um coletor, faça o seguinte:

Console

  1. No console do Cloud de Confiance , acesse a página Roteador de registros.

    Acessar o roteador de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  2. Selecione o projeto do Cloud de Confiance em que as entradas de registro que você quer encaminhar foram criadas.

    Por exemplo, se você quiser encaminhar as entradas de registro de acesso a dados do projeto Project-A para um bucket de registros no projeto Project-B, selecione Project-A.

  3. Selecione Criar coletor.

  4. No painel Detalhes do coletor, insira os seguintes detalhes:

    • Nome do coletor: insira um identificador para o coletor. Depois de criar o coletor, não será possível renomeá-lo, mas será possível excluí-lo e criar um novo coletor.

    • Descrição do coletor (opcional): descreva a finalidade ou o caso de uso do coletor.

  5. No painel Destino do coletor, selecione o serviço e o destino do coletor usando o menu Selecionar serviço do coletor. Faça uma das seguintes ações:

    • Para encaminhar entradas de registro a um serviço no mesmo projetoCloud de Confiance , selecione uma das seguintes opções:

      • Tópico do Pub/Sub: selecione ou crie o tópico para receber as entradas de registro roteadas.

    • Para encaminhar entradas de registro para um projeto Cloud de Confiance diferente, selecione Cloud de Confiance projetoe insira o nome totalmente qualificado do destino:

      logging.googleapis.com/projects/DESTINATION_PROJECT_ID

    • Para encaminhar entradas de registro a um serviço em umCloud de Confiance projeto diferente, faça o seguinte:

      1. Selecione Outro recurso.
      2. Insira o nome totalmente qualificado do destino. Para informações sobre a sintaxe, consulte os Formatos de caminho de destino.

  6. Especifique as entradas de registro a serem incluídas:

    1. Acesse o painel Escolher registros para incluir no coletor.

    2. No campo Criar filtro de inclusão, insira uma expressão de filtro que corresponda às entradas de registro que você quer incluir. Para informações sobre a sintaxe, consulte Linguagem de consulta do Logging.

      Se você não definir um filtro, todas as entradas de registro do recurso selecionado serão roteadas para o destino.

      Por exemplo, para encaminhar todas as entradas de registro de acesso a dados para um bucket do Logging, use o seguinte filtro:

      log_id("cloudaudit.googleapis.com/data_access") OR log_id("externalaudit.googleapis.com/data_access")

      O comprimento de um filtro não pode exceder 20.000 caracteres.

    3. Para verificar se você inseriu o filtro correto, selecione Visualizar registros. A Análise de Registros abre em uma nova guia com o filtro pré-preenchido.

  7. (Opcional) Configure um filtro de exclusão para eliminar algumas das entradas de registro incluídas:

    1. Acesse o painel Escolher registros para filtrar do coletor.

    2. No campo Nome do filtro de exclusão, insira um nome.

    3. No campo Criar um filtro de exclusão, insira uma expressão de filtro que corresponda às entradas de registro que você quer excluir. Também é possível usar a função sample para selecionar uma parte das entradas de registro a serem excluídas.

    É possível criar até 50 filtros de exclusão por coletor. O comprimento de um filtro não pode exceder 20.000 caracteres.

  8. Selecione Criar coletor.

  9. Conceda à conta de serviço do coletor permissão para gravar entradas de registro no destino do coletor. Para mais informações, consulte Definir permissões de destino.

gcloud

Para criar um coletor, faça o seguinte:

  1. Execute este comando gcloud logging sinks create:

    gcloud logging sinks create SINK_NAME SINK_DESTINATION

    Antes de executar o comando, faça estas substituições:

    • SINK_NAME: o nome do coletor de registros. Não é possível mudar o nome de um coletor depois de criá-lo.

    • SINK_DESTINATION: o serviço ou projeto para onde você quer que as entradas de registro sejam roteadas. Defina SINK_DESTINATION como o caminho adequado, conforme descrito em Formatos de caminho de destino.

      Por exemplo, se o destino do coletor for um tópico do Pub/Sub, SINK_DESTINATION terá esta aparência:

      pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID

    Você também pode fornecer as seguintes opções:

    • --log-filter : use essa opção para definir um filtro que corresponda às entradas de registro que você quer incluir no coletor. Se você não fornecer um valor para o filtro de inclusão, ele vai corresponder a todas as entradas de registro.
    • --exclusion: use essa opção para definir um filtro de exclusão para entradas de registro que você não quer que o coletor roteie. Também é possível usar a função sample para selecionar uma parte das entradas de registro a serem excluídas. Essa opção pode ser repetida. É possível criar até 50 filtros de exclusão por coletor.
    • --description: use essa opção para descrever a finalidade ou o caso de uso do coletor.

    Por exemplo, para criar um coletor para um bucket do Logging, seu comando pode ter esta aparência:

    gcloud logging sinks create my-sink logging.googleapis.com/projects/myproject123/locations/global/buckets/my-bucket \
 --log-filter='logName="projects/myproject123/logs/matched"' --description="My first sink"

    Para mais informações sobre como criar gravadores usando a Google Cloud CLI, consulte a referência gcloud logging sinks.

  2. Se a resposta do comando contiver uma chave JSON chamada "writerIdentity", conceda à conta de serviço do coletor permissão para gravar no destino do coletor. Para mais informações, consulte Definir permissões de destino.

    Não é necessário definir permissões de destino quando a resposta não contém uma chave JSON chamada "writerIdentity".

REST

  1. Para criar um coletor de geração de registros no seu projeto Cloud de Confiance , use projects.sinks.create na API Logging. No objeto LogSink, forneça os valores necessários apropriados no corpo da solicitação do método:

    • name: um identificador do coletor. Depois de criar o coletor, não será possível renomeá-lo, mas será possível excluí-lo e criar um novo coletor.

    • destination: o serviço e o destino para onde você quer que as entradas de registro sejam roteadas. Para encaminhar entradas de registro a um projeto diferente ou a um destino em outro projeto, defina o campo destination com o caminho apropriado, conforme descrito em Formatos de caminho de destino.

      Por exemplo, se o destino do coletor for um tópico do Pub/Sub, o destination será semelhante a este:

      pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID

  2. No objeto LogSink, forneça as informações opcionais adequadas:

    • filter : defina o campo filter para corresponder às entradas de registro que você quer incluir no coletor. Se você não definir um filtro, todas as entradas de registro do seu projetoCloud de Confiance serão roteadas para o destino. O comprimento de um filtro não pode exceder 20.000 caracteres.
    • exclusions: defina esse campo para corresponder às entradas de registro que você quer excluir do coletor. Também é possível usar a função sample para selecionar uma parte das entradas de registro a serem excluídas. É possível criar até 50 filtros de exclusão por coletor.
    • description: defina este campo para descrever a finalidade ou o caso de uso do coletor.

  3. Chame projects.sinks.create para criar o coletor.

  4. Se a resposta da API contiver uma chave JSON chamada "writerIdentity", conceda à conta de serviço do gravador permissão para gravar no destino do gravador. Para mais informações, consulte Definir permissões de destino.

    Não é necessário definir permissões de destino quando a resposta da API não contém uma chave JSON chamada "writerIdentity".

Para mais informações sobre como criar coletores usando a API Logging, consulte a referência LogSink.

Se você receber notificações de erro, consulte Resolver problemas de roteamento e coletores.

Formatos de caminho de destino

Ao configurar um destino de gravador, forneça o caminho totalmente qualificado e use o endpoint global do serviço. Não há suporte para endpoints de serviço regionais (REPs), como pubsub.LOCATION.rep.googleapis.com.

Nos formatos de caminho a seguir, DESTINATION_PROJECT_ID se refere ao ID ou número do projeto de destino:

  • Bucket de registros do Cloud Logging:

    logging.googleapis.com/projects/DESTINATION_PROJECT_ID/locations/LOCATION/buckets/BUCKET_NAME

  • Outro projeto do Cloud de Confiance :

    logging.googleapis.com/projects/DESTINATION_PROJECT_ID

  • Tópico do Pub/Sub:

    pubsub.googleapis.com/projects/DESTINATION_PROJECT_ID/topics/TOPIC_ID

Definir permissões de destino

Esta seção descreve como conceder ao Logging as permissões do Identity and Access Management para gravar entradas de registro no destino do seu coletor. Para a lista completa de papéis e permissões do Logging, consulte Controle de acesso.

O Cloud Logging cria uma conta de serviço compartilhada para um recurso quando um coletor é criado, a menos que a conta de serviço necessária já exista. A conta de serviço pode existir porque é usada para todos os coletores no recurso subjacente. Um recurso pode ser um projeto Cloud de Confiance , uma organização, uma pasta ou uma conta de faturamento.

A identidade do gravador de um coletor é o identificador da conta de serviço associada a ele. Todos os gravadores têm uma identidade de gravador, exceto aqueles que gravam em um bucket de registros no mesmo projeto Cloud de Confiance em que as entradas de registro se originam. Para a última configuração, uma conta de serviço não é necessária. Portanto, o campo identidade do gravador do coletor é listado como None no console. A API e os comandos da Google Cloud CLI não informam uma identidade de gravador.

As instruções a seguir se aplicam a projetos, pastas, organizações e contas de faturamento:

Console

  1. Verifique se você tem acesso de proprietário ao projetoCloud de Confiance que contém o destino. Se você não tiver acesso de proprietário ao destino do coletor, peça a um proprietário do projeto para adicionar a identidade do gravador como um principal.

  2. Para receber a identidade do gravador do coletor (um endereço de e-mail) do novo coletor, faça o seguinte:

    1. No console do Cloud de Confiance , acesse a página Roteador de registros.

      Acessar o roteador de registros

      Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

    2. Na barra de ferramentas, selecione o projeto que contém o gravador.
    3. Selecione Menu e depois Ver detalhes do coletor. A identidade do gravador é exibida no painel Detalhes do coletor.

  3. Se o valor do campo writerIdentity contiver um endereço de e-mail, prossiga para a próxima etapa. Quando o valor é None, não é necessário configurar permissões de destino para o coletor.

  4. Copie a identidade do gravador do coletor para a área de transferência.

    O endereço de e-mail identifica o principal. O prefixo serviceAccount: especifica o tipo de conta.

  5. Conceda ao principal especificado na permissão de identidade do gravador do coletor para gravar dados de registro no destino:

    1. No console Cloud de Confiance , acesse a página IAM:

      Acesse o IAM

      Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo IAM e administrador.

    2. Na barra de ferramentas, verifique se o projeto selecionado é aquele que armazena o destino ou é o destino do gravador. Por exemplo, se o destino for um bucket de registros, verifique se a barra de ferramentas mostra o projeto que armazena o bucket.

    3. Selecione Conceder acesso.

    4. Conceda ao principal especificado na identidade do gravador do coletor um papel do IAM com base no destino do coletor de registros:

gcloud

  1. Verifique se você tem acesso de proprietário ao projetoCloud de Confiance que contém o destino. Se você não tiver acesso de proprietário ao destino do coletor, peça a um proprietário do projeto para adicionar a identidade do gravador como um principal.

  2. Consiga a conta de serviço do campo writerIdentity no seu coletor:

    gcloud logging sinks describe SINK_NAME

  3. Localize o coletor de dados cujas permissões você quer modificar e, se os detalhes do coletor contiverem uma linha com writerIdentity, siga para a próxima etapa. Quando os detalhes não incluem um campo writerIdentity, não é necessário configurar permissões de destino para o coletor.

    A identidade do gravador para a conta de serviço é semelhante a esta:

    serviceAccount:service-123456789012@gcp-sa-logging.s3ns-system.iam.gserviceaccount.com

  4. Conceda à identidade do gravador do coletor permissão para gravar dados de registro no destino chamando o comando gcloud projects add-iam-policy-binding.

    Antes de usar o comando a seguir, faça as seguintes substituições:

    • PROJECT_ID: o identificador do projeto. Especifique o projeto que armazena o destino do coletor de registros. Quando o destino for um projeto, especifique-o.
    • PRINCIPAL: um identificador do principal a quem você quer conceder o papel. Os identificadores dos principais geralmente têm o seguinte formato: PRINCIPAL-TYPE:ID. Por exemplo, principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com. Para uma lista completa dos formatos que PRINCIPAL pode ter, consulte Identificadores principais.

    • ROLE: um papel do IAM. Conceda à identidade de gravador do coletor um papel do IAM com base no destino do coletor de registros:

    Execute o comando gcloud projects add-iam-policy-binding:

    gcloud projects add-iam-policy-binding PROJECT_ID --member=PRINCIPAL --role=ROLE

REST

Recomendamos que você use o console Cloud de Confiance ou a Google Cloud CLI para conceder um papel à conta de serviço.

Gerenciar coletores

Recomendamos que você revise a configuração do coletor de registros ao fazer mudanças no armazenamento de registros. Por exemplo, se você excluir o destino de um coletor de registros, exclua o coletor correspondente.

Depois que os coletores são criados, é possível executar as seguintes ações neles: As mudanças feitas em um coletor podem levar alguns minutos para serem aplicadas:

  • Ver detalhes
  • Atualizar

  • Desativar

    • Não é possível desativar o coletor _Required.

    • É possível desativar o coletor _Default para impedir que ele roteie entradas de registro para o bucket de registros _Default.

      É possível desativar o coletor _Default para qualquer novo projeto ou pastaCloud de Confiance que você criar na organização ou pasta configurando as configurações padrão de recursos do Cloud Logging.

  • Excluir

    • Não é possível excluir os coletores _Default ou _Required.
    • Quando você exclui um coletor, ele não encaminha mais entradas de registro.
    • Se o coletor tiver uma conta de serviço dedicada, a exclusão dele também vai excluir a conta de serviço. Os coletores criados antes de 22 de maio de 2023 têm contas de serviço dedicadas. Os coletores criados a partir de 22 de maio de 2023 têm uma conta de serviço compartilhada. A exclusão do coletor não exclui a conta de serviço compartilhada.

  • Resolver falhas

Confira a seguir as instruções para gerenciar um coletor em um projeto do Cloud de Confiance . Em vez de um Cloud de Confiance projeto, é possível especificar uma conta de faturamento, pasta ou organização:

Console

  1. No console do Cloud de Confiance , acesse a página Roteador de registros.

    Acessar o roteador de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  2. Na barra de ferramentas, selecione o recurso que contém o coletor. O recurso pode ser um projeto, uma pasta, uma organização ou uma conta de faturamento.

A página Roteador de registros mostra os coletores no recurso selecionado. Cada linha da tabela contém informações sobre as propriedades de um coletor:

  • Ativado: indica se o estado do coletor está ativado ou desativado.
  • Tipo: o serviço de destino do coletor. por exemplo, Cloud Logging bucket.
  • Nome: o identificador do coletor, conforme fornecido quando ele foi criado. Por exemplo, _Default.
  • Descrição: a descrição do coletor, conforme fornecido quando o coletor foi criado.
  • Destino: o nome completo do destino para onde as entradas de registro roteadas são enviadas.
  • Criado: a data e hora em que o coletor foi criado.
  • Última atualização: a data e a hora em que o coletor foi editado pela última vez.
  • Volume: informa o volume total de registros roteados para o coletor de registros. O valor inclui o volume roteado para buckets de registros, projetos ou outros destinos.

Em cada linha da tabela, o menu Mais ações oferece as seguintes opções:

  • Visualizar detalhes do coletor: exibe o nome, a descrição, o serviço de destino, o destino e os filtros de inclusão e exclusão do coletor. Selecione Editar para abrir o painel Editar coletor.
  • Editar coletor: abre o painel Editar coletor em que é possível atualizar os parâmetros do coletor.
  • Desativar coletor: permite desativar o coletor e parar de rotear entradas de registro para o destino do coletor. Para mais informações sobre como desativar gravadores, consulte Parar de armazenar registros em buckets de registro.
  • Ativar coletor: permite ativar um coletor desativado e reiniciar o roteamento de entradas de registro para o destino do coletor.
  • Excluir coletor: permite excluir o coletor e interromper o roteamento de entradas de registro para o destino do coletor.
  • Resolver problemas do coletor: abre a Análise de registros, em que é possível resolver problemas de erros com o coletor.
  • Ver as taxas de erro e volume de registro do coletor: abre o Metrics Explorer, onde é possível ver e analisar dados do coletor.

Para classificar a tabela por uma coluna, selecione o nome dela.

gcloud

  • Para ver a lista de coletores do projeto Cloud de Confiance , use o comando gcloud logging sinks list, que corresponde ao método da API Logging projects.sinks.list:

    gcloud logging sinks list

    Para conferir sua lista de coletores agregados, use a opção adequada para especificar o recurso que contém o coletor. Por exemplo, se você criou o coletor no nível da organização, use a opção --organization=ORGANIZATION_ID para listar os coletores da organização.

  • Para descrever um coletor, use o comando gcloud logging sinks describe, que corresponde ao método da API Logging projects.sinks.get:

    gcloud logging sinks describe SINK_NAME

  • Para atualizar um coletor, use o comando gcloud logging sinks update, que corresponde ao método de API projects.sinks.update.

    É possível atualizar um coletor para mudar o destino, os filtros e a descrição ou para desativar ou reativar o coletor:

    gcloud logging sinks update SINK_NAME NEW_DESTINATION --log-filter=NEW_FILTER

    Omita NEW_DESTINATION ou --log-filter se essas partes não mudarem.

  • Para desativar um coletor, use o comando gcloud logging sinks update, que corresponde ao método de API projects.sinks.update, e inclua a opção --disabled:

    gcloud logging sinks update SINK_NAME --disabled

    Para reativar o coletor, use o comando gcloud logging sinks update, remova a opção --disabled e inclua a opção --no-disabled:

    gcloud logging sinks update SINK_NAME --no-disabled

  • Para excluir um coletor, use o comando gcloud logging sinks delete, que corresponde ao método de API projects.sinks.delete:

    gcloud logging sinks delete SINK_NAME

    Para mais informações sobre como gerenciar gravadores usando a Google Cloud CLI, consulte a referência gcloud logging sinks.

REST

  • Para conferir os coletores do seu projeto Cloud de Confiance , chame projects.sinks.list.

  • Para visualizar os detalhes de um coletor, chame projects.sinks.get.

  • Para atualizar um coletor, chame projects.sinks.update.

    É possível atualizar o destino, os filtros e a descrição de um coletor. Também é possível desativar ou reativar o coletor.

  • Para desativar um coletor, defina o campo disabled no objeto LogSink como true e chame projects.sinks.update.

    Para reativar o coletor, defina o campo disabled no objeto LogSink como false e chame projects.sinks.update.

  • Para excluir um coletor, chame projects.sinks.delete.

    Para mais informações sobre como gerenciar coletores usando a API Logging, consulte a referência LogSink.

Parar de armazenar entradas de registro em buckets de registros

É possível desativar o coletor _Default e todos os coletores definidos pelo usuário. Quando você desativa um coletor, ele para de encaminhar novas entradas de registro para o destino. Por exemplo, se você desativar o coletor _Default, nenhuma entrada de registro será encaminhada para o bucket _Default. O bucket _Default fica vazio quando todas as entradas de registro armazenadas anteriormente atingem o fim do período de armazenamento do bucket.

As instruções a seguir ilustram como desativar um gravador _Default do projeto Cloud de Confiance para que ele não roteie entradas de registro para o bucket de registros _Default:

Console

  1. No console do Cloud de Confiance , acesse a página Roteador de registros.

    Acessar o roteador de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  2. Para encontrar todos os coletores que encaminham entradas de registro para o bucket de registros _Default, filtre os coletores por destino e insira _Default.

  3. Para cada coletor, selecione Menu e depois Desativar coletor.

    Os coletores agora estão desativados e não encaminham mais entradas de registro para o bucket _Default.

Para reativar um coletor desativado e reiniciar as entradas de registro de roteamento para o destino do coletor, faça o seguinte:

  1. No console do Cloud de Confiance , acesse a página Roteador de registros.

    Acessar o roteador de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  2. Para encontrar todos os coletores que encaminham entradas de registro para o bucket de registros _Default, filtre os coletores por destino e insira _Default.
  3. Para cada coletor, selecione Menu e depois Ativar coletor.

gcloud

  1. Para ver a lista de coletores do projeto Cloud de Confiance , use o comando gcloud logging sinks list, que corresponde ao método da API Logging projects.sinks.list:

    gcloud logging sinks list

  2. Identifique os coletores que estão roteando para o bucket de registros _Default. Para descrever um coletor, incluindo o nome do destino, use o comando gcloud logging sinks describe, que corresponde ao método da API Logging projects.sinks.get:

    gcloud logging sinks describe SINK_NAME

  3. Execute o comando gcloud logging sinks update e inclua a opção --disabled. Por exemplo, para desativar o coletor _Default, use o seguinte comando:

    gcloud logging sinks update _Default --disabled

    O coletor _Default agora está desativado. Ele não encaminha mais entradas de registro para o bucket de registros _Default.

Para desativar os outros coletores no projeto Cloud de Confiance que estão roteando para o bucket _Default, repita as etapas anteriores.

Para reativar um coletor, use o comando gcloud logging sinks update, remova a opção --disabled e inclua a opção --no-disabled:

gcloud logging sinks update _Default --no-disabled

REST

  1. Para conferir os coletores do seu projeto Cloud de Confiance , chame o método da API Logging projects.sinks.list.

    Identifique os coletores que estão roteando para o bucket _Default.

  2. Por exemplo, para desativar o gravador _Default, defina o campo disabled no objeto LogSink como true e chame projects.sinks.update.

    O coletor _Default agora está desativado. Ele não encaminha mais entradas de registro para o bucket _Default.

Para desativar os outros coletores no projeto Cloud de Confiance que estão roteando para o bucket _Default, repita as etapas anteriores.

Para reativar um coletor, defina o campo disabled no objeto LogSink como false e chame projects.sinks.update.

Amostras de código

Para usar o código da biblioteca de cliente e configurar coletores nas linguagens escolhidas, consulte Exemplos de código.

Exemplos de filtros

Confira a seguir alguns exemplos de filtros que são especialmente úteis ao criar coletores. Para outros exemplos que podem ser úteis ao criar seus filtros de inclusão e de exclusão, consulte Amostra de consultas.

Restaurar o filtro do coletor _Default

Se você editou o filtro para o coletor _Default, talvez queira restaurar esse coletor à configuração original. Quando criado, o coletor _Default é configurado com o seguinte filtro de inclusão e um filtro de exclusão vazio:

  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")

Excluir registros de contêiner e de pod do Google Kubernetes Engine

Para excluir as entradas de registro de contêiner e pod do Google Kubernetes Engine do sistema GKE namespaces, use o seguinte filtro:

resource.type = ("k8s_container" OR "k8s_pod")
resource.labels.namespace_name = (
"cnrm-system" OR
"config-management-system" OR
"gatekeeper-system" OR
"gke-connect" OR
"gke-system" OR
"istio-system" OR
"knative-serving" OR
"monitoring-system" OR
"kube-system")

Para excluir entradas de registro de nó do Google Kubernetes Engine para valores do sistema GKE log_id, use o filtro a seguir:

resource.type = "k8s_node"
(log_id("container-runtime") OR
 log_id("docker") OR
 log_id("kube-container-runtime-monitor") OR
 log_id("kube-logrotate") OR
 log_id("kube-node-configuration") OR
 log_id("kube-node-installation") OR
 log_id("kubelet") OR
 log_id("kubelet-monitor") OR
 log_id("node-journal") OR
 log_id("node-problem-detector"))

Compatibilidade

Embora o Cloud Logging permita excluir entradas de registro e impedir que elas sejam armazenadas em um bucket de registros, talvez seja interessante manter as entradas que ajudam na capacidade de suporte. O uso dessas entradas de registro pode ajudar você a resolver problemas e identificar falhas nos aplicativos.

Por exemplo, as entradas de registro do sistema do GKE são úteis para resolver problemas dos seus aplicativos e clusters do GKE porque são geradas para eventos que acontecem no cluster. Essas entradas de registro podem ajudar você a determinar se o código do aplicativo ou o cluster subjacente do GKE está causando um erro no aplicativo. Os registros do sistema do GKE também incluem o registro de auditoria do Kubernetes gerado pelo componente servidor de API do Kubernetes, que inclui mudanças feitas usando o comando kubectl e eventos do Kubernetes.

A seguir