Seus dados do Firebase Crashlytics podem ser exportados para o BigQuery. Depois que os dados estiverem no BigQuery, você poderá analisar os dados usando consultas SQL, criar visualizações de dados e painéis personalizados e até mesmo exportar os dados para outros serviços.
Nesta página, descrevemos como configurar a exportação de dados do Crashlytics e, opcionalmente, de sessões do Firebase para o BigQuery.
Configurar a exportação para BigQuery
No console do Firebase, acesse a guia Integrações.
No card do BigQuery, clique em Vincular.
Siga as instruções na tela para configurar a exportação para o BigQuery, incluindo as seguintes opções:
Para entender melhor os usuários e as sessões sem falhas, ative a exportação de dados de sessões do Firebase.
Para ter acesso quase em tempo real aos dados do Crashlytics e de sessões do Firebase no BigQuery, ative a exportação contínua.
Desvincular de BigQuery
Ao desvincular do BigQuery, você interrompe o preenchimento dos conjuntos de dados correspondentes no BigQuery.
Atente para o seguinte:
Todos os dados já exportados para BigQuery vão permanecer pelo período de retenção permitido, e as cobranças de armazenamento e consulta ainda poderão ser aplicadas. Você pode excluir manualmente seus conjuntos de dados para evitar outras cobranças.
Se você tiver dados do BigQuery armazenados em outros serviços, eles poderão ser regidos por termos diferentes de permanência de dados.
É possível desvincular do BigQuery no nível do projeto do Firebase, do produto ou do app para um produto específico.
Veja como desvincular do BigQuery:
No console do Firebase, acesse a guia Integrações.
No card do BigQuery, clique em Gerenciar.
Escolha desvincular um produto específico ou apps específicos de um produto específico.
Para desvincular totalmente seu projeto do Firebase, encontre o botão na parte de baixo da página.
Quando solicitado, confirme que você quer interromper as exportações.
O que acontece quando você ativa a exportação?
O Firebase exporta dados dos apps vinculados ao BigQuery.
Durante a configuração, por padrão, todos os apps no projeto são vinculados ao BigQuery, mas é possível selecionar para não vincular apps específicos durante a configuração.
Todos os apps adicionados posteriormente ao projeto do Firebase são vinculados automaticamente ao BigQuery.
É possível gerenciar quais apps exportam dados a qualquer momento.
O Firebase exporta dados para o local do conjunto de dados selecionado durante a configuração.
Esse local se aplica ao conjunto de dados Crashlytics e ao conjunto de dados de sessões do Firebase (se os dados de sessões estiverem ativados para exportação).
Esse local é aplicável apenas aos dados exportados para BigQuery e não afeta o local dos dados armazenados para uso no painel Crashlytics do console Firebase ou no Android Studio.
Depois que um conjunto de dados é criado, o local não pode ser alterado, mas é possível copiar o conjunto para um local diferente ou mover (recriar) manualmente o conjunto em um local diferente. Para saber mais, consulte Mudar o local das exportações atuais.
O Firebase configura as sincronizações diárias dos seus dados para o BigQuery.
Depois de vincular ao BigQuery, pode levar até 48 horas para a exportação de dados do lote inicial.
A sincronização diária acontece uma vez por dia, independentemente da exportação programada que você tenha configurado no BigQuery. Observação: o tempo e a duração do job de sincronização podem mudar. Portanto, não recomendamos programar operações ou jobs downstream com base em um tempo específico da exportação.
O Firebase exporta uma cópia dos dados existentes para o BigQuery.
Para cada aplicativo vinculado, essa exportação inclui uma tabela em lote contendo os dados da sincronização diária.
É possível configurar manualmente o preenchimento de dados da tabela de lote até os últimos 30 dias ou a data mais recente em que você ativou a exportação para BigQuery (o que for mais recente).
Se você tiver ativado a exportação de dados de Crashlytics antes de meados de outubro de 2024, também poderá preencher os dados 30 dias antes do dia em que ativou a exportação.
O Firebase faz o seguinte se você ativar a exportação contínua para o BigQuery.
Cada app vinculado também terá uma tabela em tempo real com dados sempre atualizados, além da tabela em lote do app para exportação diária.
Depois de ativar a exportação contínua, pode levar até uma hora para que os dados comecem a ser transmitidos.
Benefícios da exportação contínua para o BigQuery
Por padrão, os dados são exportados para BigQuery em uma exportação diária em lote. Além disso, é possível transmitir seus dados do Crashlytics e as sessões do Firebase em tempo real com o streaming do BigQuery. Use esses dados sempre que quiser acessar dados em tempo real, por exemplo, apresentar informações em um painel ativo, assistir a um lançamento ao vivo ou monitorar problemas de aplicativos que acionam alertas e fluxos de trabalho personalizados.
Ao ativar a exportação contínua para o BigQuery, você também terá tabelas em tempo real (além das tabelas em lote). Os dois tipos de tabelas têm o mesmo esquema de conjunto de dados, mas há algumas diferenças importantes entre as tabelas em lote e em tempo real:
| Tabela em lote | Tabela em tempo real |
|---|---|
|
|
A tabela em lote é ideal para análise de longo prazo e identificação de tendências ao longo do tempo, porque armazenamos eventos de maneira durável antes de gravá-los. Além disso, eles podem ser preenchidos na tabela por até 30 dias*. Quando gravamos dados na sua tabela em tempo real, eles são gravados imediatamente no BigQuery e, por isso, é ideal para painéis ativos e alertas personalizados. Essas duas tabelas podem ser combinadas com uma consulta de agrupamento para aproveitar os benefícios de ambas.
Por padrão, a tabela em tempo real tem um prazo de validade de partição de 30 dias. Para saber como mudar isso, consulte Definir a validade da partição na documentação do BigQuery.
* Confira detalhes sobre o suporte de preenchimento em Fazer upgrade para a nova infraestrutura de exportação.
Preços e o sandbox do BigQuery
Se o projeto do Firebase estiver no plano de preços do Spark sem custos financeiros, você poderá usar o sandbox do BigQuery, que oferece acesso sem custos financeiros ao BigQuery. Para informações sobre o sandbox do BigQuery e os recursos dele, consulte Como usar o sandbox do BigQuery.
Se o projeto do Firebase estiver no plano de preços Blaze de pagamento por uso, você poderá usar todos os recursos do BigQuery. O uso de BigQuery está sujeito aos preços do BigQuery, o que inclui o uso limitado e sem custos financeiros.
Fazer upgrade para a nova infraestrutura de exportação para BigQuery
Em meados de outubro de 2024, a Crashlytics lançou uma nova infraestrutura para a exportação em lote de dados de Crashlytics para BigQuery.
Se você ativou a exportação em lote depois de outubro de 2024, seu projeto do Firebase usa automaticamente a nova infraestrutura de exportação. Nenhuma ação é necessária.
Se você ativou a exportação em lote antes ou durante outubro de 2024, confira as informações em "Como fazer upgrade para a nova infraestrutura de exportação do BigQuery?" para determinar se é necessário tomar alguma medida.
A seguir
Analise exemplos de consultas SQL.
Crie painéis personalizados usando dados exportados e vários serviços do Google Cloud, como o Looker Studio.
Saiba mais sobre o esquema do conjunto de dados para dados exportados.