Filtrare i log e creare metriche basate su log

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

Se non l'hai ancora fatto, consulta la pagina Cosa puoi fare con i tuoi dati? per un elenco completo ed esempi di utilizzo dei dati archiviati 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 dei dati e di analisi. I log vengono filtrati utilizzando il linguaggio di query di Logging (LQL).

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

Esempi di filtri

Per Crashlytics, ecco alcuni esempi di filtri iniziali 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 irreversibili:

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

  • Trova gli eventi per un ID problema Crashlytics specifico:

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

Schema dei log

Ogni voce di log ha una struttura predefinita e campi su cui è possibile eseguire query (vedi LogEntry).

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

Creare metriche basate su log

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

  • Utilizza metriche di sistema predefinite 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 specifici con le voci di log corrispondenti. Puoi filtrare utilizzando le espressioni regolari. Assicurati di esaminare i prezzi per le metriche definite dall'utente.

  • Utilizza Cloud Monitoring per registrare il numero di voci di log contenenti messaggi specifici 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

Di seguito sono riportati due esempi di metriche basate su log definite dall'utente che potresti creare da dati esportati Crashlytics e delle sessioni Firebase:

  • Utilizzo dei dati Crashlytics:
    Crea una metrica denominata firebase/crashlytics_events con un'etichetta errorType, e definiscila come segue:

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

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

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

Passaggi successivi