Observabilidade no Eventarc

O Google Cloud Observability oferece ferramentas de monitoramento, geração de registros e diagnóstico. Essas ferramentas ajudam a monitorar e analisar a atividade e o crescimento do Eventarc, além de entender o comportamento, a integridade e a performance dos seus aplicativos.

Por padrão, o Eventarc é configurado para fazer o seguinte:

  • Envie dados e registros de auditoria do sistema para o Cloud Logging. É possível usar os registros coletados para depurar, resolver problemas e ter insights sobre seus aplicativos.
  • Envie métricas de sistema e recursos para o Cloud Monitoring. É possível usar as métricas coletadas para monitorar a integridade e o desempenho, identificar tendências e problemas e notificar mudanças no comportamento.

Enviar registros de auditoria para o Cloud Logging

O Eventarc envia os seguintes tipos de dados de registro de auditoria para o Cloud Logging:

Os registros de auditoria de acesso a dados estão desativados por padrão porque podem ser muito grandes.

Para mais informações, consulte Geração de registros de auditoria do Eventarc e Geração de registros de auditoria de publicação do Eventarc.

Consultar e exibir registros

Use as ferramentas a seguir para ver e analisar seus registros:

  • O Explorador de registros foi criado para ajudar você a resolver problemas e analisar o desempenho dos seus serviços e aplicativos. Para saber como visualizar registros no Explorador de registros, siga as instruções em Ver registros usando o Explorador de registros.
  • A Análise de registros foi projetada para executar consultas e analisar seus registros e, em seguida, conferir ou criar gráficos com os resultados. Para saber como usar a Análise de registros, siga as instruções em Consultar e analisar registros com a Análise de registros.

Para filtrar os registros do Eventarc na Análise de registros, pesquise eventarc no campo de pesquisa.

Para mais informações sobre como consultar e analisar registros, consulte Visão geral de consultas e registros de registros.

Conferir os registros do Eventarc Advanced

Além das ferramentas do Cloud Logging, é possível conferir os registros avançados do Eventarc usando o console Google Cloud .

  1. No console Google Cloud , acesse a página Eventarc > Barramento:

    Acessar Bus

    Ou acesse a página Eventarc > Pipelines:

    Acessar "Pipelines"

  2. Para acessar a página Detalhes do pipeline, clique no nome de um pipeline.

  3. Na página Detalhes do barramento ou Detalhes do pipeline, clique na guia Registros.

    A guia Registros mostra os seguintes tipos de registros:

    • Registros da plataforma gravados pelo Eventarc e enviados ao Logging. Você usa esses registros para depurar e solucionar problemas e para entender melhor os Google Cloud serviços usados.

    • Registros de auditoria de qualquer operação realizada, como uma atualização na configuração de um pipeline.

  4. Para filtrar os registros por gravidade, selecione o tipo de registro a ser exibido na lista Padrão. Por padrão, os registros de todos os níveis de gravidade são exibidos.

    A gravidade de um evento descrito em uma entrada de registro é expressa como um dos vários níveis de gravidade padrão. Se você estiver gravando entradas de registro, poderá especificar a gravidade mínima dos eventos descritos nelas e mapear outras codificações de gravidade para um dos níveis padrão. Para ver mais informações, consulte LogSeverity.

  5. É possível pesquisar entradas em todos os campos de registro. À direita de Filtro, no campo Pesquisar todos os campos e valores, digite seu texto.

    É possível especificar uma correspondência exata para um valor, por exemplo, payload = "jsonPayload". Ou use expressões regulares para fazer correspondências com campos específicos. Há suporte para a linguagem de consulta do Logging completa.

Enviar métricas para o Cloud Monitoring

O Eventarc envia dados de métricas de recursos monitorados para o Google Cloud Observability. Um recurso monitorado no Monitoring representa uma entidade lógica ou física, como uma máquina virtual, um banco de dados ou um aplicativo. Os recursos monitorados contêm um conjunto exclusivo de métricas que podem ser analisadas, informadas em um painel ou usadas para criar alertas. Cada recurso também tem um conjunto de rótulos, que são pares de chave-valor com informações adicionais sobre o recurso. Os rótulos de recursos estão disponíveis para todas as métricas associadas a ele.

O Eventarc envia dados de métricas do seguinte recurso monitorado para o Google Cloud Observability:

Métricas e rótulos de recursos

As strings "tipo de métrica" nesta tabela precisam ser prefixadas com eventarc.googleapis.com/. Esse prefixo foi omitido das entradas na tabela. Ao consultar um rótulo, use o prefixo metric.labels.. por exemplo, metric.labels.LABEL="VALUE".

Tipo de métrica Etapa do lançamento (níveis da hierarquia de recursos)
Nome de exibição
Classe, Tipo, Unidade
Recursos monitorados		 Descrição
Rótulos
quota/enrollments_per_message_bus/exceeded BETA  (projeto)
Erro de cota de barramento de mensagens excedida por inscrições
DELTA, INT64, 1
eventarc.googleapis.com/Location 		Número de tentativas de exceder o limite no evento de métrica de cota eventarc.googleapis.com/enrollments_per_message_bus. Após a amostragem, os dados não são visíveis por até 150 segundos.
limit_name: O nome do limite.
message_bus: O barramento de mensagens a que as inscrições estão anexadas.
quota/enrollments_per_message_bus/limit BETA  (projeto)
Inscrições por limite de cota do barramento de mensagens
GAUGE, INT64, 1
eventarc.googleapis.com/Location 		Limite atual na métrica de cota eventarc.googleapis.com/enrollments_per_message_bus. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 150 segundos.
limit_name: O nome do limite.
message_bus: O barramento de mensagens a que as inscrições estão anexadas.
quota/enrollments_per_message_bus/usage BETA  (projeto)
Inscrições por uso da cota do barramento de mensagens
GAUGE, INT64, 1
eventarc.googleapis.com/Location 		Uso atual na métrica de cota eventarc.googleapis.com/enrollments_per_message_bus. Após a amostragem, os dados não são visíveis por até 150 segundos.
limit_name: O nome do limite.
message_bus: O barramento de mensagens a que as inscrições estão anexadas.

Tabela gerada em 26-06-2025 13:43:55 UTC.

Para conferir todos os tipos de recursos, consulte Tipos de recursos monitorados. Para conferir todos os tipos de métricas, consulte Métricas doGoogle Cloud .

Ler dados de métricas

É possível ler dados de métricas, também chamados de dados de série temporal, usando o método timeSeries.list na API Cloud Monitoring. Há várias maneiras de chamar o método, incluindo o uso de uma biblioteca de cliente específica da linguagem ou a criação de um gráfico com o Metrics Explorer. Para uma introdução a métricas e série temporal, consulte Métricas, série temporal e recursos. Para saber como ler os dados de métricas, consulte Recuperar dados de série temporal.

Usar painéis e alertas do Monitoring

É possível usar os painéis de monitoramento e os respectivos gráficos associados para visualizar os dados das métricas do Eventarc.

Para monitorar essas métricas no Monitoring, é possível criar painéis personalizados. Você também pode adicionar alertas com base nessas métricas.

A seguir