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

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

platform string

Mobile Plattform (Android oder iOS)

bundleOrPackage string

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

eventId string

Nur Ausgabe. Unveränderlich: Die eindeutige Ereigniskennung wird während der Verarbeitung zugewiesen.

sessionId string

Eindeutige Kennung für die Firebase-Sitzung.

eventTime string (Timestamp format)

Gerätezeitstempel, 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, der angibt, wann 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“.

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)

Festplatten-/Flash-Nutzung auf Mobilgeräten.

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)

Endnutzer-IDs für den Geräteinhaber.

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 App auf dem Gerät. Anhand dieses Felds wird die eindeutige Anzahl der betroffenen Nutzer berechnet.

crashlyticsSdkVersion string

Crashlytics SDK-Version.

appOrientation string

App-Ausrichtung zum Zeitpunkt des Absturzes (Hoch- oder Querformat).

deviceOrientation string

Geräteausrichtung zum Zeitpunkt des Absturzes (Hoch- oder Querformat).

logs[] object (Log)

Von Entwicklern während der Sitzung aufgezeichnete Protokollmeldungen.

breadcrumbs[] object (Breadcrumb)

Analytics-Ereignisse, die während der Sitzung vom Analytics SDK erfasst wurden.

blameFrame object (Frame)

Der Stacktrace-Frame, der von der Crashlytics-Verarbeitung als Fehlerquelle angegeben wird. Möglicherweise nicht im zukünftigen Analysetool vorhanden.

exceptions[] object (Exception)

Sie besitzen ein Android-Gerät. Ausnahmen, die während dieses Ereignisses aufgetreten sind. Verschachtelte Ausnahmen werden in umgekehrter chronologischer Reihenfolge dargestellt, sodass der letzte Datensatz die erste ausgelöste Ausnahme ist.

errors[] object (Error)

Nur Apple. Ein nicht schwerwiegender Fehler, der vom iOS SDK und seinem Stacktrace erfasst wurde.

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 in der Regel eine Quelldatei oder ein Methodenname.

issueSubtitle string

Der Untertitel der Ausgabe, in der das Ereignis gruppiert wurde. Dies ist in der Regel ein Symbol oder eine Fehlermeldung.

buildStamp string

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

Memory

Arbeitsspeichernutzung auf Mobilgeräten.

JSON-Darstellung

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

Verwendete Bytes.

free string (int64 format)

Kostenlose Bytes.

Storage

Festplatten-/Flash-Nutzung auf Mobilgeräten. Nicht für alle Geräte verfügbar.

JSON-Darstellung

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

Verwendete Bytes.

free string (int64 format)

Kostenlose Bytes.

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 sich der Frame befindet.

symbol string

Das Frame-Symbol nach der Offenlegung oder Symbolication. Das Rohsymbol vom Gerät, wenn es nicht mit Daten gefüllt werden konnte.

offset string (int64 format)

Der Byte-Offset in das binäre Image, das den Code enthält. Präsentieren für native Frames.

address string (int64 format)

Die Adresse im binären Image, die den Code enthält. Präsentieren für native Frames.

library string

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

owner string

Einer der folgenden Werte: 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-Ausnahme und ihr Stacktrace, nur aus Android-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 Nachricht, die mit der Ausnahme verknüpft ist.

nested boolean

Wahr für alle außer der zuletzt ausgelösten Ausnahme (d.h. dem ersten Datensatz).

title string

Der Titel der Ausnahme.

subtitle string

Der Untertitel des Ausnahmefehlers.

blamed boolean

„True“, wenn bei der Crashlytics-Analyse festgestellt wurde, dass der Fehler in diesem Thread aufgetreten ist.

frames[] object (Frame)

Die Frames im Stacktrace der Ausnahme.

Error

Ein nicht schwerwiegender Fehler und sein 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 dem benutzerdefinierten protokollierten NSError der App zugeordnet ist.

title string

Der Titel des Fehlers.

subtitle string

Der Untertitel des Fehlers.

blamed boolean

„True“, wenn bei der Crashlytics-Analyse festgestellt wurde, dass der Fehler im Stacktrace dieses Fehlers aufgetreten ist.

frames[] object (Frame)

Die Frames im Stacktrace des Fehlers.

Thread

Ein Anwendungs-Thread.

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 zum Absturz der Anwendung geführt hat. Nur bei abgestürzten nativen Threads vorhanden.

title string

Der Titel des Threads.

subtitle string

Der Untertitel des Threads.

blamed boolean

„True“, wenn bei der Crashlytics-Analyse festgestellt wurde, dass der Fehler im Stacktrace dieses Threads aufgetreten 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

Der Thread-Status ist nicht angegeben.

THREAD_STATE_TERMINATED

Der Thread wurde beendet.

THREAD_STATE_RUNNABLE

Der Thread konnte ausgeführt werden.

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, es wurde aber noch nichts ausgeführt.

THREAD_STATE_NATIVE_RUNNABLE

Der Thread war nativ und wir konnten heuristisch nicht feststellen, dass er wartete. Wir gehen also davon aus, dass er ausgeführt werden kann.

THREAD_STATE_NATIVE_WAITING

Wir haben heuristisch ermittelt, dass der Thread wartet.



Firebase-Sitzungsschema

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 ID 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

Hiermit wird ein Gerät mit installierten Firebase-Apps eindeutig identifiziert.

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

Die Anwendungssitzung wurde gestartet.



Schema für Geräteprotokolle

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, dem dies zugeordnet ist.

sessionId string

Eindeutige Kennung für die Firebase-Sitzung.

Union-Feld payload. Die Nutzlast kann entweder ein Crashlytics-Log oder ein Breadcrumb 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 Logzeilen, die während der Sitzung aufgezeichnet wurden.

JSON-Darstellung

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

Der Zeitstempel des Geräts, als 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

Log-Nachricht.

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" }