Error Reporting aggrega e raggruppa gli eventi di errore dell'applicazione in base alla causa principale, aiutandoti a identificare, dare la priorità e risolvere i problemi nei tuoi servizi cloud. Un evento di errore rappresenta una singola occorrenza di un errore dell'applicazione e acquisisce il timestamp, il contesto di esecuzione e il messaggio di errore.
Error Reporting è abilitato automaticamente e inizia a rilevare gli errori senza richiedere una configurazione manuale. Raccoglie gli eventi di errore direttamente da API Error Reporting o li deduce scansionando le voci di log alla ricerca di analisi dello stack e pattern di errore comuni.
Per ottimizzare il rendimento, Error Reporting campiona fino a 1000 errori all'ora, stimando i conteggi quando raggiunge questa soglia. Se il volume degli eventi supera la capacità, Error Reporting campiona fino a 100 errori all'ora e continua a estrapolare i conteggi visualizzati.
Quando Error Reporting analizza le voci di log
Error Reporting è un servizio globale basato su Cloud Logging e può analizzare le voci di log quando sono vere tutte le seguenti condizioni:
- I carichi di lavoro Assured sono disabilitati. Per ulteriori informazioni, consulta la panoramica di Assured Workloads.
- Le chiavi di crittografia gestite dal cliente (CMEK) sono disabilitate in tutti i bucket di log che archiviano la voce di log. Error Reporting non può archiviare le voci di log nei bucket di log in cui è abilitata CMEK. Per informazioni su come determinare la configurazione CMEK per un bucket di log, consulta Verificare l'abilitazione della chiave.
- Il bucket di log soddisfa una delle seguenti condizioni:
- Il bucket di log è archiviato nello stesso progetto in cui sono state create le voci di log.
- Le voci di log sono state instradate a un progetto, che le ha archiviate in un bucket di log di sua proprietà.
Come vengono raggruppati gli eventi di errore
Quando Error Reporting valuta le voci di log per identificare gli eventi di errore, ignora i seguenti dati:
- Voci di log scritte dall'ambiente standard di App Engine con un livello di gravità inferiore a
ERROR. - Frame dello stack che non sono di proprietà dell'utente, ad esempio quelli appartenenti a librerie pubbliche.
Quando viene scansionata una voce di log, Error Reporting apporta le seguenti modifiche prima di dedurre gli eventi di errore:
- Sostituisce qualsiasi sequenza ripetuta di uno o più frame dello stack con una singola occorrenza della sequenza.
- Rimuove i metodi e i simboli introdotti dal compilatore.
Error Reporting applica queste regole, nell'ordine specificato, per raggruppare gli eventi di errore:
| Evento di errore | Raggruppato per |
|---|---|
| Eventi di errore causati da un problema generale nell'ambiente.
Ad esempio, problemi specifici di App Engine: com.google.apphosting.runtime.HardDeadlineExceededError com.google.appengine.api.datastore.DatastoreTimeoutException Problemi Java: java.util.concurrent.CancellationException |
Raggruppato per tipo di eccezione. |
| Eventi di errore con un'analisi dello stack. Nel caso di eccezioni nidificate
viene considerata l'eccezione più interna.
Ad esempio: runtime error: index out of range
package1.func1()
file1:20
package2.func2()
file2:33 |
Raggruppato per tipo di eccezione e i cinque frame principali. |
| Eventi di errore senza analisi dello stack, ma con un messaggio.
Ad esempio: runtime error: index out of range
func1()In questo esempio, vengono considerati i seguenti token:
|
Raggruppato per messaggio e (se presente) nome della funzione. Vengono considerati solo i primi tre token letterali del messaggio. |
Area geografica dati
Se configuri Assured Workloads per i requisiti di residenza dei dati o Impact Level 4 (IL4) requirements, then Google Cloud Error Reporting viene disabilitato automaticamente.
In Cloud Logging, puoi regionalizzare i log instradando
li a una località specifica. Nella pagina Gruppi di errori , Error Reporting organizza e mostra i gruppi di errori in base alla regione del bucket di log che contiene le voci di log. Ad esempio, un gruppo di errori elencato in us-central1 contiene solo log di errori che fanno parte di un bucket di log in us-central1. I gruppi di errori globali contengono solo log di errori che fanno parte di un bucket di log nella regione global.
Per filtrare la regione dei gruppi di errori visualizzati nella pagina Gruppi di errori , seleziona un valore dal menu Regione. Il valore predefinito di questo menu è global.
