Esquema do conjunto de dados para dados exportados no BigQuery

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

O Firebase cria novos conjuntos de dados no BigQuery para seus dados exportados:


Crashlytics conjunto de dados

Os dados do Crashlytics são exportados para um conjunto de dados do BigQuery chamado firebase_crashlytics. O conjunto de dados abrange todo o projeto, mesmo que tenha vários apps.

Tabelas

Por padrão, o Firebase cria tabelas individuais dentro do conjunto de dados do Crashlytics para cada app no seu projeto vinculado ao BigQuery.

As tabelas são nomeadas com base no identificador do app (com pontos convertidos em sublinhados) e anexadas à plataforma do app (_IOS ou _ANDROID). Por exemplo, os dados de um app Android com o nome do pacote com.google.test ficariam em uma tabela chamada com_google_test_ANDROID.

  • Se a exportação contínua para o BigQuery estiver ativada, os dados também serão transmitidos em tempo real para uma tabela anexada com _REALTIME (por exemplo, com_google_test_ANDROID_REALTIME).

  • Cada linha em uma tabela representa um evento que ocorreu no app, incluindo falhas, erros não fatais e ANRs.

  • As tabelas contêm um conjunto padrão de dados do Crashlytics, além de chaves personalizadas do Crashlytics definidas por você no app (iOS+ | Android | Flutter | Unity).

Linhas

Cada linha em uma tabela representa um erro encontrado pelo app.

Colunas

As colunas em uma tabela são idênticas para falhas, erros não fatais e ANRs.

  • Se a exportação contínua para o BigQuery estiver ativada, a tabela em tempo real terá as mesmas colunas da tabela em lote.

  • Você pode ter colunas em linhas que representam eventos sem stack traces.

Confira as colunas na tabela dos dados exportados de Crashlytics:

Nome do campo Tipo de dado Descrição
app_orientation STRING Por exemplo, PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN etc.
application RECORD O app que gerou o evento
application.build_version STRING A versão do build do app
application.display_version STRING
blame_frame RECORD O frame identificado como a causa raiz da falha ou do erro
blame_frame.address INT64 O endereço na imagem binária que contém o código
não configurado para frames Java
blame_frame.blamed BOOLEANO Se o Crashlytics determinou que esse frame é a causa da falha ou do erro
blame_frame.file STRING O nome do arquivo do frame
blame_frame.library STRING O nome de exibição da biblioteca que inclui o frame
blame_frame.line INT64 O número da linha no arquivo do frame
blame_frame.offset INT64 O deslocamento de bytes na imagem binária que contém o código
não configurado para exceções Java
blame_frame.owner STRING Por exemplo, DEVELOPER, VENDOR, RUNTIME, PLATFORM ou SYSTEM
blame_frame.symbol STRING O símbolo hidratado, ou símbolo bruto, se não for hidratável
breadcrumbs REGISTRO REPETIDO Google AnalyticsNavegação estrutural, com carimbo de data/hora, se ativado
breadcrumbs.name STRING O nome associado à navegação estrutural
breadcrumbs.params REGISTRO REPETIDO Parâmetros associados à navegação estrutural
breadcrumbs.params.key STRING Uma chave de parâmetro associada à navegação estrutural
breadcrumbs.params.value STRING Um valor de parâmetro associado à localização atual
breadcrumbs.timestamp TIMESTAMP O carimbo de data/hora associado à navegação estrutural
bundle_identifier STRING O identificador exclusivo do app como registrado no projeto do Firebase, por exemplo, com.google.gmail.
Para apps da plataforma Apple, é o ID do pacote do app.
Para apps Android, é o nome do pacote do app.
crashlytics_sdk_versions STRING A versão do SDK do Crashlytics que gerou o evento
custom_keys REGISTRO REPETIDO Pares de chave-valor definidos pelo desenvolvedor
custom_keys.key STRING Uma chave definida pelo desenvolvedor
custom_keys.value STRING Um valor definido pelo desenvolvedor
device RECORD O dispositivo em que o evento ocorreu
device_orientation STRING Por exemplo, PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN etc.
device.architecture STRING Por exemplo, X86_32, X86_64, ARMV7, ARM64, ARMV7S ou ARMV7K
device.manufacturer STRING O fabricante do dispositivo
device.model STRING O modelo do dispositivo
error REGISTRO REPETIDO (Apenas apps da Apple) Erros não fatais
error_type STRING O tipo de erro do evento (por exemplo, FATAL, NON_FATAL, ANR etc.)
error.blamed BOOLEANO Se o Crashlytics determinou que esse frame é a causa do erro
error.code INT64 Código de erro associado ao NSError personalizado registrado no app
error.frames REGISTRO REPETIDO Os frames do stack trace
error.frames.address INT64 O endereço na imagem binária que contém o código
error.frames.blamed BOOLEANO Se o Crashlytics determinou que esse frame é a causa do erro
error.frames.file STRING O nome do arquivo do frame
error.frames.library STRING O nome de exibição da biblioteca que inclui o frame
error.frames.line INT64 O número da linha no arquivo do frame
error.frames.offset INT64 O deslocamento de bytes na imagem binária que contém o código
error.frames.owner STRING Por exemplo, DEVELOPER, VENDOR, RUNTIME, PLATFORM ou SYSTEM
error.frames.symbol STRING O símbolo hidratado, ou símbolo bruto, se não for hidratável
error.queue_name STRING A fila em que a thread estava sendo executada
error.subtitle STRING A legenda da thread
error.title STRING O título da linha de execução
event_id STRING O ID exclusivo do evento
event_timestamp TIMESTAMP Quando o evento ocorreu
exceptions REGISTRO REPETIDO (Apenas Android) Exceções que ocorreram durante este evento. As exceções aninhadas são apresentadas em ordem cronológica inversa, o que significa que o último registro é a primeira exceção lançada
exceptions.blamed BOOLEANO Verdadeiro se o Crashlytics determinar que a exceção é responsável pelo erro ou pela falha
exceptions.exception_message STRING Uma mensagem associada à exceção
exceptions.frames REGISTRO REPETIDO Os frames associados à exceção
exceptions.frames.address INT64 O endereço na imagem binária que contém o código
não configurado para frames Java
exceptions.frames.blamed BOOLEANO Se o Crashlytics determinou que esse frame é a causa da falha ou do erro
exceptions.frames.file STRING O nome do arquivo do frame
exceptions.frames.library STRING O nome de exibição da biblioteca que inclui o frame
exceptions.frames.line INT64 O número da linha no arquivo do frame
exceptions.frames.offset INT64 O deslocamento de bytes na imagem binária que contém o código
não configurado para exceções Java
exceptions.frames.owner STRING Por exemplo, DEVELOPER, VENDOR, RUNTIME, PLATFORM ou SYSTEM
exceptions.frames.symbol STRING O símbolo hidratado, ou símbolo bruto, se não for hidratável
exceptions.nested BOOLEANO Verdadeiro para todas, exceto a última exceção lançada (ou seja, o primeiro registro)
exceptions.subtitle STRING A legenda da thread
exceptions.title STRING O título da linha de execução
exceptions.type STRING O tipo de exceção (por exemplo, java.lang.IllegalStateException)
firebase_session_id STRING O ID gerado automaticamente para a sessão do Firebase mapeada para o evento de Crashlytics
installation_uuid STRING Um ID que identifica um app e uma instalação exclusivos no dispositivo
is_fatal BOOLEANO Se o app apresentou uma falha
issue_id STRING O problema associado ao evento
logs REGISTRO REPETIDO Mensagens de registro com carimbo de data/hora geradas pelo registrador do Crashlytics, se ativadas
logs.message STRING A mensagem registrada
logs.timestamp TIMESTAMP Quando o registro foi feito
memory RECORD O status da memória do dispositivo
memory.free INT64 Bytes de memória restantes
memory.used INT64 Bytes de memória usados
operating_system RECORD Os detalhes do SO no dispositivo
operating_system.device_type STRING O tipo de dispositivo (por exemplo, MOBILE, TABLET, TV etc.), também conhecido como categoria do dispositivo
operating_system.display_version STRING A versão do SO no dispositivo
operating_system.modification_state STRING Se o dispositivo foi modificado (por exemplo, um app com jailbreak é MODIFIED e um app com acesso root é UNMODIFIED)
operating_system.name STRING O nome do SO no dispositivo
operating_system.type STRING (Somente apps da Apple) O tipo de SO em execução no dispositivo (por exemplo, IOS, MACOS etc.)
platform STRING A plataforma do app registrada no projeto do Firebase (valores válidos: IOS ou ANDROID)
process_state STRING BACKGROUND ou FOREGROUND
storage RECORD Armazenamento permanente do dispositivo
storage.free INT64 Bytes de armazenamento restantes
storage.used INT64 Bytes de armazenamento usados
threads REGISTRO REPETIDO Linhas de execução presentes no momento em que ocorreu o evento
threads.blamed BOOLEANO Se o Crashlytics determinou que esse frame é a causa da falha ou do erro
threads.code INT64 (Apenas apps da Apple) Código do erro do NSError personalizado registrado pelo aplicativo
threads.crash_address INT64 O endereço do sinal que causou a falha do app. Presente apenas em threads nativas com falha
threads.crashed BOOLEANO Se a thread apresentou uma falha
threads.frames REGISTRO REPETIDO Os frames da linha de execução
threads.frames.address INT64 O endereço na imagem binária que contém o código
threads.frames.blamed BOOLEANO Se o Crashlytics determinou que esse frame é a causa do erro
threads.frames.file STRING O nome do arquivo do frame
threads.frames.library STRING O nome de exibição da biblioteca que inclui o frame
threads.frames.line INT64 O número da linha no arquivo do frame
threads.frames.offset INT64 O deslocamento de bytes na imagem binária que contém o código
threads.frames.owner STRING Por exemplo, DEVELOPER, VENDOR, RUNTIME, PLATFORM ou SYSTEM
threads.frames.symbol STRING O símbolo hidratado, ou bruto, se não for hidratável
threads.queue_name STRING (Apenas apps da Apple) A fila em que a linha de execução estava sendo executada
threads.signal_code STRING O código do sinal que causou a falha do app. Presente apenas em threads nativas com falha
threads.signal_name STRING O nome do sinal que causou a falha do app. Presente apenas em linhas de execução nativas com falha
threads.subtitle STRING A legenda da thread
threads.thread_name STRING O nome da thread
threads.title STRING O título da thread
unity_metadata.debug_build BOOLEANO Se esse é um build de depuração
unity_metadata.graphics_copy_texture_support STRING Suporte à cópia de texturas gráficas, conforme definido na API Unity
unity_metadata.graphics_device_id INT64 O identificador do dispositivo gráfico
unity_metadata.graphics_device_name STRING O nome do dispositivo gráfico
unity_metadata.graphics_device_type STRING O tipo de dispositivo gráfico
unity_metadata.graphics_device_vendor_id INT64 O identificador do fornecedor do processador gráfico
unity_metadata.graphics_device_vendor STRING O fornecedor do dispositivo gráfico
unity_metadata.graphics_device_version STRING A versão do dispositivo gráfico
unity_metadata.graphics_max_texture_size INT64 O tamanho máximo dedicado à renderização da textura
unity_metadata.graphics_memory_size_mb INT64 A memória gráfica em MBs
unity_metadata.graphics_render_target_count INT64 O número de destinos de renderização gráfica
unity_metadata.graphics_shader_level INT64 O nível de sombreador dos gráficos
unity_metadata.processor_count INT64 O número de processadores (núcleos)
unity_metadata.processor_frequency_mhz INT64 A frequência dos processadores em MHz
unity_metadata.processor_type STRING O tipo de processador
unity_metadata.screen_refresh_rate_hz INT64 Taxa de atualização da tela em Hz
unity_metadata.screen_resolution_dpi STRING O DPI da tela como um número de ponto flutuante
unity_metadata.screen_size_px STRING O tamanho da tela em pixels, formatado como largura x altura
unity_metadata.system_memory_size_mb INT64 O tamanho da memória do sistema em MBs
unity_metadata.unity_version STRING A versão do Unity em execução no dispositivo
user RECORD (Opcional) Informações coletadas sobre o usuário do app
user.email STRING Opcional: o endereço de e-mail do usuário
user.id STRING (Opcional) Um ID específico do app associado ao usuário
user.name STRING Opcional: o nome do usuário
variant_id STRING A variante do problema associada a este evento
Nem todos os eventos têm uma variante do problema associada.


Conjunto de dados de sessões do Firebase

Os dados de sessões do Firebase são exportados para um conjunto de dados do BigQuery chamado firebase_sessions. O conjunto de dados abrange todo o projeto, mesmo que tenha vários apps.

Tabelas

Por padrão, o Firebase cria tabelas individuais dentro do conjunto de dados de sessões do Firebase para cada app no seu projeto vinculado ao BigQuery.

As tabelas são nomeadas com base no identificador do app (com pontos convertidos em sublinhados) e anexadas à plataforma do app (_IOS ou _ANDROID). Por exemplo, os dados de um app Android com o nome do pacote com.google.test ficariam em uma tabela chamada com_google_test_ANDROID.

Linhas

Cada linha em uma tabela representa um evento de sessão que ocorreu.

Colunas

Se a exportação contínua para o BigQuery estiver ativada, a tabela em tempo real terá as mesmas colunas da tabela em lote.

Confira as colunas na tabela dos dados de sessões do Firebase exportados:

Nome do campo Tipo de dado Descrição
instance_id STRING O ID de instalação do Firebase (FID) do dispositivo. Identifica um app e uma instalação exclusivos no dispositivo.
session_id STRING O ID exclusivo desta sessão
first_session_id STRING O primeiro ID de uma série de sessões em que esta sessão está desde que o app foi iniciado a frio. Isso pode ser usado para agrupar todas as sessões que ocorreram desde uma inicialização a frio. Se for a primeira sessão, esse campo será igual a session_id.
session_index INTEGER A ordem em que essa sessão chegou depois que o app foi inicializado a frio. Para a primeira sessão após uma inicialização a frio, esse valor será 0. O índice será incrementado sempre que uma sessão for gerada sem uma inicialização a frio (por exemplo, após 30 minutos de inatividade).
event_type STRING O tipo de evento que ocorreu na sessão (por exemplo, SESSION_START)
event_timestamp TIMESTAMP O horário da ocorrência do evento
received_timestamp TIMESTAMP O horário em que o evento foi recebido pelo servidor do dispositivo.
performance_data_collection_enabled BOOLEANO Se a coleta de dados do SDK do Monitoramento de desempenho do Firebase estava ativada no momento da sessão.
crashlytics_data_collection_enabled BOOLEANO Se a coleta de dados do SDK do Firebase Crashlytics estava ativada no momento da sessão.
application RECORD Descreve o aplicativo
application.build_version STRING A versão de criação do aplicativo (por exemplo, 1523456)
application.display_version STRING A versão de exibição do aplicativo (por exemplo, 4.1.7)
device RECORD O dispositivo em que o evento ocorreu
device.model STRING O modelo do dispositivo
device.manufacturer STRING O fabricante do dispositivo. Para apps da plataforma Apple, esse valor será NULL.
operating_system RECORD Descreve o SO do dispositivo.
operating_system.display_version STRING A versão de exibição do sistema operacional (por exemplo, 10.2.1)
operating_system.name STRING O nome do sistema operacional
operating_system.type STRING O tipo de sistema operacional (por exemplo, IOS). Esse campo só é definido para dispositivos Apple.
operating_system.device_type STRING O tipo de dispositivo (por exemplo, MOBILE, TABLET, TV)