Explore os resultados da monitorização sintética

Este documento descreve como explorar o histórico de execução dos seus monitores sintéticos e também como ver as métricas e os registos recolhidos.

Esta funcionalidade só é suportada para projetos do Google Cloud . Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.

Antes de começar

Conclua o seguinte no Google Cloud projeto que armazena o seu monitor sintético:

Veja o histórico de execuções de um monitor sintético

Para compreender o histórico de execuções aprovadas e reprovadas, consulte a página Detalhes do monitor sintético para o monitor sintético:

  1. Na Google Cloud consola, aceda à página  Monitorização sintética:

    Aceda à monitorização sintética

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

  2. Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
  3. Para abrir a página Detalhes do monitor sintético, localize o monitor sintético que quer ver e, de seguida, clique no respetivo nome.

A página Detalhes da monitorização sintética apresenta informações de resumo, como a taxa de êxito, a duração e o estado mais recente. Esta página também apresenta um gráfico com a duração registada da execução e contém uma tabela que apresenta uma linha para cada execução.

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

Veja registos e rastreios de uma execução

Para ver os registos, os rastreios e as informações de resumo de uma execução, na página Detalhes do monitor sintético, clique no link para a execução. Nesta página, pode fazer o seguinte:

  • Veja os dados de registo.
  • Veja os dados de rastreio.

  • Veja o código atual.

  • Aceda à função do Cloud Run.

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

    Se selecionar uma entrada marcada como falhada, o código com falhas é apresentado e realçado.

Veja dados de registo

Os registos são recolhidos automaticamente pelo Cloud Monitoring. Estes registos contêm informações sobre os detalhes dos testes e das falhas. Os registos disponíveis dependem da sua função do Cloud Run. Por exemplo, se usar o Mocha, os registos incluem informações sobre se o teste foi aprovado ou reprovado, a duração do teste e, em caso de falha, um rastreio de pilha completo. O rastreio de pilha inclui a linha de código que falhou, os tipos de erros e as mensagens de erro.

Para ver os detalhes dos registos relacionados, no painel Registos de execução, expanda uma entrada de registo.

A entrada do registo é apresentada no formato JSON. Se preferir ver os registos com o explorador de registos, clique em Abrir no explorador de registos. O Explorador de registos é aberto e uma consulta é pré-configurada.

Veja dados de rastreio

Os dados de rastreio são recolhidos quando a sua função do Cloud Run é executada. Para ver os dados de rastreio, use a Google Cloud consola ou a API Cloud Trace para ver os dados de rastreio.

Consola

Para ver os dados de rastreio, faça uma das seguintes ações:

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

    O painel Detalhes é aberto e apresenta um gráfico de Gantt com informações sobre cada intervalo, que é um registo de uma operação no rastreio. Para ver informações completas sobre o rastreio e os respetivos intervalos, clique em Ver no Cloud Trace, que abre a página do Explorador de rastreios.

  • Veja os seus rastreios no Cloud Trace:

    1. Na Google Cloud consola, aceda à página Explorador de rastreios:

      Aceda ao Explorador de rastreios

      Também pode encontrar esta página através da barra de pesquisa.

    2. Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
    3. No gráfico de mapa de calor ou na tabela, selecione um rastreio.

O rastreio e os intervalos podem incluir círculos na cronologia que representam entradas de registo ou eventos que ocorreram durante a execução. Clique no círculo para apresentar informações sobre a entrada de registo ou o evento. Para identificar uma função do Cloud Run numa entrada de registo, veja o campo resource.labels.service_name.

Para mais informações sobre como explorar os dados de rastreio, consulte o artigo Encontre e explore rastreios.

API

Recomendamos que use a Google Cloud consola para ver os dados de rastreio. No entanto, se quiser usar a API Cloud Trace, use o método traces.list para listar os rastreios disponíveis e, em seguida, use o método traces.get para obter os detalhes de um rastreio.

Veja registos e métricas de uma função do Cloud Run

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

O resto desta secção descreve como ver os registos e as métricas recolhidas pelas funções do Cloud Run.

Veja os registos de funções

Consola

Para ver os registos 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 o separador Registos.

Para explorar os dados de registo num gráfico mais detalhadamente, expanda uma entrada de registo e, de seguida, selecione Abrir no Explorador de registos. No Explorador de registos, pode realizar ações como refinar a consulta, criar uma métrica baseada em registos ou criar um alerta baseado em registos.

API

Para obter informações sobre como ler e escrever registos de funções do Cloud Run de forma programática, consulte Escrever, ver e responder a registos.

Veja as métricas de funções

Para as monitorizações sintéticas, as métricas são recolhidas pelo Cloud Monitoring e pelas funções do Cloud Run:

  • O Cloud Monitoring recolhe métricas sobre cada execução de um monitor sintético. Estas métricas incluem a latência da execução do código e o histórico de êxitos. Para ver informações sobre como ver estas métricas, consulte o artigo Veja o histórico de execuções de um monitor sintético.

  • As funções do Cloud Run recolhem métricas sobre cada função do Cloud Run. Estas métricas registam o tempo de execução, a utilização de memória, a contagem de instâncias e o número de invocações por secção. O resto desta secção descreve como ver estas métricas.

Consola

Para ver 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 o separador Métricas.

Para aumentar o zoom num intervalo de tempo específico, faça o seguinte:

  1. Num gráfico, coloque o ponteiro numa extremidade do intervalo de tempo e, em seguida, clique com o botão esquerdo do rato.
  2. Arraste o ponteiro horizontalmente para a outra extremidade do intervalo de tempo e, em seguida, solte o botão do ponteiro.

Para explorar os dados apresentados num gráfico mais detalhadamente, na barra de ferramentas do gráfico, selecione Mais opções do gráfico, e, em seguida, faça uma seleção. As opções incluem o seguinte:

  • Transfira o gráfico como PNG ou CSV
  • Guarde o gráfico num painel de controlo personalizado
  • Abra o Metrics Explorer
  • Expandir ou reduzir a legenda do gráfico
  • Reponha o zoom