Analisar os resultados do monitor sintético

Este documento descreve como você explora o histórico de execução dos seus monitores sintéticos e também como conferir as métricas e os registros coletados.

Esse recurso só é compatível com projetos do Google Cloud.

Antes de começar

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

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

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

  1. No console do 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 Monitoramento.

  2. Na barra de ferramentas do console do Google Cloud, selecione seu projeto.
  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 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.

Conferir registros e rastros de uma execução

Para conferir os registros, os rastros e as informações resumidas de uma execução, clique no link da execução na página Detalhes do monitor sintético. Nessa página, você pode fazer o seguinte:

  • Acessar os dados do registro.
  • Acessar dados de rastreamento.

  • Confira o código atual.

  • Acesse a função do Cloud Run.

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

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

Ver 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 falhou, a duração do teste e, no 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 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 conferir os registros com o Logs Explorer, clique em Abrir no Logs Explorer. O Logs Explorer é aberto e uma consulta é pré-configurada.

Visualizar dados de trace

Os dados de rastreamento são coletados automaticamente quando a função do Cloud Run é executada. A captura de tela a seguir mostra o tipo de dados que o trace captura quando você usa o modelo genérico:

O Cloud Trace mostrando detalhes de um trace para uma função do Cloud Run.

Na captura de tela anterior, a primeira linha do gráfico de Gantt mostra a solicitação HTTP iniciada pelo Cloud Monitoring. Os dados de rastreamento mostram o texto que foi transmitido para o registrador Winston e a solicitação HTTP de saída emitida pela chamada get do Axios.

No menu suspenso do trace, se você clicar em Ver no trace, poderá conferir seus dados de trace usando o explorador do Cloud Trace. O trace já está aberto para mostrar os detalhes. Quando o trace ou a extensão mostrar um círculo, clique nele para mostrar a entrada de registro. A função do Cloud Run pode ser identificada acessando o campo resource.labels.service_name.

Console

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

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

    Um menu suspenso é aberto, mostrando um resumo dos dados de latência. Para informações completas sobre o trace e os spans, acesse os dados no Cloud Trace. Para abrir o Cloud Trace, clique em Ver no trace.

  • Confira seus traces no Cloud Trace:

    1. No console do 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 do Google Cloud, selecione seu projeto.
    3. No gráfico de dispersão ou na tabela, selecione um rastro.
    4. Para cada registro ou evento associado a um período, o período é anotado com um círculo. Para conferir detalhes sobre o evento ou o registro, selecione o círculo.

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

API

Recomendamos que você use o console do Google Cloud para conferir 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, em seguida, use o método traces.get para conferir os detalhes de um trace.

Conferir 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, 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 da função 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 conferir os dados de registro em um gráfico com mais detalhes, abra uma entrada de registro e selecione Abrir no Explorador de registros. No Explorador 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ção do Cloud Run de forma programática, consulte Como gravar, consultar e responder a registros.

Conferir métricas da função

Para monitores sintéticos, as métricas são coletadas pelo Cloud Monitoring e pelo 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 saber como visualizar essas métricas, consulte Conferir o histórico de execução de um monitor sintético.

  • As funções do Cloud Run coletam 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 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 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 conferir mais detalhes sobre os dados mostrados em um gráfico, na barra de ferramentas do gráfico, selecione Mais opções de gráfico e faça uma seleção. As opções incluem:

  • Fazer o download do 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

API

Para saber como ler as métricas da função do Cloud Run de forma programática, consulte Como visualizar métricas monitoradas.