> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Correlacionando sessões móveis do bitdrift com rastreamentos do ClickStack

> Correlacione sessões móveis do bitdrift com rastreamentos de backend no ClickStack usando o contexto de rastreamento do OpenTelemetry, sem exportar a telemetria móvel

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            Integração com parceiro
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<PartnerBadge />

<Info>
  **TL;DR**

  Este 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
</Info>

<div id="what-is-bitdrift">
  ## O que é a bitdrift?
</div>

[bitdrift](https://bitdrift.io/) é uma plataforma dinâmica de observabilidade desenvolvida especificamente para aplicativos móveis. Ela tem três componentes principais:

* **O [SDK Capture](https://bitdrift.io/feature/performance-centric)**, 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.

<Image img="https://mintcdn.com/private-7c7dfe99/3mS6b88R0boYl1UC/images/clickstack/bitdrift/bitdrift-user-journey-dashboard.png?fit=max&auto=format&n=3mS6b88R0boYl1UC&q=85&s=def374455b33795e2574aa193e30ed41" alt="Um dashboard User Journey da bitdrift mostrando caminhos até um ANR" size="lg" width="2440" height="1160" data-path="images/clickstack/bitdrift/bitdrift-user-journey-dashboard.png" />

*Um dashboard User Journey da bitdrift mostrando os caminhos que os usuários percorrem até um ANR.*

<div id="why-bitdrift-clickstack">
  ## Por que bitdrift + ClickStack?
</div>

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.

<Tip>
  **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.
</Tip>

<div id="prerequisites">
  ## Pré-requisitos
</div>

* **ClickStack** instalado e acessível a partir dos seus serviços de backend, seja autogerenciado ou no ClickHouse Cloud. Consulte [Primeiros passos com o ClickStack de código aberto](/docs/pt-BR/clickstack/getting-started/oss) ou [Primeiros passos com o ClickStack gerenciado](/docs/pt-BR/clickstack/getting-started/managed).
* Seus serviços de backend instrumentados com **OpenTelemetry** e enviando traces ao ClickStack. Consulte [Ingestão com OpenTelemetry](/docs/pt-BR/clickstack/ingesting-data/opentelemetry).
* O **bitdrift Capture SDK** integrado ao seu aplicativo móvel. Consulte a [documentação do SDK da bitdrift](https://docs.bitdrift.io/) para obter instruções de instalação.
* Uma **conta da bitdrift**, com [Suporte](https://bitdrift.io/contact-us) disponível para habilitar o rastreamento para seu tenant (o rastreamento é um recurso experimental que a bitdrift habilita por tenant).

<div id="configure-tracing">
  ## Configure o rastreamento
</div>

A configuração é feita inteiramente no bitdrift, em três etapas:

1. Peça ao [suporte do bitdrift](https://bitdrift.io/contact-us) 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](https://docs.bitdrift.io/product/integration-partners/clickhouse#how-bitdrift-and-clickstack-work-together) 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).

<Image img="https://mintcdn.com/private-7c7dfe99/3mS6b88R0boYl1UC/images/clickstack/bitdrift/bitdrift-view-trace.jpg?fit=max&auto=format&n=3mS6b88R0boYl1UC&q=85&s=1fc46073d05ada0d673c6c7e62033576" alt="Um trace do bitdrift vinculado a um trace distribuído na UI do ClickStack" size="lg" width="3977" height="1292" data-path="images/clickstack/bitdrift/bitdrift-view-trace.jpg" />

*Ao seguir um link View Trace de uma session do bitdrift para um trace distribuído na UI do ClickStack (HyperDX).*

<div id="deployment-flexibility">
  ## Flexibilidade de implantação
</div>

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.

<div id="next-steps">
  ## Próximas etapas
</div>

* **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](https://bitdrift.io/sandbox)** para entender como é trabalhar com o Capture
* **Inicie uma [avaliação gratuita](https://bitdrift.io/signup)** para adicionar o bitdrift ao seu aplicativo móvel

<div id="read-more">
  ## Leia mais
</div>

* [Documentação do bitdrift: integração com o ClickHouse](https://docs.bitdrift.io/product/integration-partners/clickhouse)
* [Primeiros passos com o ClickStack de código aberto](/docs/pt-BR/clickstack/getting-started/oss)
* [Ingestão com o OpenTelemetry](/docs/pt-BR/clickstack/ingesting-data/opentelemetry)