Schéma de journal pour les données exportées dans Cloud Logging

Cette page fournit le schéma de journalisation pour les données Crashlytics exportées et les données de sessions Firebase dans Cloud Logging.

• Schéma Crashlytics

• Schéma des sessions Firebase (si l'exportation des données de session est activée)

• Schéma des journaux d'appareils

---

Crashlytics schéma

Event

Message décrivant un seul événement Crashlytics.

Représentation 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
}

Champs	Description
name	string Obligatoire. Sortie uniquement. Immuable : Identifiant. Nom de la ressource d'événement. Format : projects/{project}/apps/{app_id}/events/{event}.
platform	string Plate-forme mobile (Android ou iOS).
bundleOrPackage	string Nom du bundle pour les applications iOS ou nom du package pour les applications Android. Format : com.mycompany.myapp.
eventId	string Uniquement en sortie. Immuable : L'identifiant unique de l'événement est attribué lors du traitement.
sessionId	string Identifiant unique de la session Firebase.
eventTime	string (Timestamp format) Code temporel de l'appareil auquel l'événement a été enregistré. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
receivedTime	string (Timestamp format) Code temporel du serveur auquel l'événement a été reçu par Crashlytics. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
issue	object (Issue) Détails du [problème] attribué à cet [événement].
issueVariant	object (IssueVariant) Détails de la [IssueVariant] attribuée à cet [Event].
device	object (Device) Métadonnées de l'appareil mobile.
memory	object (Memory) Utilisation de la mémoire de l'appareil mobile.
storage	object (Storage) Utilisation du disque/de la mémoire flash de l'appareil mobile.
operatingSystem	object (OperatingSystem) Système d'exploitation et version.
browser	object (Browser) Navigateur et version
version	object (Version) Version de l'application mobile.
user	object (User) Identifiants de l'utilisateur final pour le propriétaire de l'appareil.
customKeys	map (key: string, value: string) Clés personnalisées définies par le développeur pendant la session. Objet contenant une liste de paires "clé:valeur". Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
installationUuid	string Identifiant unique de l'installation de l'application sur l'appareil. Ce champ permet de calculer le nombre unique d'utilisateurs concernés.
crashlyticsSdkVersion	string Version du SDK Crashlytics.
appOrientation	string Orientation de l'application au moment du plantage (portrait ou paysage).
deviceOrientation	string Orientation de l'appareil au moment du plantage (portrait ou paysage).
logs[]	object (Log) Messages de journaux enregistrés par le développeur pendant la session.
breadcrumbs[]	object (Breadcrumb) Événements Analytics enregistrés par le SDK Analytics au cours de la session.
blameFrame	object (Frame) Frame de trace de pile incriminé par le traitement Crashlytics. Il est possible qu'il ne soit pas présent dans le futur analyseur.
exceptions[]	object (Exception) Vous devez utiliser un appareil Android. Exceptions survenues lors de cet événement. Les exceptions imbriquées sont présentées dans l'ordre chronologique inverse, de sorte que le dernier enregistrement correspond à la première exception générée.
errors[]	object (Error) Apple uniquement. Erreur non fatale capturée par le SDK iOS et sa trace de pile.
threads[]	object (Thread) Threads d'application présents au moment où l'événement a été enregistré. Chacun contient une trace de pile. Un thread sera désigné comme responsable de l'erreur.
processState	string État du processus de l'application au moment de l'événement.
issueTitle	string Titre du problème dans lequel l'événement a été regroupé. Il s'agit généralement d'un nom de fichier source ou de méthode.
issueSubtitle	string Sous-titre du numéro dans lequel l'événement a été regroupé. Il s'agit généralement d'un symbole ou d'un message d'exception.
buildStamp	string Métadonnées fournies par le système de compilation de l'application, y compris les informations du dépôt de contrôle des versions.

Memory

Utilisation de la mémoire de l'appareil mobile.

Représentation JSON

{
  "used": string,
  "free": string
}

Champs	Description
used	string (int64 format) Octets utilisés.
free	string (int64 format) Octets disponibles.

Storage

Utilisation du disque/de la mémoire flash de l'appareil mobile. Non signalé pour tous les appareils.

Représentation JSON

{
  "used": string,
  "free": string
}

Champs	Description
used	string (int64 format) Octets utilisés.
free	string (int64 format) Octets disponibles.

User

Identifiants d'utilisateur final fournis par le développeur.

Représentation JSON

{
  "id": string
}

Champs	Description
id	string ID utilisateur, s'il est fourni par le développeur de l'application.

Frame

Cadre dans une trace de pile.

Représentation JSON

{
  "line": string,
  "file": string,
  "symbol": string,
  "offset": string,
  "address": string,
  "library": string,
  "owner": string,
  "blamed": boolean
}

Champs	Description
line	string (int64 format) Numéro de ligne du frame dans le fichier.
file	string Nom du fichier source dans lequel se trouve le frame.
symbol	string Le symbole de frame après désobscurcissement ou décodage. Le symbole brut de l'appareil s'il n'a pas pu être hydraté.
offset	string (int64 format) Décalage d'octet dans l'image binaire contenant le code. Présent pour les frames natifs.
address	string (int64 format) Adresse dans l'image binaire qui contient le code. Présente pour les frames natifs.
library	string Nom à afficher de la bibliothèque qui inclut le frame.
owner	string Valeurs possibles : DEVELOPER, VENDOR, RUNTIME, PLATFORM ou SYSTEM.
blamed	boolean True lorsque l'analyse Crashlytics a déterminé que ce frame est probablement à l'origine de l'erreur.

Exception

Exception Java et sa trace de pile, uniquement à partir d'applications Android.

Représentation JSON

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

Champs	Description
type	string Type d'exception, par exemple java.lang.IllegalStateException.
exceptionMessage	string Message associé à l'exception.
nested	boolean Vrai pour toutes les exceptions, sauf la dernière (c'est-à-dire le premier enregistrement).
title	string Titre de l'exception.
subtitle	string Sous-titre de l'exception.
blamed	boolean True lorsque l'analyse Crashlytics a déterminé que ce thread est celui où la défaillance s'est produite.
frames[]	object (Frame) Frames dans la trace de la pile de l'exception.

Error

Erreur non fatale et sa trace de pile, uniquement à partir des applications Apple.

Représentation JSON

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

Champs	Description
queue	string File d'attente sur laquelle le thread était en cours d'exécution.
code	string (int64 format) Code d'erreur associé à l'NSError personnalisé consigné par l'application.
title	string Titre de l'erreur.
subtitle	string Sous-titre de l'erreur.
blamed	boolean True lorsque l'analyse Crashlytics a déterminé que la trace de pile de cette erreur est l'endroit où la défaillance s'est produite.
frames[]	object (Frame) Frames dans la trace de la pile d'erreurs.

Thread

Un thread d'application.

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

Champs	Description
crashed	boolean "True" lorsque le thread a planté.
name	string Nom du thread.
queue	string File d'attente sur laquelle le thread était en cours d'exécution.
signal	string Nom du signal qui a provoqué le plantage de l'application. Présent uniquement sur les threads natifs plantés.
signalCode	string Code du signal qui a entraîné le plantage de l'application. Présent uniquement sur les threads natifs plantés.
crashAddress	string (int64 format) Adresse du signal qui a entraîné le plantage de l'application. N'est présent que sur les threads natifs plantés.
title	string Titre du fil de discussion.
subtitle	string Sous-titre du fil de discussion.
blamed	boolean True lorsque l'analyse Crashlytics a déterminé que la trace de pile de ce thread est à l'origine de la défaillance.
frames[]	object (Frame) Frames dans la trace de pile du thread.
threadId	string (int64 format) ID du thread, disponible uniquement pour les threads ANR.
sysThreadId	string (int64 format) ID système du thread, disponible uniquement pour les threads ANR.
threadState	enum (State) Sortie uniquement. État du thread au moment où l'ANR s'est produite.

State

État d'un thread lorsque l'ANR s'est produite.

Enums	Description
STATE_UNSPECIFIED	L'état du thread n'est pas spécifié.
THREAD_STATE_TERMINATED	Le thread a été arrêté.
THREAD_STATE_RUNNABLE	Le thread était exécutable.
THREAD_STATE_TIMED_WAITING	Le thread était en attente avec un délai d'expiration.
THREAD_STATE_BLOCKED	Le fil de discussion a été bloqué.
THREAD_STATE_WAITING	Le thread était en attente.
THREAD_STATE_NEW	Le thread a été démarré, mais rien n'a encore été exécuté.
THREAD_STATE_NATIVE_RUNNABLE	Le thread était natif et nous n'avons pas pu déterminer de manière heuristique qu'il était en attente. Nous supposons donc qu'il est exécutable.
THREAD_STATE_NATIVE_WAITING	Nous avons déterminé de manière heuristique que le thread était en attente.

---

Schéma des sessions Firebase

FirebaseSessionEvent

Sessions enregistrées par le SDK Firebase App Quality Sessions.

Représentation JSON

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

Champs	Description
sessionId	string Identifiant unique de la session Firebase.
eventType	enum (SessionEventType) Type d'événement de session. Pour le moment, le SDK n'est compatible qu'avec les événements SESSION_START.
firstSessionId	string Identifiant de la première session depuis le dernier démarrage à froid. Cet ID et l'ID de session seront identiques pour les lancements d'applications.
sessionIndex	integer Indique le nombre de sessions depuis le dernier démarrage à froid.
firebaseInstallationId	string Identifie de manière unique un appareil sur lequel des applications Firebase sont installées.
eventTime	string (Timestamp format) Code temporel de début de l'événement de session. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
version	object (Version) Numéros de version des applications mobiles.
device	object (Device) Métadonnées de l'appareil mobile.
operatingSystem	object (OperatingSystem) Système d'exploitation et version.

SessionEventType

Types de SessionEvent enregistrés.

Enums	Description
SESSION_EVENT_TYPE_UNKNOWN	Inconnu.
SESSION_START	La session de l'application a commencé.

---

Schéma du journal de l'appareil

DeviceLog

Représente la structure des entrées deviceLog.

Représentation 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.
}

Champs	Description
eventId	string Sortie uniquement. Immuable : Identifiant de l'événement auquel cette erreur est associée.
sessionId	string Identifiant unique de la session Firebase.
Champ d'union payload. La charge utile peut être un journal Crashlytics ou un fil d'Ariane. payload ne peut être qu'un des éléments suivants :
log	object (Log) Journal Crashlytics.
breadcrumb	object (Breadcrumb) Fil d'Ariane Crashlytics.

Log

Lignes de journaux fournies par le développeur et enregistrées pendant la session.

Représentation JSON

{
  "logTime": string,
  "message": string
}

Champs	Description
logTime	string (Timestamp format) Code temporel de l'appareil lorsque la ligne a été enregistrée. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
message	string Message de journal.

Breadcrumb

Événements Analytics enregistrés pendant la session.

Représentation JSON

{
  "eventTime": string,
  "title": string,
  "params": {
    string: string,
    ...
  }
}

Champs	Description
eventTime	string (Timestamp format) Code temporel de l'événement sur l'appareil. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
title	string Nom de l'événement analytique.
params	map (key: string, value: string) Paramètres de l'événement. Objet contenant une liste de paires "clé:valeur". Exemple : { "nom": "clé", "masse": "1,3 kg", "nombre": "3" }.