Neste guia, você entenderá como filtrar e visualizar erros com o console do Error Reporting.
Começar
Para ver os erros dos serviços e apps no seu projeto do Google Cloud, acesse o Error Reporting no Console do Google Cloud:
O painel do Error Reporting exibe um resumo de cada erro encontrado e o número de ocorrências de cada erro. Quando a opção Atualizar automaticamente está ativada, o Error Reporting recarrega automaticamente a lista de erros a cada 10 segundos.
Os erros são agrupados e as duplicatas deles são removidas com a análise dos rastreamentos de pilha. O Error Reporting reconhece os frameworks comuns usados para sua linguagem e agrupa os erros de acordo. Para mais informações, consulte Como os erros são agrupados.
Cada entrada de erro apresenta um resumo que ajuda você a entender em qual momento o aplicativo começou a gerar erros, a frequência deles e quando ocorreu o último erro.
O Error Reporting processa até 1.000 erros por hora. Quando esse limite é atingido, as contagens exibidas são estimadas. Se houver muitos eventos durante um dia inteiro, o Error Reporting pode processar até 100 erros por hora e continuar excedendo as contagens.
É possível filtrar, classificar e visualizar outros detalhes sobre erros, bem como restringir os erros que aparecem na lista a um intervalo de tempo específico.
Lista do Error Reporting
Se você aplicar um filtro de texto à lista do Error Reporting, a linha da tabela de cada grupo de erros exibirá o número total de erros nesse grupo e o número de erros que corresponderam ao filtro de texto.
As informações a seguir são fornecidas para cada erro informado:
| Coluna | Descrição |
|---|---|
| Status da resolução | O status de um fluxo de trabalho atribuído no nível de grupo de erros. As opções de status são: "Aberto", "Reconhecido", "Resolvido" e "Silenciado". É possível mudar o status de resolução na página da lista. |
| Ocorrências | A quantidade de vezes que esse erro ocorreu no período selecionado. |
| Usuários | A quantidade de usuários afetados por esse erro no período selecionado. A coluna fica oculta caso não haja informações de usuário disponíveis. |
| Erro | Apresenta as informações do erro conforme elas são extraídas do rastreamento de pilha de erro. A mensagem de erro e o local do código dela são exibidos. Se o código estiver disponível no Cloud Source Repositories, você será direcionado à fonte ao clicar no local dele. |
| Visto em | Lista o serviço e a versão em que o erro ocorre. |
| Visto pela primeira vez | O horário que esse erro ocorreu pela primeira vez. |
| Visto pela última vez | O horário que o erro ocorreu pela última vez. |
| Código de resposta | O código de status HTTP retornado com esse erro. |
Ver detalhes do erro
Para visualizar informações detalhadas sobre um grupo de erros, clique em qualquer entrada que apareça na lista do Error Reporting para mostrar a página Detalhes do erro:
Nessa página, você pode examinar informações sobre o grupo de erros, incluindo o histórico de um erro específico, instâncias específicas de erros e informações de diagnóstico contidas em amostras do erro.
Os erros de amostra são encontrados no painel Amostras recentes. Cada amostra representa uma ocorrência do erro e inclui um stack trace analisado.
Ver entradas de registro associadas
Para visualizar a entrada de registro associada a um erro de amostra, clique em Visualizar registros em qualquer entrada no painel Amostras recentes. Essa ação direciona você para o Explorador de registros no console do Cloud Logging.
Você verá que a caixa de consulta de pesquisa é pré-preenchida com o filtro do grupo de erros atual. Abaixo disso, você verá a lista de entradas de registro que contribuem para esse grupo de erros:
O filtro error_group funciona apenas no Explorador de registros. Ele não se aplica, por exemplo, ao criar métricas ou coletores de exportação de registros.
Quando uma entrada de registro faz parte de um grupo de erros, o Explorador de registros exibe o botão do grupo de erros
. Clique no botão para acessar detalhes
de agrupamento ou alterar quais entradas de registro são exibidas. Para mais informações,
consulte Encontrar entradas de registros com grupos de erros.
Para mais informações sobre como usar o console do Google Cloud para visualizar esses registros, consulte Como usar o Explorador de registros.
Filtrar e classificar erros
Filtre, classifique e restrinja os tipos de grupos de erros exibidos na página da lista ou nas páginas de detalhes. Há várias maneiras de filtrar seus erros nessas páginas.
Selecionar intervalo de tempo
O menu de intervalo de tempo permite restringir os grupos de erros exibidos aos últimos períodos, como 1 hora, 6 horas, 1 dia, 7 dias ou 30 dias.
Classificar erros
Nos cabeçalhos das colunas da lista do Error Reporting, é possível classificar as seguintes informações:
- Ocorrências: a classificação nesta coluna permite que você veja os erros mais frequentes.
- Visto pela primeira vez: a classificação nesta coluna ajuda você a encontrar os erros mais recentes.
- Visto pela última vez: a classificação nesta coluna ajuda você a ver quais erros ainda estão ocorrendo. Também é possível reverter a classificação para ver quais erros foram interrompidos.
Correspondência de texto
Use o campo de texto Filtrar erros para filtrar a lista de erros exibidos. Esse campo executa uma correspondência de texto nas informações de Erro, no Código de resposta HTTP, na pilha de exceção e nos seguintes atributos:
- URL de solicitação
- local do relatório (ou seja, o local em que o erro foi registrado)
- Método HTTP
Na página da lista do Error Reporting, o gráfico de barras na coluna Ocorrências é atualizado para mostrar os resultados filtrados em azul, em comparação com o total não filtrado em cinza:
É possível visualizar o gráfico de barras, em detalhes, na página de detalhes do erro na seção Erros.
Ações
Veja a seguir outras ações para visualizar e filtrar erros:
- Link do problema: clique neste botão para adicionar um link do Issue Tracker ao grupo de erros.
- Ver problema: clique neste botão para acessar a página do Issue Tracker vinculado desse grupo de erros. Se você precisar remover um link do Issue Tracker, faça isso na página de detalhes do erro.
- Atualizar automaticamente: atualiza a lista a cada 10 segundos.