Panoramica di Error Reporting

Error Reporting ti consente di identificare, assegnare la priorità e classificare i problemi nei tuoi servizi cloud aggregando gli eventi di errore dell'applicazione in base alla causa principale. Un evento di errore rappresenta un singolo errore dell'applicazione, acquisendo il timestamp, il contesto di esecuzione e il messaggio. Error Reporting raccoglie gli eventi direttamente dall'API Error Reporting o li deduce analizzando le voci di log per individuare stack trace 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 di 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:

  • Assured Workloads è disabilitato. Per saperne di più, consulta 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ò memorizzare 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'attivazione della chiave.
  • Il bucket di log soddisfa una delle seguenti condizioni:
    • Il bucket di log è 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 i seguenti dati:

  • 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 una voce di log viene analizzata, 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 un'analisi 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 cinque frame più in alto.
Eventi di errore senza analisi dello stack, ma con un messaggio.

Ad esempio:

runtime error: index out of range
    func1()

In questo esempio, vengono presi in considerazione i seguenti token: runtime, error e index.

 Raggruppamento per messaggio e (se presente) nome della funzione. Vengono presi in considerazione solo i primi tre token letterali del messaggio.

Area geografica dati

Se configuri Assured Workloads per la residenza dei dati o i requisiti di 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-central1 contiene solo log di errori che fanno parte di un bucket di log in us-central1. 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.

Il menu Regione nella pagina Gruppi di errori.

Passaggi successivi