Como gerenciar erros

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:

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

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:

  1. Vá para a página Operações > Error Reporting no Console do Cloud:

    Acessar a página do Error Reporting

  2. Para cada grupo de erros, o status de resolução é exibido:

    A interface do usuário mostrando o status da resolução de erro.

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

  1. Clique em Gerenciar erros silenciados:

    A interface do usuário mostrando o menu de erros silenciados.

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

    A interface do usuário mostrando a opção de silenciamento do status da resolução.

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 ao lado de cada linha da lista:

A interface do usuário mostrando o ícone do bug.

Clicar no ícone de relatório do bug 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 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.