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 como conceder papéis, consulte Gerenciar acesso.
Também é possível conseguir 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:
-
No console do Google Cloud, acesse 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 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 faz gráficos 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 está vinculado a um que exibe o código atual e os registros relevantes para a execução.
Ver registros e traces de uma execução
Para visualizar registros, traces e informações resumidas de uma execução, Na página Detalhes do monitor sintético, clique no link da execução. Nessa página, você pode fazer o seguinte:
- Veja os dados de registro.
- Visualizar dados do trace.
Veja 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 Resultados do teste vai conter 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 em destaque.
Ver dados de registro
Os registros são coletados automaticamente pelo Cloud Monitoring. Esses registros contêm sobre os detalhes do teste e 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. A o stack trace inclui a linha de código com falha, os tipos de erro e 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 é exibida no formato JSON. Se preferir ver registros com a Análise de registros e 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 Run é executado. A captura de tela a seguir mostra o tipo de dados que o trace captura ao usar 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 trace exibem
que foi passado para o registrador winston e exibe a saída
Solicitação HTTP emitida pela chamada get
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
a uma entrada de registro. A função do Cloud Run pode ser identificada
resource.labels.service_name
.
Console
Para visualizar os dados de trace, siga um destes procedimentos:
Para visualizar informações resumidas de um trace, na barra de ferramentas da página de detalhes Para uma execução, clique em Visualizar detalhes do trace.
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, consulte os dados no Cloud Trace. Para abrir o Cloud Trace, clique em Visualizar 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 recebe a anotação 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 visualizar os dados de trace.
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.
Acessar registros e métricas de uma função do Cloud Run
Os registros e as métricas fornecem informações sobre as ações
função do Cloud Run em execução. Por exemplo, os registros que contêm uma
campo chamado userAgent
com um valor de
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 exibir os registros e as métricas coletados por 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:
- No painel com o nome do monitor sintético, clique em o nome da função do Cloud Run.
- 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 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 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 informações sobre como exibir essas métricas, consulte Veja 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. Esses registram o tempo de execução, a utilização da memória, o contagem e o número de invocações por seção. O restante esta seção descreve como visualizar essas métricas.
Console
Para visualizar as métricas da função do Cloud Run, faça o seguinte:
- No painel com o nome do monitor sintético, clique em o nome da função do Cloud Run.
- 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 período e depois clique com o botão esquerdo do mouse.
- 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 more_vert Mais opções de gráfico, e, em seguida, 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 mais informações sobre como ler a função do Cloud Run métricas de forma programática, consulte Como visualizar métricas monitoradas.