Vista geral do Error Reporting

Os relatórios de erros agregam os erros produzidos nos seus serviços na nuvem em execução. Estes erros são comunicados pela API Error Reporting ou são inferidos como erros quando o Error Reporting inspeciona as entradas de registo para encontrar padrões de texto comuns, como rastreios de pilha. Os relatórios de erros agrupam os erros que se considera terem a mesma causa principal.

Os relatórios de erros estão ativados automaticamente.

O Relatório de erros inclui amostras de até 1000 erros por hora. Quando este limite é atingido, as contagens apresentadas são estimadas. Se forem recebidos demasiados eventos, o Relatório de erros cria amostras de até 100 erros por hora e continua a extrapolar as contagens.

Quando o Relatório de erros analisa as entradas do registo

Os Relatórios de erros são um serviço global criado no Cloud Logging e podem analisar entradas de registo quando todas as seguintes condições são verdadeiras:

  • Os Assured Workloads estão desativados. Para mais informações, consulte o artigo Vista geral dos Assured Workloads.
  • As chaves de encriptação geridas pelo cliente (CMEK) estão desativadas em todos os contentores de registos que armazenam a entrada de registo. Os relatórios de erros não podem armazenar entradas de registo em contentores de registos com a CMEK ativada. Para obter informações sobre como determinar a configuração da CMEK para um contentor de registos, consulte Verifique a ativação da chave.
  • O contentor de registos cumpre um dos seguintes requisitos:
    • O contentor de registos é armazenado no mesmo projeto onde as entradas de registo tiveram origem.
    • As entradas de registo foram encaminhadas para um projeto e, em seguida, esse projeto armazenou essas entradas de registo num contentor de registos que lhe pertence.

Como são agrupados os erros

Quando os relatórios de erros avaliam as entradas de registo, ignoram as entradas de registo com as seguintes condições:

  • No ambiente padrão do App Engine, os erros registados com uma gravidade inferior a ERROR são ignorados.
  • Os frames de pilha que não são propriedade do utilizador são ignorados (por exemplo, os que pertencem a bibliotecas públicas).
  • Qualquer sequência repetida de um ou mais frames de pilha é substituída por uma única ocorrência dessa sequência.
  • Os métodos e os símbolos introduzidos pelo compilador são removidos.

Em seguida, os relatórios de erros seguem estas regras para agrupar erros:

  • As exceções são agrupadas se tiverem o mesmo tipo de exceção e stacks semelhantes.
  • O rastreio de pilha é ignorado para exceções que normalmente não estão relacionadas com a localização de origem onde ocorrem.
  • Os erros sem uma pilha de exceções são agrupados se tiverem sido criados pela mesma entrada de registo, aproximada pela localização de origem a partir da qual foram comunicados (reportLocation).

Em concreto, as seguintes regras de agrupamento são aplicadas por esta 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 de Java:

java.util.concurrent.CancellationException
 Agrupado por tipo de exceção.
Erros com um rastreio de pilha. No caso de exceções aninhadas, é considerada a exceção mais interior.

Por exemplo:

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

Por exemplo:

runtime error: index out of range
    func1()
 Agrupadas por mensagem e (se presente) nome da função. Apenas são considerados os primeiros 3 tokens literais da mensagem. No exemplo à esquerda, estes são runtime, error e index.

Regionalidade dos dados

Se configurar os Assured Workloads para requisitos de residência de dados ou Nível de impacto 4 (IL4), o Error Reporting é Google Cloud desativado automaticamente.

No Cloud Logging, pode regionalizar os seus registos encaminhando-os para uma localização específica. Na página Grupos de erros, os relatórios de erros organizam e mostram grupos de erros com base na região do contentor de registos que contém as entradas de registo. Por exemplo, um grupo de erros listado em us-central-1 contém apenas registos de erros que fazem parte de um contentor de registos em us-central-1. Os grupos de erros globais contêm apenas registos de erros que fazem parte de um contentor de registos na região global.

Para filtrar a região dos grupos de erros apresentados na página Grupos de erros, selecione um valor no menu Região. Este menu tem um valor predefinido de global.

O menu Região na página Grupos de erros.

O que se segue?