Error Reporting aggrega gli eventi di errore generati nei servizi cloud in esecuzione. Un evento di errore rappresenta una singola occorrenza di un errore nella tua applicazione. I dati memorizzati per ogni evento includono informazioni sull'errore, ad esempio l'ora in cui si è verificato, il contesto in cui si è verificato e il messaggio di errore restituito.
Gli eventi di errore vengono segnalati dall'API Error Reporting o vengono dedotti da Error Reporting quando esamina le voci di log alla ricerca di pattern di testo comuni, come le analisi dello stack. Error Reporting raggruppa gli eventi di errore che sono considerati avere la stessa causa principale.
Error Reporting è abilitato automaticamente.
Esempi di Error Reporting fino a 1000 errori all'ora. Quando viene raggiunto questo limite, i conteggi visualizzati sono stimati. Se vengono ricevuti troppi eventi, Error Reporting esegue il campionamento fino a 100 errori all'ora e continua a estrapolare i conteggi.
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 workload Assured Workloads sono disabilitati. Per saperne di più, consulta la panoramica di Assured Workloads.
- Le chiavi di crittografia gestite dal cliente (CMEK) sono disattivate 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, vedi Verifica dell'attivazione della chiave.
- Il bucket di log soddisfa una delle seguenti condizioni:
- Il bucket di log viene archiviato nello stesso progetto in cui hanno avuto origine 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à.
Modalità di raggruppamento degli eventi di errore
Quando Error Reporting valuta le voci di log per identificare gli eventi di errore, ignora le voci di log con le seguenti condizioni:
- Voci di log scritte dall'ambiente standard App Engine con un
livello di gravità inferiore a
ERROR. - Frame dello stack che non sono di proprietà dell'utente (ad esempio quelli che appartengono a librerie pubbliche).
Quando viene analizzata una voce di log, Error Reporting esegue 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 di Java: java.util.concurrent.CancellationException |
Raggruppato per tipo di eccezione. |
| Eventi di errore con una traccia dello stack. Nel caso di eccezioni
nidificate, viene presa in considerazione l'eccezione più interna.
Ad esempio: runtime error: index out of range
package1.func1()
file1:20
package2.func2()
file2:33 |
Raggruppati per tipo di eccezione e i 5 frame più in alto. |
| Eventi di errore senza analisi dello stack, ma con un messaggio.
Ad esempio: runtime error: index out of range
func1() |
Raggruppamento per messaggio e (se presente) nome della funzione. Vengono presi in considerazione solo i primi tre token letterali del messaggio. Nell'esempio a sinistra, questi
sono runtime, error e index. |
Area geografica dati
Se configuri Assured Workloads per i requisiti di residenza dei dati o livello di impatto 4 (IL4), Google Cloud Error Reporting viene disattivato automaticamente.
In Cloud Logging puoi regionalizzare i log indirizzandoli a una posizione 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-central-1 contiene solo log di errori
che fanno parte di un bucket di log in us-central-1. I gruppi di errori globali contengono
solo i log degli 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. Questo menu ha un valore predefinito di
global.
