Neste guia, mostramos como visualizar e filtrar erros com o console do Google Cloud. É possível filtrar, classificar e conferir mais detalhes sobre erros, bem como restringir erros a um intervalo de tempo específico.
A página Relatórios de erros mostra uma lista de grupos de erros que correspondem ao filtro atual. Cada linha mostra informações como o status de 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 cinzas para representar o número de erros que não correspondem ao filtro de texto:
Para informações sobre como o Error Reporting organiza 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 de relatórios de erros (
roles/errorreporting.viewer) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.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 stacktrace.
Para conferir 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 mostra informações sobre o grupo, incluindo o histórico de um erro, instâncias específicas de erros 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 conferir a entrada de registro associada a um exemplo de erro, clique em Acessar registros em qualquer entrada no painel Amostras recentes. Isso leva você à página Explorador de registros.
No Explorador de registros, o painel do editor de consultas é 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, o Logs Explorer 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 mudar quais entradas de registro
são mostradas. 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 acessar esses registros, consulte Como usar o Explorador de registros.
Filtrar grupos de erros
É possível usar os filtros na barra de ferramentas de Error Reporting para filtrar por status, recursos afetados e a região dos buckets de registro que armazenam as entradas de registro.
Filtrar grupos de erros por recurso
Para filtrar grupos de erros por recurso, selecione o menu Todos os recursos e, em seguida, selecione 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, poderá filtrar primeiro por serviço e depois por versão:
Para salvar suas seleções, 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 texto
Para filtrar erros por texto, insira um valor no campo de texto Filtrar erros. O filtro de texto pode fazer uma correspondência de texto em qualquer um dos seguintes campos:
- Informações do erro
- Código de resposta HTTP
- Pilha de exceções
- URL de solicitação
- Local do relatório
- Método HTTP