> ## 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.

# Corréler les sessions mobiles bitdrift avec les traces ClickStack

> Corrélez les sessions mobiles bitdrift avec les traces backend dans ClickStack à l’aide du contexte de trace OpenTelemetry, sans exporter la télémétrie mobile

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>
            Intégration partenaire
        </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**

  Ce guide explique comment corréler les sessions mobiles bitdrift avec les traces backend déjà stockées dans ClickStack, à l’aide du contexte de trace OpenTelemetry. La télémétrie mobile reste dans bitdrift : rien n’est exporté vers ClickStack. Vous apprendrez à :

  * Activer les intégrations réseau et de traçage de bitdrift dans les applications mobiles
  * Activer le traçage pour votre tenant bitdrift et configurer ses liens profonds vers votre instance ClickStack
  * Suivre un ID de trace depuis une session mobile dans bitdrift jusqu’à l’UI ClickStack (HyperDX)

  bitdrift capture une télémétrie riche, non échantillonnée, sur l’appareil mobile ; ClickStack stocke et interroge la trace backend une fois que la requête atteint vos services instrumentés avec OpenTelemetry.

  Temps requis : 10 à 15 minutes
</Info>

<div id="what-is-bitdrift">
  ## Qu’est-ce que bitdrift ?
</div>

[bitdrift](https://bitdrift.io/) est une plateforme d’observabilité dynamique conçue spécifiquement pour les applications mobiles. Elle repose sur trois composants principaux :

* **Le [SDK Capture](https://bitdrift.io/feature/performance-centric)**, une bibliothèque légère et multiplateforme écrite en Rust, avec de fines couches d’abstraction spécifiques à chaque plateforme, qui écrit la télémétrie dans un tampon circulaire de taille fixe sur l’appareil, au lieu de la transmettre immédiatement en streaming.
* **Le plan de contrôle**, qui maintient une connexion bidirectionnelle persistante avec chaque client et pousse les nouvelles configurations en temps réel, déterminant ce qui est collecté et téléversé.
* **La plateforme bitdrift**, où les workflows, les chronologies de session, les graphiques, les issues et les alertes transforment la télémétrie mobile en informations exploitables, accessibles via l’interface web, la CLI, les agents IA et une API publique.

bitdrift conserve la télémétrie mobile en périphérie jusqu’à ce qu’elle soit demandée, afin que les équipes puissent récupérer la session complète non échantillonnée ayant conduit à un crash ou à un problème de performances, plutôt que de travailler à partir d’un ensemble fixe de signaux prééchantillonnés. La plateforme bitdrift Capture est disponible sous forme de SaaS hébergé par bitdrift ou en déploiement dans votre propre Cloud (ou bucket), au sein de votre compte 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="Un tableau de bord bitdrift User Journey affichant les parcours menant à un ANR" size="lg" width="2440" height="1160" data-path="images/clickstack/bitdrift/bitdrift-user-journey-dashboard.png" />

*Un tableau de bord bitdrift User Journey affichant les parcours empruntés par les utilisateurs jusqu’à un ANR.*

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

ClickStack offre aux équipes d’ingénierie une solution d’observabilité basée sur ClickHouse, qui collecte, stocke et interroge les données des services backend, des interfaces web et de l’infrastructure. bitdrift étend cette base aux appareils mobiles, où surviennent bon nombre des problèmes les plus complexes en production.

* **bitdrift montre ce qui s’est passé sur l’appareil** : actions des utilisateurs, état de l’application, requêtes réseau, logs, erreurs, crashs, signaux de performance et contexte de session associé.
* **ClickStack montre ce qui s’est passé une fois la requête arrivée au backend** : traces distribuées, dépendances entre services, logs, métriques, opérations de base de données et comportement de l’infrastructure.
* **Le contexte de trace OpenTelemetry relie les deux.**

Une investigation peut débuter par un checkout échoué, le chargement lent d’un écran, une erreur d’authentification ou un crash dans bitdrift. À partir de la requête réseau, un ingénieur suit l’ID de trace dans l’UI ClickStack, propulsée par HyperDX, et observe la requête traverser les services backend, sans avoir à reconstituer manuellement les événements à partir de timestamps dispersés.

<Tip>
  **Points clés**

  * **bitdrift** capture une télémétrie mobile native non échantillonnée dans les applications mobiles et relie les IDs de trace capturés à leur trace backend.
  * **ClickStack** stocke et interroge la trace distribuée résultante dans ClickHouse, puis l’affiche dans HyperDX.
</Tip>

<div id="prerequisites">
  ## Prérequis
</div>

* **ClickStack** installé et accessible depuis vos services backend, en version autogérée ou sur ClickHouse Cloud. Consultez [Getting started with open source ClickStack](/docs/fr/clickstack/getting-started/oss) ou [Getting started with managed ClickStack](/docs/fr/clickstack/getting-started/managed).
* Vos services backend instrumentés avec **OpenTelemetry** et envoyant des traces vers ClickStack. Consultez [Ingestion avec OpenTelemetry](/docs/fr/clickstack/ingesting-data/opentelemetry).
* Le **SDK Capture de bitdrift** intégré à votre application mobile. Consultez la [documentation du SDK bitdrift](https://docs.bitdrift.io/) pour les instructions d’installation.
* Un **compte bitdrift**, avec l’assistance [Support](https://bitdrift.io/contact-us) disponible pour activer le traçage pour votre tenant (le traçage est une fonctionnalité expérimentale que bitdrift active pour chaque tenant).

<div id="configure-tracing">
  ## Configurer le traçage
</div>

La configuration s’effectue entièrement côté bitdrift, en trois étapes :

1. Demandez au [support de bitdrift](https://bitdrift.io/contact-us) d’**activer le traçage pour votre tenant et de configurer des liens profonds vers les traces pour votre instance ClickStack (HyperDX)**. La configuration des liens profonds permet aux liens **View Trace** de pointer vers votre UI ClickStack ; sans elle, les traces sont capturées, mais aucun lien **View Trace** n’apparaît.
2. **Activez l’intégration réseau de bitdrift** pour votre plateforme afin que les en-têtes de traçage soient propagés avec les requêtes sortantes.
3. **Ajoutez une action de workflow Start Tracing** afin d’activer le traçage pour les sessions qui vous intéressent.

Pour connaître les détails propres à chaque plateforme pour chacune de ces étapes, consultez [How bitdrift and ClickStack work together](https://docs.bitdrift.io/product/integration-partners/clickhouse#how-bitdrift-and-clickstack-work-together) dans la documentation bitdrift.

Une fois la configuration effectuée, les lignes de log de la chronologie bitdrift et les vues de span affichent un lien **View Trace** qui transmet l’ID de trace capturé à l’UI 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="Une trace bitdrift renvoyant vers une trace distribuée dans l’UI ClickStack" size="lg" width="3977" height="1292" data-path="images/clickstack/bitdrift/bitdrift-view-trace.jpg" />

*Suivi d’un lien View Trace depuis une session bitdrift vers une trace distribuée dans l’UI ClickStack (HyperDX).*

<div id="deployment-flexibility">
  ## Flexibilité de déploiement
</div>

L’intégration fonctionne que ClickStack soit autogéré ou proposé en tant qu’offre gérée sur ClickHouse Cloud, car elle ne modifie pas la façon dont les données parviennent à ClickStack. bitdrift n’exporte pas la télémétrie mobile vers ClickStack : il capture le contexte de trace OpenTelemetry d’une requête sur l’appareil et crée un lien vers la trace backend que vos propres services instrumentés avec OpenTelemetry envoient déjà à ClickStack. Pour créer le lien **View Trace**, bitdrift a seulement besoin de l’adresse de votre UI ClickStack (HyperDX) ; aucune modification de votre déploiement ClickStack ni de son pipeline d’ingestion n’est donc nécessaire.

<div id="next-steps">
  ## Étapes suivantes
</div>

* **Suivez une investigation réelle**, d’un crash mobile ou d’une requête lente dans bitdrift jusqu’à la trace backend dans ClickStack
* **Créez des dashboards** dans ClickStack (HyperDX) pour les services backend dont dépend votre application mobile
* **Découvrez le [sandbox bitdrift](https://bitdrift.io/sandbox)** pour voir ce que permet Capture
* **Démarrez un [essai gratuit](https://bitdrift.io/signup)** pour ajouter bitdrift à votre application mobile

<div id="read-more">
  ## Pour en savoir plus
</div>

* [Documentation bitdrift : intégration ClickHouse](https://docs.bitdrift.io/product/integration-partners/clickhouse)
* [Prise en main de ClickStack open source](/docs/fr/clickstack/getting-started/oss)
* [Ingestion avec OpenTelemetry](/docs/fr/clickstack/ingesting-data/opentelemetry)