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.


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