events

Creates, updates, deletes, gets or lists an events resource.

Overview

Name	events
Type	Resource
Id	firebase.firebasecrashlytics.events

Fields

The following fields are returned by SELECT queries:

batch_get

Name	Datatype	Description
events	array	The list of retrieved events.

list

Name	Datatype	Description
name	string	Required. Output only. Immutable. Identifier. The name of the event resource. Format: "projects/{project}/apps/{app_id}/events/{event}".
appOrientation	string	App orientation at the time of the crash (portrait or landscape).
blameFrame	object	A frame in a stacktrace. (id: Frame)
breadcrumbs	array	Analytics events recorded by the analytics SDK during the session.
browser	object	Browser and version. (id: Browser)
buildStamp	string	Metadata provided by the app's build system, including version control repository info.
bundleOrPackage	string	The bundle name for iOS apps or the package name of Android apps. Format: "com.mycompany.myapp".
crashlyticsSdkVersion	string	Crashlytics SDK version.
customKeys	object	Custom keys set by the developer during the session.
device	object	Mobile device metadata. (id: Device)
deviceOrientation	string	Device orientation at the time of the crash (portrait or landscape).
errors	array	Apple only. A non-fatal error captured by the iOS SDK and its stacktrace.
eventId	string	Output only. Immutable. The unique event identifier is assigned during processing.
eventTime	string (google-datetime)	Device timestamp that the event was recorded.
exceptions	array	Android and web 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.
installationUuid	string	Unique identifier for the device-app installation. This field is used to compute the unique number of impacted users.
issue	object	Details for the [Issue] assigned to this [Event]. (id: Issue)
issueSubtitle	string	The subtitle of the issue in which the event was grouped. This is usually a symbol or an exception message.
issueTitle	string	The title of the issue in which the event was grouped. This is usually a source file or method name.
issueVariant	object	Details for the [IssueVariant] assigned to this [Event]. (id: IssueVariant)
logs	array	Log messages recorded by the developer during the session.
memory	object	Mobile device memory usage. (id: Memory)
operatingSystem	object	Operating system and version. (id: OperatingSystem)
platform	string	ANDROID, IOS, or WEB.
processState	string	The state of the app process at the time of the event.
receivedTime	string (google-datetime)	Server timestamp that the event was received by Crashlytics.
routePath	string	Output only. Web only. The route path of the web application when the event occurred, excluding query parameters and fragment.
sessionId	string	Unique identifier for the Firebase session.
storage	object	Mobile device disk/flash usage. (id: Storage)
threads	array	Application threads present at the time the event was recorded. Each contains a stacktrace. One thread will be blamed for the error.
user	object	End user identifiers for the device owner. (id: User)
version	object	Mobile application version. (id: Version)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
batch_get	select	projectsId, appsId	names, readMask	Fetch a batch of up to 100 events by name.
list	select	projectsId, appsId	filter.issue.states, pageToken, filter.issue.content, filter.issue.variantId, filter.issue.signals, readMask, filter.device.displayNames, filter.operatingSystem.displayNames, pageSize, filter.issue.id, filter.browser.displayNames, filter.issue.errorTypes, filter.interval.startTime, filter.version.displayNames, filter.device.formFactors, filter.interval.endTime, filter.issue.state	List the events for an issue matching filter criteria, sorted in descending order by timestamp.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
appsId	string
projectsId	string
filter.browser.displayNames	string
filter.device.displayNames	string
filter.device.formFactors	string
filter.interval.endTime	string (google-datetime)
filter.interval.startTime	string (google-datetime)
filter.issue.content	string
filter.issue.errorTypes	string
filter.issue.id	string
filter.issue.signals	string
filter.issue.state	string
filter.issue.states	string
filter.issue.variantId	string
filter.operatingSystem.displayNames	string
filter.version.displayNames	string
names	string
pageSize	integer (int32)
pageToken	string
readMask	string (google-fieldmask)

SELECT examples

batch_get

Fetch a batch of up to 100 events by name.

SELECT
events
FROM firebase.firebasecrashlytics.events
WHERE projectsId = '{{ projectsId }}' -- required
AND appsId = '{{ appsId }}' -- required
AND names = '{{ names }}'
AND readMask = '{{ readMask }}'
;

list

List the events for an issue matching filter criteria, sorted in descending order by timestamp.

SELECT
name,
appOrientation,
blameFrame,
breadcrumbs,
browser,
buildStamp,
bundleOrPackage,
crashlyticsSdkVersion,
customKeys,
device,
deviceOrientation,
errors,
eventId,
eventTime,
exceptions,
installationUuid,
issue,
issueSubtitle,
issueTitle,
issueVariant,
logs,
memory,
operatingSystem,
platform,
processState,
receivedTime,
routePath,
sessionId,
storage,
threads,
user,
version
FROM firebase.firebasecrashlytics.events
WHERE projectsId = '{{ projectsId }}' -- required
AND appsId = '{{ appsId }}' -- required
AND filter.issue.states = '{{ filter.issue.states }}'
AND pageToken = '{{ pageToken }}'
AND filter.issue.content = '{{ filter.issue.content }}'
AND filter.issue.variantId = '{{ filter.issue.variantId }}'
AND filter.issue.signals = '{{ filter.issue.signals }}'
AND readMask = '{{ readMask }}'
AND filter.device.displayNames = '{{ filter.device.displayNames }}'
AND filter.operatingSystem.displayNames = '{{ filter.operatingSystem.displayNames }}'
AND pageSize = '{{ pageSize }}'
AND filter.issue.id = '{{ filter.issue.id }}'
AND filter.browser.displayNames = '{{ filter.browser.displayNames }}'
AND filter.issue.errorTypes = '{{ filter.issue.errorTypes }}'
AND filter.interval.startTime = '{{ filter.interval.startTime }}'
AND filter.version.displayNames = '{{ filter.version.displayNames }}'
AND filter.device.formFactors = '{{ filter.device.formFactors }}'
AND filter.interval.endTime = '{{ filter.interval.endTime }}'
AND filter.issue.state = '{{ filter.issue.state }}'
;