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.
Antes de começar
Para ter as permissões necessárias para conferir 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 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:
-
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.
- 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 Test results 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 de falhas. 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:
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:
-
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.
- No gráfico de dispersão ou na tabela, selecione um rastro.
- 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:
- No painel com o nome do monitor sintético, clique no nome da função do Cloud Run.
- 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 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:
- No painel com o nome do monitor sintético, clique no nome da função do Cloud Run.
- Na página Detalhes da função, selecione a guia Métricas.
Para ampliar um intervalo de tempo específico, faça o seguinte:
- Em um gráfico, posicione o ponteiro em uma extremidade do intervalo de tempo e clique com o botão esquerdo do mouse.
- 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 more_vert 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.