Nesta página, você saberá como gerenciar seus erros no Error Reporting.
Para visualizar seus erros, abra a página Error Reporting no Console do Cloud. Será exibida uma lista dos grupos de erros que ocorreram recentemente, em ordem de frequência:
Dica: trate essa lista como uma caixa de entrada de e-mail. Corrija os erros subjacentes e/ou silencie aqueles esperados ou recorrentes para mantê-la limpa e funcional.
Para mais informações sobre visualização e filtragem na lista do Error Reporting, acesse Como visualizar erros.
Para mais informações sobre as permissões necessárias para gerenciar seus erros, consulte o guia de controle de acesso.
Amostras de erros
Os erros agrupados geralmente são muito semelhantes. Por essa razão, o Error Reporting mantém apenas 1.000 amostras e extrapola as informações restantes. Para manter todas as ocorrências de um erro, avalie a possibilidade de exportar seus registros para o BigQuery para que as futuras ocorrências do erro sejam salvas.
Para cada amostra, a IU mostra os dados que seu aplicativo envia ao Error Reporting. Por exemplo, o ambiente padrão do App Engine fornece metadados úteis, como o user agent e o URL da solicitação que levou ao erro. Se você estiver enviando seus próprios relatórios de erros como entradas de registro, verifique a lista de campos que pode fornecer. Se estiver usando a API Error Reporting, consulte o objeto ReportedErrorEvent
.
Para mais informações, acesse Como os erros são agrupados (em inglês).
Como alterar o status da resolução
Para gerenciar seu fluxo de trabalho, altere o status da resolução dos grupos de erros fazendo o seguinte:
Vá para a página Operações > Error Reporting no Console do Cloud:
Para cada grupo de erros, o status de resolução é exibido:
No painel anterior, expanda a coluna Status da resolução para alterar o status de um grupo de erros. Os possíveis valores de status são os mostrados a seguir:
- Aberto: o estado inicial padrão de todos os grupos de erros. Os outros estados são definidos manualmente. É possível reverter o status de um grupo de erros para Aberto a qualquer momento.
- Reconhecido: um estado para a triagem de grupos de erros.
- Resolvido: um estado para indicar que um grupo de erros está corrigido e não se espera que ocorra novamente. Se um grupo de erros marcado como Resolvido for reativado posteriormente, o Error Reporting altera o status da resolução para Aberto novamente.
- Silenciado: um estado para ocultar um grupo de erros da sua lista. Para mais informações, consulte Como silenciar erros.
Como silenciar erros
É possível ocultar um grupo de erros da sua lista do Error Reporting alterando o status de resolução para Silenciado. Os erros silenciados não reaparecerão na sua lista, mesmo se ocorrerem outras vezes.
Para exibir seus grupos de erros silenciados (e cancelar o silenciamento, se você quiser), faça o seguinte:
Clique em Gerenciar erros silenciados:
A página Erros silenciados é exibida. Na barra de navegação superior, expanda o painel de Status da resolução. Selecione os tipos de status da resolução dos grupos de erros que você quer esconder da sua lista.
Cancele o silenciamento de um grupo de erros desmarcando o tipo de status da resolução no mesmo painel Status da resolução.
O Error Reporting não enviará notificações se o erro silenciado voltar a ocorrer.
Como vincular a problemas
Você pode vincular grupos de erros a problemas.
Para visualizar ou alterar um ou mais problemas associados a um grupo de erros, clique no ícone de relatório do bug bug_report ao lado de cada linha da lista:
Clicar no ícone de relatório do bug bug_report abrirá o painel Vincular um URL do problema a este erro, onde você pode digitar o URL adequado. Faça isso se o grupo de erro ainda não estiver associado a um URL do problema.
Se um grupo de erro já estiver associado a um URL no seu sistema de Issue Tracker, clicar no ícone de relatório do bug bug_report abrirá esse link em uma nova guia do navegador.
Notificações
Você será notificado pelo Error Reporting quando ocorrerem novos erros e quando aqueles que foram marcados como Resolvido ocorrerem novamente. Para saber mais, acesse Notificações.
Como excluir erros
É possível excluir todos os eventos de erro armazenados para determinado projeto e redefinir as contagens de erros para zero usando a ferramenta gcloud
ou a API REST.
gcloud
Para excluir todos os eventos de erro:
gcloud beta error-reporting events delete
API REST
Para excluir todos os eventos de erro, use o método projects.deleteEvents da API REST.