Como os erros são agrupados

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O Error Reporting agrega erros produzidos nos serviços executados na nuvem. Esses erros são relatados pela API Error Reporting ou inferidos como erros quando o Error Reporting inspeciona entradas de registro em busca de padrões comuns de texto, como stack traces. O Error Reporting agrupa os erros que são considerados como tendo a mesma causa raiz.

Como os erros são agrupados

Quando o Error Reporting avalia as entradas de registro, ele ignora as entradas de registro com as seguintes condições:

  • No ambiente padrão do App Engine, os erros registrados com gravidade menor que ERROR são ignorados.
  • Os frames de pilha que não pertencem ao usuário são ignorados (aqueles que pertencem às bibliotecas públicas, por exemplo).
  • Todas as sequências repetidas de um ou mais frames de pilha são substituídas por uma ocorrência única daquela sequência.
  • Métodos introduzidos por compilador e símbolos são removidos.

Em seguida, o Error Reporting segue esses padrões gerais para agrupar erros:

  • As exceções são agrupadas se tiverem o mesmo tipo e pilhas semelhantes.
  • O rastreamento de pilha é ignorado para exceções que geralmente não estão relacionadas ao local de origem onde elas ocorrem.
  • Os erros sem uma pilha de exceção são agrupados se foram criados pela mesma entrada de registro, aproximado pelo local de origem de onde foram informados (reportLocation).

As seguintes regras de agrupamento são aplicadas, especificamente, nesta ordem:

Tipo de erro Agrupados por
Erros causados por um problema geral no ambiente.

Por exemplo, problemas específicos do App Engine:


com.google.apphosting.runtime.HardDeadlineExceededError

com.google.appengine.api.datastore.DatastoreTimeoutException

Problemas do Java:


java.util.concurrent.CancellationException
Agrupados por tipo de exceção.
Erros com um rastreamento de pilha. No caso de exceções aninhadas, é considerada aquela mais interna.

Exemplo:


runtime error: index out of range
package1.func1()
      file1:20
package2.func2()
      file2:33
Agrupados por tipo de exceção e pelos cinco frames principais.
Erros sem um stack trace, mas com uma mensagem.

Exemplo:


runtime error: index out of range
    func1()
Agrupados por mensagem e, se presente, pelo nome da função. Apenas os três primeiros tokens principais da mensagem são considerados. No exemplo à esquerda, eles são runtime, error e index.

Encontrar grupos de erros no Explorador de registros

O Explorador de registros registra entradas de registros que fazem parte de um grupo de erros. Para mais informações, consulte Encontrar entradas de registros com grupos de erros.