Filtrare i log e creare metriche basate su log

Una volta esportati i dati di Crashlytics e (facoltativamente) i dati delle sessioni Firebase in Cloud Logging, puoi filtrare i log e creare metriche basate sui log. Entrambi sono utili per visualizzare, utilizzare e analizzare dati specifici.

Se non l'hai ancora fatto, consulta Cosa puoi fare con i tuoi dati? per un elenco completo ed esempi di utilizzo dei dati memorizzati in Cloud Logging.

Filtrare i log con le query

Il filtraggio dei log è utile per visualizzare dati specifici e per ridurre i costi di archiviazione e analisi. Filtri i log utilizzando LQL (Logging Query Language).

Per scoprire come filtrare i log con le query, visita Query di esempio che utilizzano Logs Explorer e Creazione di query di log. La tabella seguente descrive i campi disponibili per queste query.

Filtri di esempio

Per Crashlytics, ecco alcuni filtri iniziali di esempio per una query:

  • Trova tutti gli arresti anomali irreversibili per una versione specifica dell'app:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.issue.errorType="FATAL"
jsonPayload.version.displayVersion="3.2.0"

  • Identifica gli arresti anomali che si verificano su un modello di dispositivo specifico (ad esempio Pixel 6a):

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.device.model="Pixel 6a"

  • Cerca un OutOfMemoryError specifico in tutti gli eventi fatali:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.issue.errorType="FATAL"
jsonPayload.issue.subtitle="java.lang.OutOfMemoryError"

  • Trovare gli eventi per un ID problema Crashlytics specifico:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.issue.id="ISSUE_ID"

Schema di log

Ogni voce di log ha una struttura predefinita e campi interrogabili (vedi LogEntry).

Scopri di più sullo schema dei log per i dati esportati, inclusi i dati Crashlytics, i dati delle sessioni Firebase e i log dei dispositivi.

Creare metriche basate su log

Puoi visualizzare e creare metriche basate sui log, e poi utilizzarle in Cloud Monitoring per creare grafici, dashboard personalizzate e avvisi personalizzati.

  • Utilizza le metriche di sistema predefinite che vengono registrate automaticamente, ad esempio il numero di eventi di logging che si sono verificati in un periodo di tempo specifico.

  • Crea metriche definite dall'utente per il tuo progetto. Puoi contare il numero di voci di log che corrispondono a una determinata query o tenere traccia di valori particolari con le voci di log corrispondenti. Puoi filtrare utilizzando le espressioni regolari. Assicurati di esaminare i prezzi delle metriche definite dall'utente.

  • Utilizza Cloud Monitoring per registrare il numero di voci di log contenenti messaggi particolari o estrarre le informazioni sulla latenza riportate nelle voci di log. Puoi quindi utilizzare queste metriche in grafici e avvisi personalizzati.

Esempi di metriche basate su log

Ecco due esempi di metriche basate su log definite dall'utente che potresti creare a partire dai dati sulle sessioni di Crashlytics e Firebase esportati:

  • Utilizzando i dati Crashlytics:
    crea una metrica denominata firebase/crashlytics_events con un'etichetta errorType e definiscila come:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • Utilizzando i dati delle sessioni Firebase:
    Crea una metrica denominata firebase/session_events con un'etichetta eventType, e definiscila come:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

Passaggi successivi