Ver e filtrar erros

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:

A interface do usuário mostrando a lista de erros filtrados.

Para informações sobre como o Error Reporting organiza os erros em grupos, consulte Como os erros são agrupados.

Antes de começar

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:

  1. No Console do Google Cloud, selecione Error Reporting ou clique no botão a seguir e selecione um projeto:

    Acessar o Error Reporting

  2. 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:

    A interface do usuário mostrando a visualização de detalhes do erro.

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:

A interface do usuário mostrando o filtro do 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:

Menu de filtro de recursos do Error Reporting mostrando os filtros de rótulos do grupo de erros disponíveis para o recurso Kubernetes Container Services.

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.

A interface do usuário mostrando opções de visualização do ícone do bug.

  • 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.

A interface do usuário mostrando opções de visualização do ícone do bug.

  • Atualizar automaticamente: atualiza a lista a cada 10 segundos.

A seguir