Os relatórios de erros agregam eventos de erro produzidos nos seus serviços na nuvem em execução. Um evento de erro representa uma única ocorrência de um erro na sua aplicação. Os dados armazenados para cada evento incluem informações sobre o erro, como a hora em que ocorreu, o contexto em que ocorreu e a mensagem de erro devolvida.
Os eventos de erro são comunicados pela API Error Reporting ou são inferidos pelo Error Reporting quando inspeciona as entradas de registo para padrões de texto comuns, como rastreios de pilha. Os relatórios de erros agrupam eventos de erro 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 faz uma amostragem de até 100 erros por hora e continua a extrapolar as contagens.
Quando o Relatório de erros analisa as entradas do registo
O Relatório de erros é um serviço global criado no Cloud Logging e pode 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 das 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 eventos de erros
Quando os Relatórios de erros avaliam as entradas do registo para identificar eventos de erro, ignoram as entradas do registo com as seguintes condições:
- Entradas de registo escritas pelo ambiente padrão do App Engine que têm um nível de gravidade inferior a
ERROR. - Frames de pilha que não são propriedade do utilizador (por exemplo, os que pertencem a bibliotecas públicas).
Quando uma entrada de registo é analisada, o Error Reporting faz as seguintes modificações antes de inferir eventos de erro:
- Substitui qualquer sequência repetida de um ou mais frames da pilha por uma única ocorrência dessa sequência.
- Remove métodos e símbolos introduzidos pelo compilador.
Os relatórios de erros aplicam estas regras, pela ordem especificada, para agrupar eventos de erro:
| Evento de erro | Agrupados por |
|---|---|
| Eventos de erro 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. |
| Eventos de erro com um rastreio da 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. |
| Eventos de erro sem um rastreio da 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.
