O Error Reporting agrega erros produzidos nos serviços de nuvem em execução. Esses erros são relatados pela API Error Reporting ou são inferidos como erros quando o Error Reporting inspeciona entradas de log em busca de padrões de texto comuns, como rastreamentos de pilha. O Error Reporting agrupa erros que são considerados como tendo a mesma causa raiz.
O Relatório de Erros é ativado automaticamente.
O Error Reporting mostra até 1.000 erros por hora. Quando este limite é atingido, as contagens exibidas são estimadas. Se muitos eventos forem recebidos, o Error Reporting amostrará até 100 erros por hora e continuará a extrapolar as contagens.
Quando o Error Reporting analisa entradas de log
O Error Reporting é um serviço global criado no Cloud Logging e pode analisar entradas de registro quando todas as condições a seguir forem verdadeiras:
- As cargas de trabalho garantidas estão desativadas. Para obter mais informações, consulte Visão geral do Assured Workloads .
- As chaves de criptografia gerenciadas pelo cliente (CMEK) estão desativadas em todos os buckets de registro que armazenam a entrada de registro. Para obter informações sobre como determinar a configuração de CMEK para um bucket de log, consulte Verificar ativação de chave .
- O bucket de log atende a um dos seguintes itens:
- O bucket de log é armazenado no mesmo projeto onde as entradas de log foram originadas.
- As entradas de log foram roteadas para um projeto e, em seguida, esse projeto armazenou essas entradas de log em um bucket de registros de sua propriedade.
Como os erros são agrupados
Quando o Error Reporting avalia entradas de log, ele as ignora com as seguintes condições:
- No ambiente padrão do App Engine, os erros registrados com gravidade inferior a
ERRORsão ignorados. - Stack frames que não pertencem ao usuário são ignorados (por exemplo, aqueles que pertencem a bibliotecas públicas).
- Qualquer sequência repetida de um ou mais quadros de pilha é substituída por uma única ocorrência dessa sequência.
- Os métodos e símbolos introduzidos pelo compilador são removidos.
A seguir, o Error Reporting segue estas regras para agrupar erros:
- As exceções serão agrupadas se tiverem o mesmo tipo de exceção e pilhas semelhantes.
- O rastreamento de pilha é ignorado para exceções que normalmente não estão relacionadas ao local de origem onde ocorrem.
- Erros sem uma pilha de exceções serão agrupados se tiverem sido criados pela mesma entrada de log, aproximada pelo local de origem de onde foi relatado (
reportLocation).
Especificamente, as seguintes regras de agrupamento são aplicadas nesta ordem:
| Tipo de erro | Agrupado por |
|---|---|
| Erros causados por um problema geral no meio ambiente . Por exemplo, problemas específicos do App Engine: com.google.apphosting.runtime.HardDeadlineExceededError com.google.appengine.api.datastore.DatastoreTimeoutException Problemas Java: java.util.concurrent.CancellationException | Agrupados por tipo de exceção. |
| Erros com rastreamento de pilha . No caso de exceções aninhadas, é considerada a exceção 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 5 quadros superiores. |
| Erros sem rastreamento de pilha, mas com mensagem. Por exemplo: runtime error: index out of range
func1() | Agrupados por mensagem e (se presente) nome da função. Apenas os primeiros 3 tokens literais da mensagem são considerados. No exemplo à esquerda, são runtime , error e index . |
Regionalidade dos dados
Se você configurar o Assured Workloads para requisitos de residência de dados ou nível de impacto 4 (IL4) , então Google Cloud desativa automaticamente o Relatório de Erros.
No Cloud Logging, você pode regionalizar seus registros roteando-os para um local específico. Na página Grupos de erros , o Error Reporting organiza e mostra grupos de erros com base na região do bucket de log que contém as entradas de log. Por exemplo, um grupo de erros listado em us-central-1 contém apenas logs de erros que fazem parte de um bucket de log em us-central-1 . Os grupos de erros globais contêm apenas logs de erros que fazem parte de um bucket de logs na região global .
Para filtrar a região dos grupos de erros exibidos na página Grupos de erros , selecione um valor no menu Região . Este menu tem um valor padrão global .
