Neste guia, mostramos como visualizar e filtrar erros com o console do Google Cloud. É possível filtrar, classificar e visualizar mais detalhes sobre erros, além de restringi-los a um período específico.
A página Error Reporting exibe uma lista de grupos de erros que correspondem ao filtro atual. Cada linha mostra informações como o status da resolução, o código de resposta e o nome do erro de um grupo de erros. A coluna Ocorrências mostra um gráfico de barras com barras azuis que representam o número de vezes que ocorreu um erro no período selecionado. Quando você filtra grupos de erros por texto, os gráficos de barras mostram barras cinzas para representar o número de erros que não corresponderam ao filtro de texto:
Para mais informações sobre como o Error Reporting organiza os erros em grupos, consulte Como os erros são agrupados.
Antes de começar
- Verifique se você tem pelo menos um grupo de erros. Para mais informações, consulte Coletar dados de erros usando o Error Reporting.
-
Para receber as permissões necessárias para visualizar e filtrar erros, peça ao administrador para conceder a você o papel do IAM de Leitor do Error Reporting (
roles/errorreporting.viewer) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.
Mostrar detalhes do erro
Os detalhes de um grupo de erros incluem o histórico de erros, o status de resolução, o número de ocorrências e uma lista de erros com carimbo de data/hora. Cada entrada na lista contém um link para registros relevantes e, quando disponível, um stack trace.
Para visualizar os detalhes de um grupo de erros, faça o seguinte:
-
No console do Google Cloud, acesse a página Error Reporting:
Também é possível encontrar essa página usando a barra de pesquisa.
Clique no nome do erro.
A página Detalhes do grupo de erros exibe informações sobre o grupo de erros, incluindo o histórico de um erro, instâncias específicas dele e informações de diagnóstico de amostras de erros. Se o Gemini estiver ativado no projeto, será possível usá-lo para receber sugestões de solução de problemas.
Ver entradas de registro associadas
Para visualizar a entrada de registro associada a um erro de amostra, clique em Ver registros em qualquer entrada no painel Amostras recentes. Isso vai levar você para a página Análise de registros.
Na Análise de registros, o painel do editor de consultas é pré-preenchido com um filtro que contém o campo de ID error_groups. A lista de entradas de registro que contribuem para esse grupo de erros é mostrada no painel Resultados da consulta.
Quando uma entrada de registro faz parte de um grupo de erros, a Análise de registros adiciona o botão do grupo de erros (
) à exibição da entrada de registro. Clique no botão para acessar os detalhes do agrupamento ou para alterar as entradas de registro que são exibidas. Para mais informações, consulte
Encontrar entradas de registro com grupos de erros.
Para mais informações sobre como usar o console do Google Cloud para visualizar esses registros, consulte Como usar a Análise de registros.
Filtrar grupos de erros
Use os menus de filtro para filtrar e restringir os tipos de grupos de erros que aparecem na lista de grupos de erros da página Error Reporting. É possível filtrar pelo recurso, status e strings de texto do grupo de erros.
Filtrar grupos de erros por recurso
Para filtrar grupos de erros por recurso, selecione o menu Todos os recursos e escolha um deles. Alguns recursos permitem filtrar ainda mais por rótulos de grupos de erros. O tipo e o número de rótulos de grupo de erros disponíveis variam de acordo com o recurso. Por exemplo, se você tiver grupos de erros para o recurso Kubernetes Container Services, filtre primeiro por serviço e depois por versão:
Para salvar as opções selecionadas, clique em Aplicar.
Para limpar os filtros de recursos e redefinir a lista de grupos de erros filtrados, selecione Redefinir e Aplicar.
Filtrar grupos de erros por status
Para filtrar erros por status de erro, selecione o menu Aberto, confirmado e selecione os status de erro. O nome do filtro muda com base nos status selecionados.
Filtrar grupos de erros por texto
Para filtrar erros por texto, insira um valor no campo Filtrar erros. O filtro de texto pode realizar uma correspondência de texto em qualquer um dos seguintes campos:
- Informações do erro
- Código de resposta HTTP
- Pilha de exceções
- Request URL
- Local do relatório
- Método HTTP
Classificar erros
Além da filtragem, é possível classificar os grupos de erros usando qualquer um dos seguintes cabeçalhos:
- 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.
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 a esse grupo de erros.
- Conferir o problema: clique neste botão para acessar a página do Issue Tracker vinculada a este 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.