Skip to main content
TL;DREste guia mostra como correlacionar sessões móveis do bitdrift com os traces de backend já armazenados no ClickStack, usando o contexto de rastreamento do OpenTelemetry. A telemetria móvel permanece no bitdrift — nada é exportado para o ClickStack. Você aprenderá a:
  • Ativar as integrações de rede e rastreamento do bitdrift em aplicativos móveis
  • Ativar o rastreamento para seu tenant do bitdrift e configurar os links diretos para sua instância do ClickStack
  • Seguir um ID de trace de uma sessão móvel no bitdrift até a UI do ClickStack (HyperDX)
O bitdrift captura telemetria detalhada, sem amostragem, no dispositivo móvel; o ClickStack armazena e consulta o trace de backend quando a solicitação chega aos seus serviços instrumentados com OpenTelemetry.Tempo necessário: 10 a 15 minutos

​
O que é a bitdrift?

bitdrift é uma plataforma dinâmica de observabilidade desenvolvida especificamente para aplicativos móveis. Ela tem três componentes principais:
  • O SDK Capture, uma biblioteca leve e multiplataforma desenvolvida em Rust, com wrappers específicos para cada plataforma, que grava telemetria em um buffer circular de tamanho fixo no dispositivo, em vez de transmiti-la imediatamente.
  • O plano de controle, que mantém uma conexão bidirecional persistente com cada cliente e envia novas configurações em tempo real, definindo o que é coletado e o que é enviado.
  • A plataforma bitdrift, em que fluxos de trabalho, linhas do tempo de sessões, gráficos, issues e alertas transformam a telemetria móvel em respostas, acessíveis pela interface web, CLI, agentes de IA e uma API pública.
A bitdrift mantém a telemetria móvel na borda até que ela seja solicitada, permitindo que as equipes extraiam a sessão completa, sem amostragem, que levou a uma falha ou a um problema de desempenho, em vez de trabalhar com um conjunto fixo de sinais pré-amostrados. A plataforma bitdrift Capture está disponível como SaaS hospedado pela bitdrift ou como uma implantação no modelo bring-your-own-cloud (ou bucket) na sua conta da AWS. Um dashboard User Journey da bitdrift mostrando os caminhos que os usuários percorrem até um ANR.

​
Por que bitdrift + ClickStack?

O ClickStack oferece às equipes de engenharia uma solução de observabilidade baseada no ClickHouse que coleta, armazena e consulta dados de serviços de backend, front-ends web e infraestrutura. O bitdrift estende essa base aos dispositivos móveis, onde surgem muitos dos problemas de produção mais difíceis.
  • O bitdrift mostra o que aconteceu no dispositivo: ações do usuário, estado do aplicativo, requisições de rede, logs, erros, falhas, travamentos, sinais de desempenho e o contexto da sessão.
  • O ClickStack mostra o que aconteceu depois que a requisição chegou ao backend: traces distribuídos, dependências entre serviços, logs, métricas, operações de banco de dados e comportamento da infraestrutura.
  • O contexto de rastreamento do OpenTelemetry conecta os dois.
Uma investigação pode começar com uma finalização de compra malsucedida, um carregamento lento de tela, um erro de autenticação ou uma falha no bitdrift. A partir da requisição de rede, um engenheiro segue o ID do trace até a UI do ClickStack, baseada no HyperDX, e acompanha a requisição pelos serviços de backend, sem precisar reconstruí-la manualmente a partir de timestamps dispersos.
Principais conclusões
  • O bitdrift captura telemetria móvel nativa e sem amostragem em aplicativos móveis e vincula os IDs de trace capturados aos respectivos traces de backend.
  • O ClickStack armazena e consulta o trace distribuído resultante no ClickHouse e o exibe no HyperDX.

​
Pré-requisitos

​
Configure o rastreamento

A configuração é feita inteiramente no bitdrift, em três etapas:
  1. Peça ao suporte do bitdrift para habilitar o rastreamento para seu tenant e configurar links diretos para traces na sua instância do ClickStack (HyperDX). Essa configuração direciona os links View Trace para a UI do ClickStack. Sem ela, os traces são capturados, mas nenhum link View Trace é exibido.
  2. Habilite a integração de rede do bitdrift para sua plataforma, para que os headers de rastreamento sejam propagados nas requests de saída.
  3. Adicione uma ação de workflow Start Tracing para habilitar o rastreamento nas sessões que você deseja monitorar.
Para ver os detalhes específicos de cada plataforma em cada etapa, consulte Como o bitdrift e o ClickStack funcionam juntos na documentação do bitdrift. Depois da configuração, as linhas de log da linha do tempo do bitdrift e as visualizações de spans exibem um link View Trace que leva o trace ID capturado à UI do ClickStack (HyperDX). Ao seguir um link View Trace de uma session do bitdrift para um trace distribuído na UI do ClickStack (HyperDX).

​
Flexibilidade de implantação

A integração funciona tanto com o ClickStack autogerenciado quanto como uma oferta gerenciada no ClickHouse Cloud, pois não altera a forma como os dados chegam ao ClickStack. O bitdrift não exporta telemetria móvel para o ClickStack: ele captura o contexto de rastreamento do OpenTelemetry de uma solicitação no dispositivo e cria um link para o trace de backend que seus próprios serviços instrumentados com OpenTelemetry já enviam ao ClickStack. Tudo de que o bitdrift precisa é do endereço da UI do ClickStack (HyperDX) para criar o link View Trace. Portanto, não é necessário alterar a implantação do ClickStack nem o pipeline de ingestão.

​
Próximas etapas

  • Acompanhe uma investigação real de uma falha em um aplicativo móvel ou de uma solicitação lenta no bitdrift até o trace de backend no ClickStack
  • Crie dashboards no ClickStack (HyperDX) para os serviços de backend dos quais seu aplicativo móvel depende
  • Conheça o sandbox do bitdrift para entender como é trabalhar com o Capture
  • Inicie uma avaliação gratuita para adicionar o bitdrift ao seu aplicativo móvel

​
Leia mais

Última modificação em 14 de agosto de 2026