Analisar os resultados de monitores sintéticos

Neste documento, descrevemos como analisar o histórico de execução dos seus monitores sintéticos e como acessar as métricas e os registros coletados.

Esse recurso só é compatível com projetos Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.

Antes de começar

Conclua as seguintes etapas no projeto do Google Cloud que armazena seu monitor sintético:

Conferir o histórico de execução de um monitor sintético

Para entender o histórico de execuções aprovadas e com falha, acesse a página Detalhes do monitor sintético:

  1. No console Google Cloud , acesse a página  Monitoramento sintético:

    Acessar Monitoramento sintético

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

  2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
  3. Para abrir a página Detalhes do monitor sintético, localize o monitor sintético que você quer visualizar e clique no nome dele.

A página Detalhes do monitor sintético lista informações resumidas, como a taxa de sucesso e a duração, além do status mais recente. Essa página também mostra a duração registrada da execução e contém uma tabela com uma linha para cada execução.

Cada linha da tabela lista o status, a data, a duração e um link para uma página que mostra o código atual e os registros relevantes para essa execução.

Ver registros e rastreamentos de uma execução

Para conferir os registros, rastreamentos e informações de resumo de uma execução, na página Detalhes do monitor sintético, clique no link da execução. Nessa página, é possível fazer o seguinte:

  • Ver dados de registros.
  • Ver dados de rastreamento.

  • Confira o código atual.

  • Acesse a função do Cloud Run.

  • Para testes do Mocha, confira os resultados de cada teste. Por exemplo, se o monitor sintético tiver quatro testes do Mocha, o painel Resultados do teste vai ter quatro entradas. Cada entrada na lista é anotada como aprovada ou reprovada.

    Se você selecionar uma entrada marcada como falha, o código com falha será exibido e destacado.

Ver dados de registro

Os registros são coletados automaticamente pelo Cloud Monitoring. Eles contêm informações sobre o teste e detalhes da falha. Os registros disponíveis dependem da sua função do Cloud Run. Por exemplo, se você usar o Mocha, os registros vão incluir informações sobre se o teste foi aprovado ou reprovado, a duração do teste e, em caso de falha, um stack trace completo. O stack trace inclui a linha de código que falhou, os tipos de erro e as mensagens de erro.

Para conferir os detalhes dos registros relacionados, no painel Registros de execução, expanda uma entrada de registro.

A entrada de registro é mostrada no formato JSON. Se você preferir ver os registros com o Explorador de registros, clique em Abrir no Explorador de registros. A Análise de registros é aberta, e uma consulta é pré-configurada.

Visualizar dados de trace

Os dados de rastreamento são coletados quando sua função do Cloud Run é executada. Para conferir os dados de rastreamento, use o console Google Cloud ou a API Cloud Trace.

Console

Para visualizar os dados de trace, faça o seguinte:

  • Para ver um resumo das informações de um trace, na barra de ferramentas da página de detalhes de uma execução, clique em Ver detalhes do trace.

    O painel Detalhes é aberto e mostra um diagrama de Gantt com informações sobre cada período, que é um registro de uma operação no trace. Para informações completas sobre o trace e os períodos dele, clique em Ver no Cloud Trace, que abre a página do Explorador de traces.

  • Confira seus traces no Cloud Trace:

    1. No console Google Cloud , acesse a página Explorador de traces:

      Acessar o Explorador de traces

      Também é possível encontrar essa página usando a barra de pesquisa.

    2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
    3. No gráfico de mapa de calor ou na tabela, selecione um trace.

Seu rastreamento e intervalos podem incluir círculos na linha do tempo que representam entradas de registro ou eventos que ocorreram durante a execução. Clique no círculo para mostrar informações sobre a entrada de registro ou o evento. Para identificar uma função do Cloud Run em uma entrada de registro, consulte o campo resource.labels.service_name.

Para mais informações sobre como analisar seus dados de trace, consulte Encontrar e analisar traces.

API

Recomendamos usar o console Google Cloud para ver os dados de rastreamento. No entanto, se você quiser usar a API Cloud Trace, use o método traces.list para listar os traces disponíveis e o método traces.get para receber os detalhes de um trace.

Ver registros e métricas de uma função do Cloud Run

Os registros e as métricas fornecem informações sobre as ações que sua função do Cloud Run está realizando. Por exemplo, registros que contêm um campo chamado userAgent com um valor de GoogleStackdriverMonitoring-UptimeChecks indicam que seu serviço recebeu uma solicitação do serviço de verificação de tempo de atividade.

O restante desta seção descreve como visualizar os registros e as métricas coletados pelas funções do Cloud Run.

Ver registros da função

Console

Para conferir os registros de funções do Cloud Run, faça o seguinte:

  1. No painel com o nome do seu monitor sintético, clique no nome da função do Cloud Run.
  2. Na página Detalhes da função, selecione a guia Registros.

Para analisar os dados de registro em um gráfico com mais detalhes, expanda uma entrada de registro e selecione Abrir no Explorador de registros. Na Análise de registros, é possível realizar ações como refinar a consulta, criar uma métrica com base em registros ou criar um alerta com base em registros.

API

Para informações sobre como ler e gravar registros de funções do Cloud Run de forma programática, consulte Como gravar, visualizar e responder a registros.

Ver métricas de função

Para monitores sintéticos, as métricas são coletadas pelo Cloud Monitoring e pelas funções do Cloud Run:

  • O Cloud Monitoring coleta métricas sobre cada execução de um monitor sintético. Essas métricas incluem a latência da execução do código e o histórico de sucesso. Para informações sobre como visualizar essas métricas, consulte Ver o histórico de execução de um monitor sintético.

  • O Cloud Run functions coleta métricas sobre cada função do Cloud Run. Essas métricas registram o tempo de execução, a utilização de memória, a contagem de instâncias e o número de invocações por seção. O restante desta seção descreve como visualizar essas métricas.

Console

Para conferir as métricas da função do Cloud Run, faça o seguinte:

  1. No painel com o nome do seu monitor sintético, clique no nome da função do Cloud Run.
  2. Na página Detalhes da função, selecione a guia Métricas.

Para ampliar um intervalo de tempo específico, faça o seguinte:

  1. Em um gráfico, posicione o ponteiro em uma extremidade do período e clique com o botão esquerdo.
  2. Arraste o ponteiro horizontalmente para a outra extremidade do intervalo de tempo e solte o botão.

Para analisar os dados mostrados em um gráfico com mais detalhes, na barra de ferramentas do gráfico, selecione Mais opções de gráfico e faça uma seleção. As opções incluem:

  • Baixar o gráfico como PNG ou CSV
  • Salvar o gráfico em um painel personalizado
  • Abrir o Metrics Explorer
  • Abrir ou fechar a legenda do gráfico
  • Redefinir o zoom