Conferir os resultados do monitor sintético

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

Antes de começar

Para receber as permissões necessárias para visualizar os resultados da execução de monitores sintéticos usando o console do Google Cloud, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

• Leitor do Monitoring (roles/monitoring.viewer)
• Desenvolvedor do Cloud Functions (roles/cloudfunctions.developer)
• Visualizador de registros (roles/logging.viewer)

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

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

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

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

   Acesse Monitoramento sintético

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

2. 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 e a duração de sucesso e o status mais recente. Essa página também mapeia 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 e a duração, além de estar vinculada a uma página que exibe o código atual e os registros relevantes para essa execução.

Ver registros e traces de uma execução

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

• Veja os dados de registro.
• Visualizar dados do trace.

• Veja o código atual.

  Observação: o Cloud Functions armazena uma cópia do seu código. Ao conferir os resultados de qualquer execução, o código exibido é o atual e pode não ser relevante para a execução específica.

• Acessar a função do Cloud

• 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 aprovação ou reprovação.

  Se você selecionar uma entrada marcada como com falha, o código com 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 os detalhes do teste e da falha. Os registros disponíveis dependem da função do Cloud. Por exemplo, se você usar o Mocha, os registros incluirão 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, tipos e mensagens de erro.

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

A entrada de registro é exibida no formato JSON. Se preferir ver 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 automaticamente quando a função do Cloud é executada. A captura de tela abaixo mostra o tipo de dados que o trace captura quando você usa o modelo genérico:

Na captura de tela anterior, a primeira linha do diagrama de Gantt exibe a solicitação HTTP iniciada pelo Cloud Monitoring. Os dados de rastreamento exibem o texto que foi transmitido para o logger da winston e a solicitação HTTP de saída que foi emitida pela chamada get do axios.

No menu suspenso do trace, se você clicar em Visualizar no trace, poderá visualizar os dados de trace usando o explorador do Cloud Trace. O rastro já está expandido para mostrar detalhes. Quando o trace ou o período exibe um círculo, é possível clicar nele para exibir a entrada de registro. A função do Cloud pode ser identificada visualizando o campo resource.labels.service_name.

Console

Para visualizar os dados de trace, siga um destes procedimentos:

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

  Será aberto um menu suspenso que mostra um resumo dos dados de latência. Para informações completas sobre o trace e os períodos dele, veja os dados no Cloud Trace. Para abrir o Cloud Trace, clique em Visualizar no trace.

• Visualize 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. No gráfico de dispersão ou na tabela, selecione um trace.
  3. Para cada registro ou evento associado a um período, ele é anotado com um círculo. Para ver detalhes sobre o evento ou o registro, selecione o círculo.

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

API

Recomendamos que você use o console do Google Cloud para visualizar os dados de trace. 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 acessar os detalhes de um trace.

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

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

No restante desta seção, descrevemos como visualizar os registros e as métricas coletados pelo Cloud Functions.

Ver registros da função

Console

Para visualizar os registros da função do Cloud, faça o seguinte:

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

Para analisar mais detalhadamente os dados de registro em um gráfico, expanda uma entrada de registro e selecione Abrir na Análise 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 função do Cloud de maneira programática, consulte Como gravar, visualizar e responder a registros.

Ver métricas da função

Para monitores sintéticos, as métricas são coletadas pelo Cloud Monitoring e pelo Cloud Functions:

• 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 Functions coleta métricas sobre cada função do Cloud. Essas métricas registram o tempo de execução, a utilização da 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 visualizar as métricas da função do Cloud, faça o seguinte:

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

Para aumentar o zoom em um período específico, faça o seguinte:

1. Em um gráfico, coloque o ponteiro em uma extremidade do intervalo de tempo e clique nele 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 dele.

Para analisar os dados exibidos 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:

• Faça 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 informações sobre como ler as métricas do função do Cloud de maneira programática, consulte Como visualizar métricas monitoradas.