Panoramica di Error Reporting

Error Reporting aggrega gli errori prodotti nei servizi cloud in esecuzione. Questi errori vengono segnalati dall'API Error Reporting o vengono dedotti come errori quando Error Reporting controlla le voci di log per individuare pattern di testo comuni come le tracce dello stack. Error Reporting raggruppa gli errori che sono considerati avere la stessa causa principale.

Error Reporting viene attivato automaticamente.

Error Reporting acquisisce fino a 1000 errori all'ora. Quando viene raggiunto questo limite, i conteggi visualizzati sono stimati. Se vengono ricevuti troppi eventi, Error Reporting ne esegue il campionamento fino a 100 all'ora e continua a estrapolare i conteggi.

Quando la segnalazione di errori analizza le voci di log

Error Reporting è un servizio globale basato su Cloud Logging e può analizzare le voci di log quando si verificano tutte le seguenti condizioni:

  • I workload Assured sono disattivati. Per ulteriori informazioni, consulta la Panoramica di Assured Workloads.
  • Le chiavi di crittografia gestite dal cliente (CMEK) sono disattivate in tutti i bucket dei log che memorizzano la voce di log. Per informazioni su come determinare la configurazione CMEK per un bucket di log, consulta Verificare l'attivazione della chiave.
  • Il bucket dei log soddisfa una delle seguenti condizioni:
    • Il bucket dei 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à.
Se archivi le voci di log in bucket di log con la CMEK abilitata, puoi comunque utilizzare Error Reporting. Tuttavia, devi utilizzare le librerie client o l'API Error Reporting. Per saperne di più, consulta la panoramica dell'API Error Reporting e le librerie client Error Reporting.

Modalità di raggruppamento degli errori

Quando la segnalazione di errori valuta le voci di log, ignora le voci di log con le seguenti condizioni:

  • Nell'ambiente standard di App Engine, gli errori registrati con una gravità inferiore a ERROR vengono ignorati.
  • I frame di stack non di proprietà dell'utente vengono ignorati (ad esempio quelli che appartengono alle librerie pubbliche).
  • Qualsiasi sequenza ripetuta di uno o più frame dello stack viene sostituita da una singola occorrenza di quella sequenza.
  • I metodi e i simboli introdotti dal compilatore vengono rimossi.

Successivamente, Error Reporting segue queste regole per raggruppare gli errori:

  • Le eccezioni vengono raggruppate se hanno lo stesso tipo di eccezione e stack simili.
  • L'analisi dello stack viene ignorata per le eccezioni che in genere non sono correlate alla posizione della fonte in cui si verificano.
  • Gli errori senza uno stack di eccezioni vengono raggruppati se sono stati creati dalla stessa voce di log, approssimativamente dalla posizione di origine da cui è stato generato il report (reportLocation).

Nello specifico, le seguenti regole di raggruppamento vengono applicate in questo ordine:

Tipo di errore Raggruppato per
Errori 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.
Errori con una traccia dello stack. In 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
 Raggruppati per tipo di eccezione e per i 5 frame principali.
Errori senza una analisi dello stack, ma con un messaggio.

Ad esempio:

runtime error: index out of range
    func1()
 Raggruppati per messaggio e (se presente) nome della funzione. Vengono presi in considerazione solo i primi 3 token literal del messaggio. Nell'esempio a sinistra, si tratta di runtime, error e index.

Area geografica dati

Se configuri Assured Workloads per i requisiti di residenza dei dati o di Impact Level 4 (IL4), Google Cloud disattiva automaticamente Error Reporting.

In Cloud Logging, puoi regionalizzare i log indirizzandoli a una località specifica. Nella pagina Gruppi di errori, Error Reporting organizza e mostra i gruppi di errori in base alla regione del bucket dei log che contiene le voci del log. Ad esempio, un gruppo di errori elencato in us-central-1 contiene solo log di errore che fanno parte di un bucket dei 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. Il valore predefinito di questo menu è global.

Il menu Regione nella pagina Gruppi di errori.

Passaggi successivi