Logs für exportierte Daten in Cloud Logging

Auf dieser Seite finden Sie das Logschema für exportierte Crashlytics-Daten und Firebase-Sitzungsdaten in Cloud Logging.


Crashlytics Schema

Event

Die Nachricht, die ein einzelnes Crashlytics-Ereignis beschreibt.

JSON-Darstellung

{
  "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
}
Felder Beschreibung
name string

Erforderlich. Nur Ausgabe. Unveränderlich. Kennung. Der Name der Ereignisressource. Format: projects/{project}/apps/{app_id}/events/{event}.
platform string

ANDROID, IOS oder WEB.
bundleOrPackage string

Der Bundle-Name für iOS-Apps oder der Paketname für Android-Apps. Format: com.mycompany.myapp.
eventId string

Nur Ausgabe. Unveränderlich. Die eindeutige Ereignis-ID wird während der Verarbeitung zugewiesen.
sessionId string

Eindeutige Kennung für die Firebase-Sitzung.
eventTime string (Timestamp format)

Zeitstempel des Geräts, zu dem das Ereignis aufgezeichnet wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“ oder „2014-10-02T15:01:23+05:30“.
receivedTime string (Timestamp format)

Serverzeitstempel, zu dem das Ereignis von Crashlytics empfangen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“ oder „2014-10-02T15:01:23+05:30“.
state_update_time string (Timestamp format)

Der Zeitpunkt, zu dem der Status des Problems zuletzt geändert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“ oder „2014-10-02T15:01:23+05:30“.
first_seen_version string

Die erste display_version der App, in der dieses Problem aufgetreten ist. Wird nur für Probleme auf Mobilgeräten ausgefüllt.
last_seen_version string

Die neueste App-display_version, in der dieses Problem aufgetreten ist. Wird nur für Probleme auf Mobilgeräten ausgefüllt.
first_time_seen string (Timestamp format)

Der Zeitpunkt, zu dem dieses Problem zum ersten Mal aufgetreten ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“ oder „2014-10-02T15:01:23+05:30“.
last_time_seen string (Timestamp format)

Der Zeitpunkt, zu dem das Problem zuletzt aufgetreten ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“ oder „2014-10-02T15:01:23+05:30“.
issue object (Issue)

Details zum [Problem], das diesem [Ereignis] zugewiesen ist.
issueVariant object (IssueVariant)

Details zur [IssueVariant], die diesem [Event] zugewiesen ist.
device object (Device)

Metadaten von Mobilgeräten.
memory object (Memory)

Arbeitsspeichernutzung auf Mobilgeräten.
storage object (Storage)

Laufwerk-/Flash-Nutzung des Mobilgeräts.
operatingSystem object (OperatingSystem)

Betriebssystem und Version
browser object (Browser)

Der verwendete Browser und dessen Version
version object (Version)

Version der mobilen App.
user object (User)

Nutzer-IDs für den Geräteeigentümer.
customKeys map (key: string, value: string)

Benutzerdefinierte Schlüssel, die vom Entwickler während der Sitzung festgelegt wurden.

Ein Objekt mit einer Liste der Paare "key": value. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
installationUuid string

Eindeutige Kennung für die Installation der Geräte-App. Dieses Feld wird verwendet, um die eindeutige Anzahl der betroffenen Nutzer zu berechnen.
crashlyticsSdkVersion string

Crashlytics SDK-Version.
appOrientation string

Ausrichtung der App zum Zeitpunkt des Absturzes (Hoch- oder Querformat)
deviceOrientation string

Geräteausrichtung zum Zeitpunkt des Absturzes (Hoch- oder Querformat).
logs[] object (Log)

Logeinträge, die vom Entwickler während der Sitzung aufgezeichnet wurden.
breadcrumbs[] object (Breadcrumb)

Analyseereignisse, die während der Sitzung vom Analytics SDK aufgezeichnet wurden.
blameFrame object (Frame)

Der Stacktrace-Frame, der von der Crashlytics-Verarbeitung als Ursache identifiziert wurde. In zukünftigen Analysetools möglicherweise nicht vorhanden.
exceptions[] object (Exception)

Nur für Android und das Web. Ausnahmen, die während dieses Ereignisses aufgetreten sind. Verschachtelte Ausnahmen werden in umgekehrter chronologischer Reihenfolge dargestellt, sodass der letzte Eintrag die erste ausgelöste Ausnahme ist.
errors[] object (Error)

Nur Apple. Ein nicht schwerwiegender Fehler, der vom iOS SDK erfasst wurde, und der zugehörige Stacktrace.
threads[] object (Thread)

Anwendungsthreads, die zum Zeitpunkt der Aufzeichnung des Ereignisses vorhanden waren. Jeder enthält einen Stacktrace. Ein Thread wird für den Fehler verantwortlich gemacht.
processState string

Der Status des App-Prozesses zum Zeitpunkt des Ereignisses.
issueTitle string

Der Titel des Problems, in dem das Ereignis gruppiert wurde. Dies ist normalerweise eine Quelldatei oder ein Methodenname.
issueSubtitle string

Der Untertitel des Problems, in dem das Ereignis gruppiert wurde. Dies ist normalerweise ein Symbol oder eine Ausnahmemeldung.
buildStamp string

Metadaten, die vom Build-System der App bereitgestellt werden, einschließlich Informationen zum Versionsverwaltungs-Repository.
routePath string

Nur im Web. Der Routenpfad der Webanwendung, als das Ereignis aufgetreten ist, ohne Suchparameter und Fragment.

Memory

Arbeitsspeichernutzung auf Mobilgeräten.

JSON-Darstellung

{
  "used": string,
  "free": string
}
Felder Beschreibung
used string (int64 format)

Verwendete Bytes.
free string (int64 format)

Byte verfügbar.

Storage

Laufwerk-/Flash-Nutzung des Mobilgeräts. Nicht für alle Geräte gemeldet.

JSON-Darstellung

{
  "used": string,
  "free": string
}
Felder Beschreibung
used string (int64 format)

Verwendete Bytes.
free string (int64 format)

Byte verfügbar.

User

Vom Entwickler bereitgestellte Endnutzer-IDs.

JSON-Darstellung

{
  "id": string
}
Felder Beschreibung
id string

Nutzer-ID, sofern vom App-Entwickler angegeben.

Frame

Ein Frame in einem Stacktrace.

JSON-Darstellung

{
  "line": string,
  "file": string,
  "symbol": string,
  "offset": string,
  "address": string,
  "library": string,
  "owner": string,
  "blamed": boolean
}
Felder Beschreibung
line string (int64 format)

Die Zeilennummer des Frames in der Datei.
file string

Der Name der Quelldatei, in der der Frame gefunden wird.
symbol string

Das Frame-Symbol nach der Offenlegung oder Symbolication. Das Rohsymbol vom Gerät, wenn es nicht hydratisiert werden konnte.
offset string (int64 format)

Der Byte-Offset im Binär-Image, das den Code enthält. Vorhanden für native Frames.
address string (int64 format)

Die Adresse im Binär-Image, die den Code enthält. Vorhanden für native Frames.
library string

Der Anzeigename der Bibliothek, die den Frame enthält.
owner string

Entweder DEVELOPER, VENDOR, RUNTIME, PLATFORM oder SYSTEM.
blamed boolean

„True“, wenn die Crashlytics-Analyse ergeben hat, dass dieser Frame wahrscheinlich die Ursache des Fehlers ist.

Exception

Eine Java- oder JavaScript-Ausnahme und der zugehörige Stacktrace. Nur über Android- und Web-Apps.

JSON-Darstellung

{
  "type": string,
  "exceptionMessage": string,
  "nested": boolean,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ]
}
Felder Beschreibung
type string

Der Ausnahmetyp, z.B. java.lang.IllegalStateException.
exceptionMessage string

Eine mit der Ausnahme verknüpfte Nachricht.
nested boolean

„True“ für alle außer der zuletzt ausgelösten Ausnahme (d.h. der erste Eintrag).
title string

Der Titel des Ausnahmefehlers.
subtitle string

Der Untertitel der Ausnahme.
blamed boolean

„True“, wenn die Crashlytics-Analyse ergeben hat, dass der Fehler in diesem Thread aufgetreten ist.
frames[] object (Frame)

Die Frames im Stacktrace der Ausnahme.

Error

Ein nicht schwerwiegender Fehler und der zugehörige Stacktrace, nur von Apple-Apps.

JSON-Darstellung

{
  "queue": string,
  "code": string,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ]
}
Felder Beschreibung
queue string

Die Warteschlange, in der der Thread ausgeführt wurde.
code string (int64 format)

Fehlercode, der mit dem benutzerdefinierten protokollierten NSError der App verknüpft ist.
title string

Der Titel des Fehlers.
subtitle string

Der Untertitel des Fehlers.
blamed boolean

„True“, wenn die Crashlytics-Analyse ergeben hat, dass der Fehler im Stacktrace dieses Fehlers aufgetreten ist.
frames[] object (Frame)

Die Frames im Stacktrace des Fehlers.

Thread

Ein Anwendungsthread.

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)
}
Felder Beschreibung
crashed boolean

„True“, wenn der Thread abgestürzt ist.
name string

Der Name des Threads.
queue string

Die Warteschlange, in der der Thread ausgeführt wurde.
signal string

Der Name des Signals, das zum Absturz der App geführt hat. Nur bei abgestürzten nativen Threads vorhanden.
signalCode string

Der Code des Signals, das zum Absturz der App geführt hat. Nur bei abgestürzten nativen Threads vorhanden.
crashAddress string (int64 format)

Die Adresse des Signals, das den Absturz der Anwendung verursacht hat. Nur in abgestürzten nativen Threads vorhanden.
title string

Der Titel des Threads.
subtitle string

Der Untertitel des Threads.
blamed boolean

„True“, wenn die Crashlytics-Analyse ergeben hat, dass der Stacktrace in diesem Thread die Fehlerursache ist.
frames[] object (Frame)

Die Frames im Stacktrace des Threads.
threadId string (int64 format)

Die ID des Threads, nur für ANR-Threads verfügbar.
sysThreadId string (int64 format)

Die System-ID des Threads, nur für ANR-Threads verfügbar.
threadState enum (State)

Nur Ausgabe. Der Status des Threads zum Zeitpunkt des ANR-Fehlers.

State

Der Status eines Threads, als der ANR-Fehler aufgetreten ist.

Enums Beschreibung
STATE_UNSPECIFIED

Thread-Status nicht angegeben.
THREAD_STATE_TERMINATED

Der Thread wurde beendet.
THREAD_STATE_RUNNABLE

Thread war ausführbar.
THREAD_STATE_TIMED_WAITING

Der Thread hat mit einem Zeitlimit gewartet.
THREAD_STATE_BLOCKED

Der Thread wurde blockiert.
THREAD_STATE_WAITING

Der Thread hat gewartet.
THREAD_STATE_NEW

Der Thread wurde gestartet, aber es wurde noch nichts ausgeführt.
THREAD_STATE_NATIVE_RUNNABLE

Der Thread war nativ und wir konnten nicht heuristisch feststellen, dass er wartet. Daher wird davon ausgegangen, dass er ausführbar ist.
THREAD_STATE_NATIVE_WAITING

Wir haben heuristisch ermittelt, dass der Thread wartet.


Schema für Firebase-Sitzungen

FirebaseSessionEvent

Sitzungen, die vom Firebase App Quality Sessions SDK aufgezeichnet wurden.

JSON-Darstellung

{
  "sessionId": string,
  "eventType": enum (SessionEventType),
  "firstSessionId": string,
  "sessionIndex": integer,
  "firebaseInstallationId": string,
  "eventTime": string,
  "version": {
    object (Version)
  },
  "device": {
    object (Device)
  },
  "operatingSystem": {
    object (OperatingSystem)
  }
}
Felder Beschreibung
sessionId string

Eindeutige Kennung für die Firebase-Sitzung.
eventType enum (SessionEventType)

Sitzungsereignistyp. Das SDK unterstützt derzeit nur SESSION_START-Ereignisse.
firstSessionId string

Die Kennung der ersten Sitzung seit dem letzten Kaltstart. Diese ID und die sessionId sind bei App-Starts identisch.
sessionIndex integer

Gibt die Anzahl der Sitzungen seit dem letzten Kaltstart an.
firebaseInstallationId string

Identifiziert ein Gerät mit installierten Firebase-Apps eindeutig.
eventTime string (Timestamp format)

Der Startzeitstempel für das Sitzungsereignis.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“ oder „2014-10-02T15:01:23+05:30“.
version object (Version)

Versionsnummern von mobilen Apps.
device object (Device)

Metadaten von Mobilgeräten.
operatingSystem object (OperatingSystem)

Betriebssystem und Version

SessionEventType

Arten von SessionEvent, die aufgezeichnet werden.

Enums Beschreibung
SESSION_EVENT_TYPE_UNKNOWN

Unbekannt
SESSION_START

Anwendungssitzung gestartet.


Geräteprotokollschema

DeviceLog

Stellt die Struktur der deviceLog-Einträge dar.

JSON-Darstellung

{
  "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.
}
Felder Beschreibung
eventId string

Nur Ausgabe. Unveränderlich. Die Kennung des Ereignisses, mit dem dies verknüpft ist.
sessionId string

Eindeutige Kennung für die Firebase-Sitzung.

Union-Feld payload. Die Nutzlast kann entweder ein Crashlytics-Log oder ein Navigationspfad sein. Für payload ist nur einer der folgenden Werte zulässig:
log object (Log)

Crashlytics-Log.
breadcrumb object (Breadcrumb)

Crashlytics-Navigationspfad.

Log

Vom Entwickler bereitgestellte Protokollzeilen, die während der Sitzung aufgezeichnet wurden.

JSON-Darstellung

{
  "logTime": string,
  "message": string
}
Felder Beschreibung
logTime string (Timestamp format)

Zeitstempel des Geräts, zu dem die Zeile protokolliert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“ oder „2014-10-02T15:01:23+05:30“.
message string

Logeintrag.

Breadcrumb

Analytics-Ereignisse, die während der Sitzung aufgezeichnet wurden.

JSON-Darstellung

{
  "eventTime": string,
  "title": string,
  "params": {
    string: string,
    ...
  }
}
Felder Beschreibung
eventTime string (Timestamp format)

Gerätezeitstempel für das Ereignis.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: „2014-10-02T15:01:23Z“, „2014-10-02T15:01:23.045123456Z“ oder „2014-10-02T15:01:23+05:30“.
title string

Name des Analyseereignisses.
params map (key: string, value: string)

Ereignisparameter.

Ein Objekt mit einer Liste der Paare "key": value. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }