This page provides the log schema for exported Crashlytics data and Firebase sessions data in Cloud Logging .
-
Firebase sessions schema (if sessions data is enabled for export)
Crashlytics schema
Event
The message describing a single Crashlytics event.
JSON representation
{
"name"
:
s
tr
i
n
g
,
"platform"
:
s
tr
i
n
g
,
"bundleOrPackage"
:
s
tr
i
n
g
,
"eventId"
:
s
tr
i
n
g
,
"sessionId"
:
s
tr
i
n
g
,
"eventTime"
:
s
tr
i
n
g
,
"receivedTime"
:
s
tr
i
n
g
,
"issue"
:
{
objec
t
(Issue)
},
"issueVariant"
:
{
objec
t
(IssueVaria
nt
)
},
"device"
:
{
objec
t
(Device)
},
"memory"
:
{
objec
t
(Memory)
},
"storage"
:
{
objec
t
(S
t
orage)
},
"operatingSystem"
:
{
objec
t
(Opera
t
i
n
gSys
te
m)
},
"browser"
:
{
objec
t
(Browser)
},
"version"
:
{
objec
t
(Versio
n
)
},
"user"
:
{
objec
t
(User)
},
"customKeys"
:
{
s
tr
i
n
g
:
s
tr
i
n
g
,
...
},
"installationUuid"
:
s
tr
i
n
g
,
"crashlyticsSdkVersion"
:
s
tr
i
n
g
,
"appOrientation"
:
s
tr
i
n
g
,
"deviceOrientation"
:
s
tr
i
n
g
,
"logs"
:
[
{
objec
t
(Log)
}
],
"breadcrumbs"
:
[
{
objec
t
(Breadcrumb)
}
],
"blameFrame"
:
{
objec
t
(Frame)
},
"exceptions"
:
[
{
objec
t
(Excep
t
io
n
)
}
],
"errors"
:
[
{
objec
t
(Error)
}
],
"threads"
:
[
{
objec
t
(Thread)
}
],
"processState"
:
s
tr
i
n
g
,
"issueTitle"
:
s
tr
i
n
g
,
"issueSubtitle"
:
s
tr
i
n
g
,
"buildStamp"
:
s
tr
i
n
g
}
| Fields | Description |
|---|---|
name
|
string
Required. Output only. Immutable. Identifier.The name of
the event resource. Format: |
platform
|
string
Mobile platform (Android or iOS). |
bundleOrPackage
|
string
The bundle name for iOS apps or the package name of Android apps.
Format: |
eventId
|
string
Output only. Immutable.The unique event identifier is assigned during processing. |
sessionId
|
string
Unique identifier for the Firebase session. |
eventTime
|
string (Timestamp format)
Device timestamp at which the event was recorded. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30". |
receivedTime
|
string (Timestamp format)
Server timestamp at which the event was received by Crashlytics. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30". |
issue
|
object (Issue)
Details for the [Issue] assigned to this [Event]. |
issueVariant
|
object (IssueVariant)
Details for the [IssueVariant] assigned to this [Event]. |
device
|
object (Device)
Mobile device metadata. |
memory
|
object (Memory)
Mobile device memory usage. |
storage
|
object (Storage)
Mobile device disk/flash usage. |
operatingSystem
|
object (OperatingSystem)
Operating system and version. |
browser
|
object (Browser)
Browser and version. |
version
|
object (Version)
Mobile application version. |
user
|
object (User)
End user identifiers for the device owner. |
customKeys
|
map (key: string, value: string)
Custom keys set by the developer during the session. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }. |
installationUuid
|
string
Unique identifier for the device-app installation. This field is used to compute the unique number of impacted users. |
crashlyticsSdkVersion
|
string
Crashlytics SDK version. |
appOrientation
|
string
App orientation at the time of the crash (portrait or landscape). |
deviceOrientation
|
string
Device orientation at the time of the crash (portrait or landscape). |
logs[]
|
object (Log)
Log messages recorded by the developer during the session. |
breadcrumbs[]
|
object (Breadcrumb)
Analytics events recorded by the analytics SDK during the session. |
blameFrame
|
object (Frame)
The stack trace frame blamed by Crashlytics processing. May not be present in future analyzer. |
exceptions[]
|
object (Exception)
Android only. Exceptions that occurred during this event. Nested exceptions are presented in reverse chronological order, so that the last record is the first exception thrown. |
errors[]
|
object (Error)
Apple only. A non-fatal error captured by the iOS SDK and its stacktrace. |
threads[]
|
object (Thread)
Application threads present at the time the event was recorded. Each contains a stacktrace. One thread will be blamed for the error. |
processState
|
string
The state of the app process at the time of the event. |
issueTitle
|
string
The title of the issue in which the event was grouped. This is usually a source file or method name. |
issueSubtitle
|
string
The subtitle of the issue in which the event was grouped. This is usually a symbol or an exception message. |
buildStamp
|
string
Metadata provided by the app's build system, including version control repository info. |
Memory
Mobile device memory usage.
JSON representation
{
"used"
:
s
tr
i
n
g
,
"free"
:
s
tr
i
n
g
}
| Fields | Description |
|---|---|
used
|
string (int64 format)
Bytes in use. |
free
|
string (int64 format)
Bytes free. |
Storage
Mobile device disk/flash usage. Not reported for all devices.
JSON representation
{
"used"
:
s
tr
i
n
g
,
"free"
:
s
tr
i
n
g
}
| Fields | Description |
|---|---|
used
|
string (int64 format)
Bytes used. |
free
|
string (int64 format)
Bytes free. |
User
Developer-provided end user identifiers.
JSON representation
{
"id"
:
s
tr
i
n
g
}
| Fields | Description |
|---|---|
id
|
string
User id if provided by the app developer. |
Frame
A frame in a stacktrace.
JSON representation
{
"line"
:
s
tr
i
n
g
,
"file"
:
s
tr
i
n
g
,
"symbol"
:
s
tr
i
n
g
,
"offset"
:
s
tr
i
n
g
,
"address"
:
s
tr
i
n
g
,
"library"
:
s
tr
i
n
g
,
"owner"
:
s
tr
i
n
g
,
"blamed"
:
boolea
n
}
| Fields | Description |
|---|---|
line
|
string (int64 format)
The line number in the file of the frame. |
file
|
string
The name of the source file in which the frame is found. |
symbol
|
string
The frame symbol after it has been deobfuscated or symbolicated. The raw symbol from the device if it could not be hydrated. |
offset
|
string (int64 format)
The byte offset into the binary image that contains the code. Present for native frames. |
address
|
string (int64 format)
The address in the binary image which contains the code. Present for native frames. |
library
|
string
The display name of the library that includes the frame. |
owner
|
string
One of DEVELOPER, VENDOR, RUNTIME, PLATFORM, or SYSTEM. |
blamed
|
boolean
True when the Crashlytics analysis has determined that this frame is likely to be the cause of the error. |
Exception
A Java exception and its stacktrace, only from Android apps.
JSON representation
{
"type"
:
s
tr
i
n
g
,
"exceptionMessage"
:
s
tr
i
n
g
,
"nested"
:
boolea
n
,
"title"
:
s
tr
i
n
g
,
"subtitle"
:
s
tr
i
n
g
,
"blamed"
:
boolea
n
,
"frames"
:
[
{
objec
t
(Frame)
}
]
}
| Fields | Description |
|---|---|
type
|
string
The exception type e.g. java.lang.IllegalStateException. |
exceptionMessage
|
string
A message associated with the exception. |
nested
|
boolean
True for all but the last-thrown exception (i.e. the first record). |
title
|
string
The title of the exception. |
subtitle
|
string
The subtitle of the exception. |
blamed
|
boolean
True when the Crashlytics analysis has determined that this thread is where the fault occurred. |
frames[]
|
object (Frame)
The frames in the exception's stacktrace. |
Error
A non-fatal error and its stacktrace, only from Apple apps.
JSON representation
{
"queue"
:
s
tr
i
n
g
,
"code"
:
s
tr
i
n
g
,
"title"
:
s
tr
i
n
g
,
"subtitle"
:
s
tr
i
n
g
,
"blamed"
:
boolea
n
,
"frames"
:
[
{
objec
t
(Frame)
}
]
}
| Fields | Description |
|---|---|
queue
|
string
The queue on which the thread was running. |
code
|
string (int64 format)
Error code associated with the app's custom logged NSError. |
title
|
string
The title of the error. |
subtitle
|
string
The subtitle of the error. |
blamed
|
boolean
True when the Crashlytics analysis has determined that the stacktrace in this error is where the fault occurred. |
frames[]
|
object (Frame)
The frames in the error's stacktrace. |
Thread
An application thread.
JSON
represe
ntat
io
n
< /code></
t
h
>
< /
tr
>
< /
t
head
>
< t
body
>
< tr
>
< t
d><code>
{
"crashed"
:
boolea
n
,
"name"
:
s
tr
i
n
g
,
"queue"
:
s
tr
i
n
g
,
"signal"
:
s
tr
i
n
g
,
"signalCode"
:
s
tr
i
n
g
,
"crashAddress"
:
s
tr
i
n
g
,
"title"
:
s
tr
i
n
g
,
"subtitle"
:
s
tr
i
n
g
,
"blamed"
:
boolea
n
,
"frames"
:
[
{
objec
t
(Frame)
}
],
"threadId"
:
s
tr
i
n
g
,
"sysThreadId"
:
s
tr
i
n
g
,
"threadState"
:
e
nu
m
(S
tate
)
}
| Fields | Description |
|---|---|
crashed
|
boolean
True when the thread has crashed. |
name
|
string
The name of the thread. |
queue
|
string
The queue on which the thread was running. |
signal
|
string
The name of the signal that caused the app to crash. Only present on crashed native threads. |
signalCode
|
string
The code of the signal that caused the app to crash. Only present on crashed native threads. |
crashAddress
|
string (int64 format)
The address of the signal that caused the application to crash. Only present on crashed native threads. |
title
|
string
The title of the thread. |
subtitle
|
string
The subtitle of the thread. |
blamed
|
boolean
True when the Crashlytics analysis has determined that the stacktrace in this thread is where the fault occurred. |
frames[]
|
object (Frame)
The frames in the thread's stacktrace. |
threadId
|
string (int64 format)
The id of the thread, only available for ANR threads. |
sysThreadId
|
string (int64 format)
The system id of the thread, only available for ANR threads. |
threadState
|
enum (State)
Output only.The state of the thread at the time the ANR occurred. |
State
The state of a thread when the ANR occurred.
| Enums | Description |
|---|---|
STATE_UNSPECIFIED
|
Thread state unspecified. |
THREAD_STATE_TERMINATED
|
Thread was terminated. |
THREAD_STATE_RUNNABLE
|
Thread was runnable. |
THREAD_STATE_TIMED_WAITING
|
Thread was waiting with a timeout. |
THREAD_STATE_BLOCKED
|
Thread was blocked. |
THREAD_STATE_WAITING
|
Thread was waiting. |
THREAD_STATE_NEW
|
Thread was started, yet to run anything. |
THREAD_STATE_NATIVE_RUNNABLE
|
The thread was native and we could not heuristically determine that it was was waiting, so assume it's runnable. |
THREAD_STATE_NATIVE_WAITING
|
We heuristically determined that the thread is waiting. |
Firebase sessions schema
FirebaseSessionEvent
Sessions recorded by the Firebase App Quality Sessions SDK.
JSON representation
{
"sessionId"
:
s
tr
i
n
g
,
"eventType"
:
e
nu
m
(Sessio
n
Eve
nt
Type)
,
"firstSessionId"
:
s
tr
i
n
g
,
"sessionIndex"
:
i
nte
ger
,
"firebaseInstallationId"
:
s
tr
i
n
g
,
"eventTime"
:
s
tr
i
n
g
,
"version"
:
{
objec
t
(Versio
n
)
},
"device"
:
{
objec
t
(Device)
},
"operatingSystem"
:
{
objec
t
(Opera
t
i
n
gSys
te
m)
}
}
| Fields | Description |
|---|---|
sessionId
|
string
Unique identifier for the Firebase session. |
eventType
|
enum (SessionEventType)
Session event type. The SDK only supports SESSION_START events at this time. |
firstSessionId
|
string
The identifier of the first session since the last cold start. This id and the sessionId will be the same for app launches. |
sessionIndex
|
integer
Indicates the number of sessions since the last cold start. |
firebaseInstallationId
|
string
Uniquely identifies a device with Firebase apps installed. |
eventTime
|
string (Timestamp format)
The start timestamp for the session event. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30". |
version
|
object (Version)
Mobile application version numbers. |
device
|
object (Device)
Mobile device metadata. |
operatingSystem
|
object (OperatingSystem)
Operating system and version. |
SessionEventType
Types of SessionEvent
that are recorded.
| Enums | Description |
|---|---|
SESSION_EVENT_TYPE_UNKNOWN
|
Unknown. |
SESSION_START
|
Application session started. |
Device Log schema
DeviceLog
Represents the structure of the deviceLog entries.
JSON representation
{
"eventId"
:
s
tr
i
n
g
,
"sessionId"
:
s
tr
i
n
g
,
// Union field payload can be only one of the following:
"log"
:
{
objec
t
(Log)
},
"breadcrumb"
:
{
objec
t
(Breadcrumb)
}
// End of list of possible types for union field payload.
}
eventId
string
Output only. Immutable.The identifier of the event to which this is associated.
sessionId
string
Unique identifier for the Firebase session.
Union field payload
. Payload can either be
a Crashlytics log or a Breadcrumb. payload
can be only one of
the following:
log
object (Log)
Crashlytics log.
breadcrumb
object (Breadcrumb)
Crashlytics breadcrumb.
Log
Developer-provided log lines recorded during the session.
JSON representation
{
"logTime"
:
s
tr
i
n
g
,
"message"
:
s
tr
i
n
g
}
| Fields | Description |
|---|---|
logTime
|
string (Timestamp format)
Device timestamp when the line was logged. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30". |
message
|
string
Log message. |
Breadcrumb
Analytics events recorded during the session.
JSON representation
{
"eventTime"
:
s
tr
i
n
g
,
"title"
:
s
tr
i
n
g
,
"params"
:
{
s
tr
i
n
g
:
s
tr
i
n
g
,
...
}
}
| Fields | Description |
|---|---|
eventTime
|
string (Timestamp format)
Device timestamp for the event. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30". |
title
|
string
Analytic event name. |
params
|
map (key: string, value: string)
Event parameters. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }. |
