TL;DRCe 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)
Qu’est-ce que bitdrift ?
- Le SDK Capture, 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.
Pourquoi bitdrift + ClickStack ?
- 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.
Prérequis
- ClickStack installé et accessible depuis vos services backend, en version autogérée ou sur ClickHouse Cloud. Consultez Getting started with open source ClickStack ou Getting started with managed ClickStack.
- Vos services backend instrumentés avec OpenTelemetry et envoyant des traces vers ClickStack. Consultez Ingestion avec OpenTelemetry.
- Le SDK Capture de bitdrift intégré à votre application mobile. Consultez la documentation du SDK bitdrift pour les instructions d’installation.
- Un compte bitdrift, avec l’assistance Support disponible pour activer le traçage pour votre tenant (le traçage est une fonctionnalité expérimentale que bitdrift active pour chaque tenant).
Configurer le traçage
- Demandez au support de bitdrift 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.
- 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.
- Ajoutez une action de workflow Start Tracing afin d’activer le traçage pour les sessions qui vous intéressent.
Flexibilité de déploiement
Étapes suivantes
- 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 pour voir ce que permet Capture
- Démarrez un essai gratuit pour ajouter bitdrift à votre application mobile