Neste guia, mostramos como visualizar e filtrar erros com o Console do Google Cloud. É possível filtrar, classificar e visualizar detalhes adicionais sobre erros, bem como restringir erros 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 exibem 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
- 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 que conceda a você o papel do IAM Visualizador do Error Reporting (
roles/errorreporting.viewer) no 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 outros papéis predefinidos.
Acessar detalhes do erro
Os detalhes de um grupo de erros incluem o histórico de erros, o status da 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, selecione Error Reporting ou clique no botão a seguir e selecione um projeto:
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 Duet AI estiver ativado no projeto, será possível usar o Duet AI para receber sugestões de solução de problemas.
A captura de tela a seguir mostra uma página Detalhes do grupo de erros:
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. Isso levará você ao Explorador de registros.
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 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 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 visualizar esses registros, consulte Como usar o Explorador de registros.
Filtrar grupos de erros
Para filtrar e restringir os tipos de grupos de erros que aparecem na lista na página Error Reporting, use os menus de filtro. É possível filtrar pelo recurso do grupo de erros, pelo status e pelas strings de texto.
Filtrar grupos de erros por recurso
Para filtrar grupos de erros por recurso, selecione o menu Todos os recursos e escolha um recurso. Alguns recursos permitem filtrar por rótulos do 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, em seguida, selecione Aplicar.
Filtrar grupos de erros por status
Para filtrar erros por status, selecione o menu Abrir e reconhecer e escolha os status. 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 de texto 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:
- Vincular ao problema: clicar neste botão permite adicionar um link do Issue Tracker a esse grupo de erros.
- Ver problema: clique neste botão para acessar a página do rastreador de problemas vinculado 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.