Neste guia, mostramos como visualizar e filtrar erros com o console do Google Cloud. É possível filtrar, classificar e consultar mais detalhes sobre os 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 um erro ocorreu no período selecionado. Quando você filtra grupos de erros por texto, os gráficos de barras mostram barras cinza para representar o número de erros que não corresponderam ao filtro de texto:
Para informações sobre como o Error Reporting organiza os erros em grupos, consulte Como os erros são agrupados.
Antes de começar
- Certifique-se de ter 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 seu projeto. 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.
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 painel de navegação do console do Google Cloud, selecione Error Reporting e escolha seu projeto do Google Cloud:
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 do erro e informações de diagnóstico de amostras de erros. Se o Gemini estiver ativado no projeto, você poderá usar o Gemini 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 levará você à página Análise de registros.
Na Análise de registros, o painel do editor de consultas é preenchido com um filtro que contém o campo 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 alterar as entradas de registro 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 por recurso do grupo de erros, status e strings de texto.
Filtrar grupos de erros por recurso
Para filtrar grupos de erros por recurso, selecione o menu Todos os recursos e um recurso. Alguns recursos permitem filtrar ainda mais por rótulos de grupo 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 Serviços de contêiner do Kubernetes, 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, em seguida, Aplicar.
Filtrar grupos de erros por status
Para filtrar os erros por status, selecione o menu Aberto, confirmado e, em seguida, os status dos erros. O nome do filtro muda com base nos status selecionados.
Filtrar grupos de erros por texto
Para filtrar erros por texto, digite um valor no campo de texto Filtrar erros. O filtro de texto pode executar 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: ao clicar nesse botão, você pode adicionar um link do Issue Tracker a esse grupo de erros.
- Ver problema: clique nesse botão para acessar a página do Issue Tracker vinculado a esse 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.