Visão geral do Error Reporting

O Error Reporting agrega erros produzidos na nuvem em execução serviços. Esses erros são informados pelo API Error Reporting ou inferidos quando o Error Reporting inspecionar as entradas de registro padrões de texto, como stack traces, Erros de grupos do Error Reporting que têm a mesma causa raiz.

O Cloud Logging ativa automaticamente Error Reporting quando um registro de usuário ingerido corresponde a qualquer um desses desenhos.

Como o Error Reporting é um serviço global, ele só pode analisar que são armazenadas em buckets do Cloud Logging que estão no Região global, em que os projetos do Google Cloud de origem e de destino são os e quando as chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) estão desativadas. Se você rotear registros para outro projeto do Google Cloud, buckets regionalizados ou ativar CMEK, o Error Reporting não captura e analisa esses registros.

O Error Reporting processa até 1.000 erros por hora. Quando esse limite é atingido, as contagens exibidas são estimadas. Se muitos eventos forem recebidos, o Error Reporting coleta amostras de até 100 erros por hora e continuar a extrapolar as contagens.

Como os erros são agrupados

Quando o Error Reporting avalia entradas de registro, ele ignora 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 estes 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 tiverem sido criados por a mesma entrada de registro, aproximada pelo local de origem informado de (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.

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

A seguir