Esquema de registros para dados exportados no Cloud Logging

Nesta página, você encontra o esquema de registros para dados exportados do Crashlytics e dados de sessões do Firebase no Cloud Logging.

• Esquema Crashlytics

• Esquema de sessões do Firebase (se os dados de sessões estiverem ativados para exportação)

• Esquema de registro do dispositivo

---

Crashlytics esquema

Event

A mensagem que descreve um único evento do Crashlytics.

Representação 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
}

Campos	Descrição
name	string Obrigatório. Apenas saída. Imutável. Identificador. O nome do recurso de evento. Formato: projects/{project}/apps/{app_id}/events/{event}.
platform	string Plataforma móvel (Android ou iOS).
bundleOrPackage	string O nome do pacote para apps iOS ou o nome do pacote para apps Android. Formato: com.mycompany.myapp.
eventId	string Apenas saída. Imutável. O identificador exclusivo do evento é atribuído durante o processamento.
sessionId	string Identificador exclusivo da sessão do Firebase.
eventTime	string (Timestamp format) Carimbo de data/hora do dispositivo em que o evento foi registrado. Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
receivedTime	string (Timestamp format) Carimbo de data/hora do servidor em que o evento foi recebido pelo Crashlytics. Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
issue	object (Issue) Detalhes do [Problema] atribuído a este [Evento].
issueVariant	object (IssueVariant) Detalhes da [IssueVariant] atribuída a este [Event].
device	object (Device) Metadados do dispositivo móvel.
memory	object (Memory) Uso da memória do dispositivo móvel.
storage	object (Storage) Uso de disco/flash do dispositivo móvel.
operatingSystem	object (OperatingSystem) Sistema operacional e versão.
browser	object (Browser) Navegador e versão.
version	object (Version) Versão do aplicativo para dispositivos móveis.
user	object (User) Identificadores do usuário final para o proprietário do dispositivo.
customKeys	map (key: string, value: string) Chaves personalizadas definidas pelo desenvolvedor durante a sessão. Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
installationUuid	string Identificador exclusivo da instalação do app no dispositivo. Esse campo é usado para calcular o número exclusivo de usuários afetados.
crashlyticsSdkVersion	string Versão do SDK do Crashlytics.
appOrientation	string Orientação do app no momento da falha (retrato ou paisagem).
deviceOrientation	string Orientação do dispositivo no momento da falha (retrato ou paisagem).
logs[]	object (Log) Mensagens de registro gravadas pelo desenvolvedor durante a sessão.
breadcrumbs[]	object (Breadcrumb) Eventos do Analytics registrados pelo SDK do Analytics durante a sessão.
blameFrame	object (Frame) O frame de rastreamento de pilha apontado pelo processamento do Crashlytics. Pode não estar presente no analisador futuro.
exceptions[]	object (Exception) Somente para Android Exceções que ocorreram durante este evento. As exceções aninhadas são apresentadas em ordem cronológica inversa, para que o último registro seja a primeira exceção lançada.
errors[]	object (Error) Somente para Apple. Um erro não fatal capturado pelo SDK do iOS e seu stacktrace.
threads[]	object (Thread) Threads do aplicativo presentes no momento em que o evento foi registrado. Cada um contém um rastreamento de pilha. Uma thread será responsabilizada pelo erro.
processState	string O estado do processo do app no momento do evento.
issueTitle	string O título do problema em que o evento foi agrupado. Geralmente, é um arquivo de origem ou um nome de método.
issueSubtitle	string O subtítulo do problema em que o evento foi agrupado. Geralmente, é um símbolo ou uma mensagem de exceção.
buildStamp	string Metadados fornecidos pelo sistema de build do app, incluindo informações do repositório de controle de versão.

Memory

Uso da memória do dispositivo móvel.

Representação JSON

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

Campos	Descrição
used	string (int64 format) Bytes em uso.
free	string (int64 format) Bytes livres.

Storage

Uso de disco/flash do dispositivo móvel. Não é informado para todos os dispositivos.

Representação JSON

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

Campos	Descrição
used	string (int64 format) Bytes usados.
free	string (int64 format) Bytes livres.

User

Identificadores de usuários finais fornecidos pelo desenvolvedor.

Representação JSON

{
  "id": string
}

Campos	Descrição
id	string ID do usuário, se fornecido pelo desenvolvedor do app.

Frame

Um frame em um rastreamento de pilha.

Representação JSON

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

Campos	Descrição
line	string (int64 format) O número da linha no arquivo do frame.
file	string O nome do arquivo de origem em que o frame foi encontrado.
symbol	string O símbolo do frame depois de ter sido desofuscado ou simbolizado. O símbolo bruto do dispositivo, se não for possível hidratar.
offset	string (int64 format) O deslocamento de byte na imagem binária que contém o código. Presente para frames nativos.
address	string (int64 format) O endereço na imagem binária que contém o código. Presente para frames nativos.
library	string O nome de exibição da biblioteca que inclui o frame.
owner	string Um de DEVELOPER, VENDOR, RUNTIME, PLATFORM ou SYSTEM.
blamed	boolean Verdadeiro quando a análise do Crashlytics determina que esse frame provavelmente é a causa do erro.

Exception

Uma exceção Java e seu rastreamento de pilha, somente de apps Android.

Representação JSON

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

Campos	Descrição
type	string O tipo de exceção, por exemplo, java.lang.IllegalStateException.
exceptionMessage	string Uma mensagem associada à exceção.
nested	boolean Verdadeiro para todas, exceto a última exceção lançada (ou seja, o primeiro registro).
title	string O título da exceção.
subtitle	string O subtítulo da exceção.
blamed	boolean Verdadeiro quando a análise do Crashlytics determina que a falha ocorreu nesta thread.
frames[]	object (Frame) Os frames no rastreamento de pilha da exceção.

Error

Um erro não fatal e o stacktrace dele, apenas de apps da Apple.

Representação JSON

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

Campos	Descrição
queue	string A fila em que a thread estava sendo executada.
code	string (int64 format) Código de erro associado ao NSError personalizado registrado no app.
title	string O título do erro.
subtitle	string O subtítulo do erro.
blamed	boolean Verdadeiro quando a análise do Crashlytics determina que o stacktrace neste erro é onde a falha ocorreu.
frames[]	object (Frame) Os frames no rastreamento de pilha do erro.

Thread

Uma linha de execução do aplicativo.

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

Campos	Descrição
crashed	boolean Verdadeiro quando a linha de execução falha.
name	string O nome da thread.
queue	string A fila em que a thread estava sendo executada.
signal	string O nome do sinal que causou a falha do app. Presente apenas em threads nativas com falha.
signalCode	string O código do sinal que causou a falha do app. Presente apenas em threads nativas com falha.
crashAddress	string (int64 format) O endereço do sinal que causou a falha do aplicativo. Presente apenas em threads nativas com falha.
title	string O título da thread.
subtitle	string A legenda da thread.
blamed	boolean Verdadeiro quando a análise do Crashlytics determina que o stacktrace nesta linha de execução é onde ocorreu a falha.
frames[]	object (Frame) Os frames no rastreamento de pilha da linha de execução.
threadId	string (int64 format) O ID da linha de execução, disponível apenas para linhas de execução de ANR.
sysThreadId	string (int64 format) O ID do sistema da linha de execução, disponível apenas para linhas de execução de ANR.
threadState	enum (State) Apenas saída. O estado da linha de execução no momento em que o ANR ocorreu.

State

O estado de uma linha de execução quando o erro ANR ocorreu.

Tipos enumerados	Descrição
STATE_UNSPECIFIED	Estado da linha de execução não especificado.
THREAD_STATE_TERMINATED	A execução da linha de execução foi encerrada.
THREAD_STATE_RUNNABLE	A thread estava executável.
THREAD_STATE_TIMED_WAITING	A linha de execução estava aguardando com um tempo limite.
THREAD_STATE_BLOCKED	A conversa foi bloqueada.
THREAD_STATE_WAITING	A conversa estava aguardando.
THREAD_STATE_NEW	A linha de execução foi iniciada, mas ainda não executou nada.
THREAD_STATE_NATIVE_RUNNABLE	A linha de execução era nativa e não foi possível determinar heuristicamente que ela estava aguardando. Portanto, presumimos que ela pode ser executada.
THREAD_STATE_NATIVE_WAITING	Determinamos heuristicamente que a linha de execução está aguardando.

---

Esquema de sessões do Firebase

FirebaseSessionEvent

Sessões registradas pelo SDK de sessões de qualidade do app do Firebase.

Representação JSON

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

Campos	Descrição
sessionId	string Identificador exclusivo da sessão do Firebase.
eventType	enum (SessionEventType) Tipo de evento de sessão. No momento, o SDK só é compatível com eventos SESSION_START.
firstSessionId	string O identificador da primeira sessão desde a última inicialização a frio. Esse ID e o sessionId serão iguais para inicializações de apps.
sessionIndex	integer Indica o número de sessões desde a última inicialização a frio.
firebaseInstallationId	string Identifica de forma exclusiva um dispositivo com apps do Firebase instalados.
eventTime	string (Timestamp format) O carimbo de data/hora de início do evento de sessão. Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
version	object (Version) Números de versão de aplicativos para dispositivos móveis.
device	object (Device) Metadados do dispositivo móvel.
operatingSystem	object (OperatingSystem) Sistema operacional e versão.

SessionEventType

Tipos de SessionEvent que são gravados.

Tipos enumerados	Descrição
SESSION_EVENT_TYPE_UNKNOWN	Desconhecido.
SESSION_START	Sessão do aplicativo iniciada.

---

Esquema de registro do dispositivo

DeviceLog

Representa a estrutura das entradas deviceLog.

Representação 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.
}

Campos	Descrição
eventId	string Apenas saída. Imutável. O identificador do evento a que isso está associado.
sessionId	string Identificador exclusivo da sessão do Firebase.
Campo de união payload. O payload pode ser um log do Crashlytics ou um breadcrumb. payload pode ser apenas um dos seguintes:
log	object (Log) Registro do Crashlytics.
breadcrumb	object (Breadcrumb) Navegação estrutural do Crashlytics.

Log

Linhas de registro fornecidas pelo desenvolvedor e gravadas durante a sessão.

Representação JSON

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

Campos	Descrição
logTime	string (Timestamp format) Carimbo de data/hora do dispositivo quando a linha foi registrada. Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
message	string Mensagem de registro.

Breadcrumb

Eventos do Google Analytics registrados durante a sessão.

Representação JSON

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

Campos	Descrição
eventTime	string (Timestamp format) Carimbo de data/hora do dispositivo para o evento. Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
title	string Nome do evento de análise.
params	map (key: string, value: string) Parâmetros de evento. Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.