Neste documento, descrevemos como explorar o histórico de execução dos monitores sintéticos e também como visualizar as métricas e os registros coletados.
Antes de começar
Para receber as permissões necessárias para visualizar os resultados de execução dos monitores sintéticos usando o console do Google Cloud, peça ao administrador para conceder a você os seguintes papéis do IAM no seu 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 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 aprovadas e com falha, consulte a página Detalhes do monitor sintético para o monitor sintético:
-
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 Monitoramento.
- Para abrir a página Detalhes do monitor sintético, localize o monitor sintético que você quer ver 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 exibe um gráfico com 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.
Visualizar registros e traces de uma execução
Para visualizar os registros, os traces e as 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:
- Ver dados do registro.
- Visualizar dados de trace.
Veja o código atual.
Acesse 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 aprovada ou reprovada.
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 sua função do Cloud. Por exemplo, se você usar Mocha, os registros vão incluir informações sobre se o teste foi aprovado ou reprovado, duração do teste e, em caso de falha, um stack trace completo. O stack trace inclui a linha de código que falhou, os tipos e as mensagens de erro.
Para visualizar os 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 será aberta, e uma consulta será 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 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 exibe a solicitação HTTP iniciada pelo Cloud Monitoring. Os dados de rastreamento exibem o
texto que foi transmitido ao logger do winston e mostram 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á visualizar seus dados de trace usando o
explorador do Cloud Trace. Seu trace já está expandido para mostrar detalhes. Quando
o trace ou período exibir um círculo, você poderá 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 as informações resumidas de um trace, clique em Visualizar detalhes do trace na barra de ferramentas da página de detalhes.
Um menu suspenso é aberto mostrando 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 Ver no trace.
Visualize 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 trace.
- Para cada registro ou evento associado a um período, ele é anotado com um círculo. Para ver detalhes sobre o evento ou registro, selecione o círculo.
-
Para mais informações sobre como explorar os dados de rastreamento, 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 ver os detalhes de um trace.
Visualizar 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 chamado 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.
O restante desta seção descreve como visualizar os registros e as métricas coletados pelo Cloud Functions.
Ver registros da função
Console
Para visualizar os registros de função do Cloud, faça o seguinte:
- No painel com o nome do monitor sintético, clique no nome da Função do Cloud.
- Na página Detalhes da função, selecione a guia Registros.
Para explorar os dados de registro em um gráfico em mais detalhes, 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 da função do Cloud de maneira programática, consulte Como gravar, visualizar 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 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 mais 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:
- No painel com o nome do monitor sintético, clique no nome da Função do Cloud.
- 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:
- Em um gráfico, coloque o ponteiro em uma extremidade do intervalo de tempo e clique nele com o botão esquerdo.
- Arraste o ponteiro horizontalmente até a outra extremidade do intervalo de tempo e solte o botão do ponteiro.
Para explorar os dados exibidos em um gráfico em mais detalhes, 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 informações sobre como ler as métricas da função do Cloud de maneira programática, consulte Como visualizar métricas monitoradas.