Analisar os resultados do monitor sintético

Neste documento, descrevemos como analisar o histórico de execução da sua monitores sintéticos e também descreve como visualizar as métricas coletadas e ou de sistemas operacionais de contêineres.

Antes de começar

Para ter as permissões necessárias para acessar os resultados da execução de monitores sintéticos no console do Google Cloud, faça o seguinte: 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 a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

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 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. 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. Esta página também exibe 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:

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

• Veja o código atual.

  Observação: as funções do Cloud Run armazenam uma cópia do seu código. Quando você visualiza o resultados de qualquer execução, o código exibido é o código atual e podem não ser relevantes para a execução específica.

• 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 vai conter quatro entradas. Cada entrada na lista é anotada como aprovada ou reprovada.

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

Ver dados de registro

Os registros são coletados automaticamente pelo Cloud Monitoring. Esses registros contêm informações sobre o teste e os detalhes da falha. Os registros disponíveis dependem a função do Cloud Run. Por exemplo, se você usar Mocha, então o incluem informações sobre se o teste foi aprovado ou reprovado, duração total 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 ver detalhes dos seus registros relacionados, no painel Registros de execução, faça o seguinte: expandir uma entrada de registro.

A entrada de registro é mostrada no formato JSON. Se você preferir conferir 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 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:

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 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 de rastreamento, 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 seu trace ou período exibe um círculo, é possível clicar nele para exibir os a uma 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 mostra um resumo dos dados de latência. Para informações completas sobre o trace e os períodos dele, consulte 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 um círculo. Para ver detalhes sobre o evento ou o registro, selecione o círculo.

Para saber mais sobre como analisar seus dados de rastreamento, consulte Encontrar e explorar traces.

API

Recomendamos que você use o console do Google Cloud para conferir os dados de rastreamento. No entanto, se quiser usar a API Cloud Trace, use o Método traces.list para listar os traces disponíveis. e use o método Método traces.get para receber 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 visualizar 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. Na Análise de registros, é possível realizar ações como refinar a consulta, criar métrica com base em registros ou crie um alerta com base em registros.

API

Para informações sobre como ler e gravar a função do Cloud Run 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 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 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 aumentar o zoom em um período 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 período e depois solte o botão do ponteiro.

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, em seguida, 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 mais informações sobre como ler a função do Cloud Run métricas de forma programática, consulte Como visualizar métricas monitoradas.