Observabilidade no Eventarc

O Google Cloud Observability oferece ferramentas de monitoramento, geração de registros e diagnóstico. Essas ferramentas podem ajudar a monitorar e analisar a atividade e o crescimento do Eventarc, além de entender o comportamento, a integridade e o desempenho 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.
  • Enviar métricas do sistema e dos 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 Registro de auditoria do Eventarc e Registro de auditoria de publicação do Eventarc.

Consultar e exibir registros

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

  • O Logs Explorer 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 dados de registros foi projetada para executar consultas e analisar seus registros, e depois conferir ou gerar um gráfico 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.

É possível filtrar os registros do Eventarc na Análise de registros pesquisando eventarc no campo de pesquisa.

Para mais informações sobre como consultar e analisar registros, consulte a 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 do Eventarc Advanced usando o console do Google Cloud.

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

    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 para o registro. Esses registros podem ajudar você a depurar e resolver problemas e entender melhor os serviços Google Cloud que você está usando.

    • 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 para eventos descritos nas entradas de registro 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 com um valor, por exemplo, payload = "jsonPayload". Ou você pode usar expressões regulares para fazer correspondências com campos específicos. Há suporte para a linguagem de consulta completa do Logging.

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 monitoramento 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 acessados, 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 que contêm informações adicionais sobre o recurso. Os rótulos de recursos estão disponíveis para todas as métricas associadas ao recurso.

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 excedência de cota de inscrições por bus de mensagens
DELTAINT641
eventarc.googleapis.com/Location
Número de tentativas de exceder o limite da 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 ao qual as inscrições estão anexadas.
quota/enrollments_per_message_bus/limit BETA(projeto)
Limite de cota de inscrições por bus de mensagens
GAUGEINT641
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 ao qual as inscrições estão anexadas.
quota/enrollments_per_message_bus/usage BETA(projeto)
Uso da cota de inscrição por bus de mensagens
GAUGEINT641
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 ao qual as inscrições estão anexadas.

Tabela gerada em 31-01-2025 00:13:38 UTC.

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

Ler dados de métricas

É possível ler dados de métrica, 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 criando 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 Extrair dados de séries temporais.

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