요약이 가이드에서는 OpenTelemetry 추적 컨텍스트를 사용하여 bitdrift 모바일 세션을 ClickStack에 이미 저장된 백엔드 트레이스와 연관시키는 방법을 설명합니다. 모바일 텔레메트리는 bitdrift에 그대로 유지되며 ClickStack으로 내보내지지 않습니다. 다음 방법을 알아봅니다.
- 모바일 앱에서 bitdrift의 네트워킹 및 트레이싱 통합을 활성화합니다
- bitdrift 테넌트에서 트레이싱을 활성화하고 딥 링크가 ClickStack 인스턴스를 가리키도록 설정합니다
- bitdrift의 모바일 세션에서 트레이스 ID를 따라 ClickStack UI(HyperDX)로 이동합니다
bitdrift란 무엇인가요?
- Capture SDK: Rust로 구축되고 플랫폼별 얇은 래퍼를 갖춘 경량 크로스 플랫폼 라이브러리입니다. 텔레메트리를 즉시 외부로 스트리밍하는 대신 기기의 고정 크기 링 버퍼에 기록합니다.
- 컨트롤 플레인: 모든 클라이언트와 지속적인 양방향 연결을 유지하며, 새 구성을 실시간으로 푸시하고 수집 및 업로드할 항목을 결정합니다.
- bitdrift 플랫폼: 워크플로, 세션 타임라인, 차트, 이슈, 알림을 통해 모바일 텔레메트리에서 해답을 얻을 수 있으며, web UI, CLI, AI agents, 공개 API를 통해 액세스할 수 있습니다.
bitdrift + ClickStack을 사용하는 이유
- bitdrift는 기기에서 어떤 일이 일어났는지 보여 줍니다: 사용자 작업, 앱 상태, 네트워크 요청, 로그, 오류, 크래시, 성능 신호 및 관련 세션 컨텍스트를 확인할 수 있습니다.
- ClickStack은 요청이 백엔드에 도달한 후 어떤 일이 일어났는지 보여 줍니다: 분산 트레이스, 서비스 의존성, 로그, 메트릭, 데이터베이스 작업 및 인프라 동작을 확인할 수 있습니다.
- OpenTelemetry 추적 컨텍스트가 둘을 연결합니다.
사전 요구 사항
- 자가 관리형으로 설치했거나 ClickHouse Cloud에서 사용하는 ClickStack에 백엔드 서비스에서 연결할 수 있어야 합니다. 오픈 소스 ClickStack 시작하기 또는 관리형 ClickStack 시작하기를 참조하십시오.
- OpenTelemetry로 계측되고 ClickStack으로 trace를 전송하는 백엔드 서비스. OpenTelemetry를 사용한 수집을 참조하십시오.
- 모바일 앱에 통합된 bitdrift Capture SDK. 설치 방법은 bitdrift SDK 문서를 참조하십시오.
- bitdrift 계정 및 테넌트에서 트레이싱을 활성화할 수 있도록 Support에 문의할 수 있어야 합니다(트레이싱은 bitdrift가 테넌트별로 활성화하는 실험적 기능입니다).
트레이싱 구성
- bitdrift Support에 문의하여 테넌트의 트레이싱을 활성화하고 ClickStack(HyperDX) 인스턴스로 연결되는 트레이스 딥 링크를 구성해 달라고 요청하십시오. 딥 링크 구성은 ClickStack UI에서 View Trace 링크가 연결될 위치를 지정합니다. 이를 구성하지 않으면 트레이싱은 캡처되지만 View Trace 링크는 표시되지 않습니다.
- 플랫폼에서 bitdrift의 네트워크 통합을 활성화하여 아웃바운드 요청에 트레이싱 헤더가 전파되도록 하십시오.
- Start Tracing 워크플로 작업을 추가하여 필요한 세션의 트레이싱을 활성화하십시오.
배포 유연성
다음 단계
- bitdrift에서 발생한 실제 모바일 크래시 또는 느린 요청을 ClickStack의 백엔드 트레이스까지 추적해 보십시오
- 모바일 앱이 의존하는 백엔드 서비스를 위한 대시보드를 ClickStack(HyperDX)에서 구축하십시오
- Capture 사용 경험을 확인하려면 bitdrift sandbox를 살펴보십시오
- 모바일 앱에 bitdrift를 추가하려면 무료 체험을 시작하십시오