Filtrare i log e creare metriche basate su log

Una volta esportati i dati di Crashlytics e (facoltativamente) 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, assicurati di consultare Cosa puoi fare con i tuoi dati? per un elenco completo ed esempi di utilizzo dei dati archiviati in Cloud Logging.

Filtra i log con le query

Il filtro dei log è utile per visualizzare dati specifici e per ridurre i costi di archiviazione e analisi dei dati. Filtri i log utilizzando il linguaggio di query di Logging (LQL).

Per scoprire come filtrare i log con le query, consulta 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 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 di log

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

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

Crea 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 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 conteggiare 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. Controlla i prezzi per le metriche definite dall'utente.

  • Utilizza Cloud Monitoring per registrare il numero di voci di log contenenti messaggi particolari o per 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 dai dati delle sessioni Crashlytics e Firebase esportati:

  • Utilizzando i dati di 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 di Firebase:
    Crea una metrica denominata firebase/session_events con l'etichetta eventType e definiscila come:

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

Passaggi successivi