Questa pagina fornisce lo schema dei log per i dati Crashlytics esportati e i dati delle sessioni Firebase in Cloud Logging.
Schema delle sessioni di Firebase (dispositivi mobili) (se i dati delle sessioni sono abilitati per l'esportazione)
Crashlytics schema (dispositivo mobile)
Event
Il messaggio che descrive un singolo evento Crashlytics.
Rappresentazione JSON
{
"name": string,
"platform": string,
"bundleOrPackage": string,
"eventId": string,
"sessionId": string,
"eventTime": string,
"receivedTime": string,
"issue": {
object (Issue)
},
"issueVariant": {
object (IssueVariant)
},
"device": {
object (Device)
},
"memory": {
object (Memory)
},
"storage": {
object (Storage)
},
"operatingSystem": {
object (OperatingSystem)
},
"browser": {
object (Browser)
},
"version": {
object (Version)
},
"user": {
object (User)
},
"customKeys": {
string: string,
...
},
"installationUuid": string,
"crashlyticsSdkVersion": string,
"appOrientation": string,
"deviceOrientation": string,
"logs": [
{
object (Log)
}
],
"breadcrumbs": [
{
object (Breadcrumb)
}
],
"blameFrame": {
object (Frame)
},
"exceptions": [
{
object (Exception)
}
],
"errors": [
{
object (Error)
}
],
"threads": [
{
object (Thread)
}
],
"processState": string,
"issueTitle": string,
"issueSubtitle": string,
"buildStamp": string,
"routePath": string
}
| Campi | Descrizione |
|---|---|
name |
string
Obbligatorio. Solo output.
Immutabile. Identificatore. Il nome della risorsa dell'evento. Formato:
|
platform |
string
ANDROID, IOS o WEB. |
bundleOrPackage |
string
Il nome del bundle per le app per iOS o il nome del pacchetto delle app per Android.
Formato: |
eventId |
string
Solo output. Immutabile. L'identificatore univoco dell'evento viene assegnato durante l'elaborazione. |
sessionId |
string
Identificatore univoco della sessione Firebase. |
eventTime |
string (Timestamp format)
Timestamp del dispositivo in cui è stato registrato l'evento. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30". |
receivedTime |
string (Timestamp format)
Timestamp del server in cui l'evento è stato ricevuto da Crashlytics. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30". |
state_update_time |
string (Timestamp format)
L'ora dell'ultima modifica dello stato del problema. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30". |
first_seen_version |
string
La prima versione display_version dell'app in cui è stato rilevato questo problema, compilata solo per i problemi relativi ai dispositivi mobili. |
last_seen_version |
string
La versione display_version dell'app più recente in cui è stato rilevato questo problema, compilata solo per i problemi relativi ai dispositivi mobili. |
first_time_seen |
string (Timestamp format)
La prima volta che è stato rilevato questo problema. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30". |
last_time_seen |
string (Timestamp format)
L'ultima volta che è stato rilevato il problema. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30". |
issue |
object (Issue)
Dettagli del [Problema] assegnato a questo [Evento]. |
issueVariant |
object (IssueVariant)
Dettagli per l'[IssueVariant] assegnata a questo [Event]. |
device |
object (Device)
Metadati dei dispositivi mobili. |
memory |
object (Memory)
Memoria utilizzata dal dispositivo mobile. |
storage |
object (Storage)
Utilizzo del disco/della memoria flash del dispositivo mobile. |
operatingSystem |
object (OperatingSystem)
Sistema operativo e versione. |
browser |
object (Browser)
Browser e versione. |
version |
object (Version)
Versione dell'applicazione mobile. |
user |
object (User)
Identificatori dell'utente finale per il proprietario del dispositivo. |
customKeys |
map (key: string, value: string)
Chiavi personalizzate impostate dallo sviluppatore durante la sessione. Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }. |
installationUuid |
string
Identificatore univoco dell'installazione dell'app del dispositivo. Questo campo viene utilizzato per calcolare il numero univoco di utenti interessati. |
crashlyticsSdkVersion |
string
Versione dell'SDK Crashlytics. |
appOrientation |
string
Orientamento dell'app al momento dell'arresto anomalo (verticale o orizzontale). |
deviceOrientation |
string
Orientamento del dispositivo al momento dell'arresto anomalo (verticale o orizzontale). |
logs[] |
object (Log)
Messaggi di log registrati dallo sviluppatore durante la sessione. |
breadcrumbs[] |
object (Breadcrumb)
Eventi di Analytics registrati dall'SDK Analytics durante la sessione. |
blameFrame |
object (Frame)
Il frame dell'analisi dello stack segnalato dall'elaborazione di Crashlytics. Potrebbe non essere presente nell'analizzatore futuro. |
exceptions[] |
object (Exception)
Solo su Android e sul web. Eccezioni che si sono verificate durante questo evento. Le eccezioni nidificate vengono presentate in ordine cronologico inverso, in modo che l'ultimo record sia la prima eccezione generata. |
errors[] |
object (Error)
Solo Apple. Un errore non irreversibile acquisito dall'SDK per iOS e la relativa analisi dello stack. |
threads[] |
object (Thread)
Thread dell'applicazione presenti al momento della registrazione dell'evento. Ognuno contiene un'analisi dello stack. Un thread verrà considerato responsabile dell'errore. |
processState |
string
Lo stato del processo dell'app al momento dell'evento. |
issueTitle |
string
Il titolo del problema in cui è stato raggruppato l'evento. In genere si tratta di un file di origine o di un nome di metodo. |
issueSubtitle |
string
Il sottotitolo del problema in cui è stato raggruppato l'evento. In genere si tratta di un simbolo o di un messaggio di eccezione. |
buildStamp |
string
Metadati forniti dal sistema di build dell'app, incluse le informazioni sul repository del controllo della versione. |
routePath |
string
Solo sul web. Il percorso della route dell'applicazione web quando si è verificato l'evento, esclusi i parametri di query e il frammento. |
Memory
Memoria utilizzata dal dispositivo mobile.
Rappresentazione JSON
{
"used": string,
"free": string
}
| Campi | Descrizione |
|---|---|
used |
string (int64 format)
Byte in uso. |
free |
string (int64 format)
Byte disponibili. |
Storage
Utilizzo del disco/della memoria flash del dispositivo mobile. Non segnalato per tutti i dispositivi.
Rappresentazione JSON
{
"used": string,
"free": string
}
| Campi | Descrizione |
|---|---|
used |
string (int64 format)
Byte utilizzati. |
free |
string (int64 format)
Byte disponibili. |
User
Identificatori degli utenti finali forniti dallo sviluppatore.
Rappresentazione JSON
{
"id": string
}
| Campi | Descrizione |
|---|---|
id |
string
ID utente, se fornito dallo sviluppatore di app. |
Frame
Un frame in un'analisi dello stack.
Rappresentazione JSON
{
"line": string,
"file": string,
"symbol": string,
"offset": string,
"address": string,
"library": string,
"owner": string,
"blamed": boolean
}
| Campi | Descrizione |
|---|---|
line |
string (int64 format)
Il numero di riga nel file del frame. |
file |
string
Il nome del file di origine in cui si trova il frame. |
symbol |
string
Il simbolo del frame dopo la deoffuscazione o la simbolizzazione. Il simbolo non elaborato del dispositivo se non è stato possibile idratarlo. |
offset |
string (int64 format)
L'offset di byte nell'immagine binaria che contiene il codice. Presente per i frame nativi. |
address |
string (int64 format)
L'indirizzo nell'immagine binaria che contiene il codice. Presente per i frame nativi. |
library |
string
Il nome visualizzato della libreria che include il frame. |
owner |
string
Uno tra DEVELOPER, VENDOR, RUNTIME, PLATFORM o SYSTEM. |
blamed |
boolean
True quando l'analisi di Crashlytics ha stabilito che questo frame è probabilmente la causa dell'errore. |
Exception
Un'eccezione Java o Javascript e la relativa analisi dello stack. Solo da app web e Android.
Rappresentazione JSON
{
"type": string,
"exceptionMessage": string,
"nested": boolean,
"title": string,
"subtitle": string,
"blamed": boolean,
"frames": [
{
object (Frame)
}
]
}
| Campi | Descrizione |
|---|---|
type |
string
Il tipo di eccezione, ad esempio java.lang.IllegalStateException. |
exceptionMessage |
string
Un messaggio associato all'eccezione. |
nested |
boolean
True per tutte le eccezioni tranne l'ultima generata (ovvero il primo record). |
title |
string
Il titolo dell'eccezione. |
subtitle |
string
Il sottotitolo dell'eccezione. |
blamed |
boolean
True quando l'analisi di Crashlytics ha stabilito che l'errore si è verificato in questo thread. |
frames[] |
object (Frame)
I frame nell'analisi dello stack dell'eccezione. |
Error
Un errore non irreversibile e la relativa analisi dello stack, solo dalle app Apple.
Rappresentazione JSON
{
"queue": string,
"code": string,
"title": string,
"subtitle": string,
"blamed": boolean,
"frames": [
{
object (Frame)
}
]
}
| Campi | Descrizione |
|---|---|
queue |
string
La coda su cui era in esecuzione il thread. |
code |
string (int64 format)
Codice di errore associato all'NSError personalizzato registrato dell'app. |
title |
string
Il titolo dell'errore. |
subtitle |
string
Il sottotitolo dell'errore. |
blamed |
boolean
True quando l'analisi di Crashlytics ha stabilito che l'errore si è verificato nella traccia dello stack in questo errore. |
frames[] |
object (Frame)
I frame nell'analisi dello stack dell'errore. |
Thread
Un thread dell'applicazione.
JSON representation</code></th>
</tr>
</thead>
<tbody>
<tr>
<td><code>{
"crashed": boolean,
"name": string,
"queue": string,
"signal": string,
"signalCode": string,
"crashAddress": string,
"title": string,
"subtitle": string,
"blamed": boolean,
"frames": [
{
object (Frame)
}
],
"threadId": string,
"sysThreadId": string,
"threadState": enum (State)
}
| Campi | Descrizione |
|---|---|
crashed |
boolean
True quando il thread ha subito un arresto anomalo. |
name |
string
Il nome del thread. |
queue |
string
La coda su cui era in esecuzione il thread. |
signal |
string
Il nome del segnale che ha causato l'arresto anomalo dell'app. Presente solo sui thread nativi che hanno subito un arresto anomalo. |
signalCode |
string
Il codice dell'indicatore che ha causato l'arresto anomalo dell'app. Presente solo sui thread nativi che hanno subito un arresto anomalo. |
crashAddress |
string (int64 format)
L'indirizzo dell'indicatore che ha causato l'arresto anomalo dell'applicazione. Presente solo sui thread nativi che hanno subito un arresto anomalo. |
title |
string
Il titolo del thread. |
subtitle |
string
Il sottotitolo del thread. |
blamed |
boolean
True quando l'analisi di Crashlytics ha stabilito che l'errore si è verificato nella traccia dello stack in questo thread. |
frames[] |
object (Frame)
I frame nell'analisi dello stack del thread. |
threadId |
string (int64 format)
L'ID del thread, disponibile solo per i thread ANR. |
sysThreadId |
string (int64 format)
L'ID di sistema del thread, disponibile solo per i thread ANR. |
threadState |
enum (State)
Solo output. Lo stato del thread al momento dell'errore ANR. |
State
Lo stato di un thread quando si è verificato l'ANR.
| Enum | Descrizione |
|---|---|
STATE_UNSPECIFIED |
Stato del thread non specificato. |
THREAD_STATE_TERMINATED |
Il thread è stato terminato. |
THREAD_STATE_RUNNABLE |
Il thread era eseguibile. |
THREAD_STATE_TIMED_WAITING |
Il thread era in attesa con un timeout. |
THREAD_STATE_BLOCKED |
Il thread è stato bloccato. |
THREAD_STATE_WAITING |
Il thread era in attesa. |
THREAD_STATE_NEW |
Il thread è stato avviato, ma non è stato ancora eseguito nulla. |
THREAD_STATE_NATIVE_RUNNABLE |
Il thread era nativo e non è stato possibile determinare in modo euristico che era in attesa, quindi si presume che sia eseguibile. |
THREAD_STATE_NATIVE_WAITING |
Abbiamo determinato in modo euristico che il thread è in attesa. |
Schema delle sessioni Firebase (dispositivi mobili)
FirebaseSessionEvent
Sessioni registrate dall'SDK Firebase App Quality Sessions.
Rappresentazione JSON
{
"sessionId": string,
"eventType": enum (SessionEventType),
"firstSessionId": string,
"sessionIndex": integer,
"firebaseInstallationId": string,
"eventTime": string,
"version": {
object (Version)
},
"device": {
object (Device)
},
"operatingSystem": {
object (OperatingSystem)
}
}
| Campi | Descrizione |
|---|---|
sessionId |
string
Identificatore univoco della sessione Firebase. |
eventType |
enum (SessionEventType)
Tipo di evento della sessione. Al momento, l'SDK supporta solo gli eventi SESSION_START. |
firstSessionId |
string
L'identificatore della prima sessione dall'ultimo avvio completo. Questo ID e l'ID sessione saranno gli stessi per i lanci delle app. |
sessionIndex |
integer
Indica il numero di sessioni dall'ultimo avvio a freddo. |
firebaseInstallationId |
string
Identifica in modo univoco un dispositivo con app Firebase installate. |
eventTime |
string (Timestamp format)
Il timestamp di inizio dell'evento della sessione. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30". |
version |
object (Version)
Numeri di versione delle applicazioni mobile. |
device |
object (Device)
Metadati dei dispositivi mobili. |
operatingSystem |
object (OperatingSystem)
Sistema operativo e versione. |
SessionEventType
Tipi di SessionEvent registrati.
| Enum | Descrizione |
|---|---|
SESSION_EVENT_TYPE_UNKNOWN |
Sconosciuto. |
SESSION_START |
Sessione dell'applicazione avviata. |
Schema dei log del dispositivo (dispositivi mobili)
DeviceLog
Rappresenta la struttura delle voci deviceLog.
Rappresentazione JSON
{
"eventId": string,
"sessionId": string,
// Union field payload can be only one of the following:
"log": {
object (Log)
},
"breadcrumb": {
object (Breadcrumb)
}
// End of list of possible types for union field payload.
}
| Campi | Descrizione |
|---|---|
eventId |
string
Solo output. Immutabile. L'identificatore dell'evento a cui è associato. |
sessionId |
string
Identificatore univoco della sessione Firebase. |
Campo unione |
|
log |
object (Log)
Log di Crashlytics. |
breadcrumb |
object (Breadcrumb)
Breadcrumb di Crashlytics. |
Log
Righe di log fornite dallo sviluppatore registrate durante la sessione.
Rappresentazione JSON
{
"logTime": string,
"message": string
}
| Campi | Descrizione |
|---|---|
logTime |
string (Timestamp format)
Timestamp del dispositivo quando è stata registrata la riga. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30". |
message |
string
Messaggio di log. |
Breadcrumb
Eventi di Analytics registrati durante la sessione.
Rappresentazione JSON
{
"eventTime": string,
"title": string,
"params": {
string: string,
...
}
}
| Campi | Descrizione |
|---|---|
eventTime |
string (Timestamp format)
Timestamp del dispositivo per l'evento. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30". |
title |
string
Nome dell'evento di analisi. |
params |
map (key: string, value: string)
Parametri evento. Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }. |
Crashlytics schema (web)
Questa sezione descrive lo schema Cloud Logging per gli eventi web Crashlytics esportati.
LogEntry
Il messaggio che descrive un singolo evento web Crashlytics in Cloud Logging
(firebasetelemetry.googleapis.com/events).
Rappresentazione JSON
{
"insertId": "insert_id",
"jsonPayload": {
"exception.stacktrace": "stacktrace",
"exception.message": "test error",
"exception.type": "Error"
},
"httpRequest": {
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36,gzip(gfe)"
},
"resource": {
"type": "firebasetelemetry.googleapis.com/App",
"labels": {
"resource_container": "projects/PROJECT_ID",
"location": "global",
"app_id": "FIREBASE_APP_ID",
"app_version": ""
}
},
"timestamp": "2026-06-25T21:19:44.619Z",
"severity": "ERROR",
"labels": {
"attr": "value",
"app.installation.id": "INSTALLATION_ID",
"exception.type": "Error",
"service.name": "FIREBASE_APP_ID",
"app_id": "FIREBASE_APP_ID",
"location": "global",
"session.id": "SESSION_ID",
"exception.stacktrace": "stacktrace",
"gcp.resource_type": "firebasetelemetry.googleapis.com/App",
"exception.message": "test error",
"gcp.telemetry_type": "standard",
"service.version": "",
"cloud.resource.id": "//firebasetelemetry.googleapis.com/projects/PROJECT_ID/locations/global/",
"gcp.project.id": "projects/PROJECT_ID",
"user_agent.version": "150",
"gcp.project_id": "PROJECT_ID",
"resource_container": "projects/PROJECT_ID",
"os.version": "10_15_7",
"browser.platform": "macintosh",
"gcp.telemetry_config.service": "firebasetelemetry.googleapis.com",
"os.name": "intel mac os x",
"user_agent.name": "chrome",
"app.build_id": "unset"
},
"logName": "projects/PROJECT_ID/logs/firebasetelemetry.googleapis.com%2Fevents",
"receiveTimestamp": "2026-06-25T21:19:45.105200710Z",
"errorGroups": [
{
"id": "error_group_id"
}
],
"otel": {
"resource": {
"attributes": {
"gcp.resource_type": "firebasetelemetry.googleapis.com/App",
"service.version": "",
"user_agent.version": "150",
"cloud.resource.id": "//firebasetelemetry.googleapis.com/projects/PROJECT_ID/locations/global/",
"gcp.project.id": "projects/PROJECT_ID",
"os.version": "10_15_7",
"gcp.project_id": "PROJECT_ID",
"resource_container": "projects/PROJECT_ID",
"browser.platform": "macintosh",
"os.name": "intel mac os x",
"user_agent.name": "chrome",
"app.build_id": "",
"service.name": "firebase_telemetry_service",
"app_id": "FIREBASE_APP_ID",
"location": "global",
"user_agent.original": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36,gzip(gfe)"
}
}
}
}
| Campi | Descrizione |
|---|---|
insertId |
string
Identificatore univoco della voce di log in Cloud Logging. |
jsonPayload |
object
Il payload dell'evento contenente i dettagli dell'eccezione ( |
httpRequest |
object
Metadati della richiesta HTTP, tra cui |
resource |
object
Metadati delle risorse monitorate ( |
timestamp |
string (Timestamp format)
Timestamp del client in cui è stato registrato l'evento. |
severity |
string
Livello di gravità del log (ad esempio, |
labels |
map (key: string, value: string)
Etichette di attributi personalizzati, sistema operativo, browser, sessione ed evento associate all'evento. |
logName |
string
Nome risorsa del log ( |
receiveTimestamp |
string (Timestamp format)
Timestamp del server in cui la voce di log è stata ricevuta da Cloud Logging. |
errorGroups[] |
object
Identificatori del gruppo di errori assegnati all'evento. |
otel |
object
Attributi delle risorse OpenTelemetry per il client web e il servizio di telemetria. |
Metadati del browser web
Dimensioni del browser e dell'ambiente client compilate in labels e
otel.resource.attributes.
| Campi | Descrizione |
|---|---|
browser.platform |
string
Sistema operativo client e architettura della piattaforma (ad esempio,
|
user_agent.name |
string
Nome dell'app client del browser (ad esempio, |
user_agent.version |
string
Versione principale o secondaria del client browser (ad esempio, |
user_agent.original |
string
Stringa dello user agent non elaborata dalla richiesta del client (ad esempio, |