Analisar os resultados de monitores sintéticos

Este documento descreve como explorar o histórico de execução dos seus monitores sintéticos e como visualizar as métricas e os registros coletados.

Esse recurso é compatível apenas com Google Cloud projetos. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.

Antes de começar

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

Visualizar 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 Google Cloud console do, acesse a página  Monitoramento sintético:

    Acessar o 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 Google Cloud console, selecione seu Google Cloud projeto. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.
  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 de resumo, como taxa de sucesso, duração e o status mais recente. Essa página também mostra a duração registrada da execução e contém uma tabela que exibe uma linha para cada execução.

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

Visualizar registros e traces de uma execução

Para visualizar os registros, os traces e as 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, você pode fazer o seguinte:

  • Visualizar dados de registro.
  • Visualizar dados de trace.

  • Visualizar o código atual.

  • Acessar a função do Cloud Run.

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

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

Visualizar dados de registro

Os registros são coletados automaticamente pelo Cloud Monitoring. Esses registros 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 com falha, os tipos de erro e as mensagens de erro.

Para visualizar 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 visualizar os registros com a Análise de registros, clique em Abrir na Análise de registros. A Análise de registros é aberta e uma consulta é pré-configurada.

Visualizar dados de trace

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

Console

Para visualizar os dados de trace, faça uma das seguintes ações:

  • Para visualizar informações de resumo de um trace, na barra de ferramentas da página de detalhes de uma execução, clique em Visualizar 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 Visualizar no Cloud Trace, que abre a página Explorador de traces.

  • Visualizar seus traces no Cloud Trace:

    1. No Google Cloud console, 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 Google Cloud console, selecione seu Google Cloud projeto. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.
    3. No gráfico de mapa de calor ou na tabela, selecione um trace.

Seu trace e períodos 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 explorar os dados de trace, consulte Encontrar e explorar traces.

REST

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

Visualizar 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 a função do Cloud Run está realizando. Por exemplo, os registros que contêm um campo chamado userAgent com um valor de GoogleStackdriverMonitoring-UptimeChecks indicam que o 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 coletadas pelas funções do Cloud Run.

Ver registros da função

Console

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

  1. No painel com o nome do 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 explorar os dados de registro em um gráfico com mais detalhes, expanda uma entrada de registro e selecione Abrir na Análise de registros. No Análise de registros, você pode realizar ações como refinar a consulta, criar uma métrica com base em registros ou criar um alerta com base em registros.

REST

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

Visualizar 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 Visualizar 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.

Para visualizar as métricas de funções do Cloud Run no Google Cloud console, faça o seguinte:

  1. No painel com o nome do 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, coloque o ponteiro em uma extremidade do intervalo de tempo e clique com o botão esquerdo do mouse.
  2. Arraste o ponteiro horizontalmente para a outra extremidade do intervalo de tempo e solte o botão do ponteiro.

Para explorar 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
  • Expandir ou recolher a legenda do gráfico
  • Redefinir o zoom