Skip to main content
КраткоВ этом руководстве показано, как коррелировать мобильные сеансы bitdrift с backend-трассировками, уже хранящимися в ClickStack, с помощью контекста трассировки OpenTelemetry. Мобильная телеметрия остаётся в bitdrift — в ClickStack ничего не экспортируется. Вы узнаете, как:
  • Включить интеграции bitdrift для сетевых запросов и трассировки в мобильных приложениях
  • Включить трассировку для своего тенанта bitdrift и настроить его глубокие ссылки на экземпляр ClickStack
  • Перейти по идентификатору трассировки из мобильного сеанса bitdrift в интерфейс ClickStack (HyperDX)
bitdrift собирает подробную телеметрию на мобильном устройстве без выборки; ClickStack хранит и запрашивает backend-трассировку, когда запрос поступает в ваши сервисы, инструментированные OpenTelemetry.Требуемое время: 10–15 минут

​
Что такое bitdrift?

bitdrift — динамическая платформа обсервабилити, созданная специально для мобильных приложений. Она состоит из трех основных компонентов:
  • Capture SDK — легковесная кроссплатформенная библиотека на Rust с тонкими платформозависимыми обертками, которая записывает телеметрию в кольцевой буфер фиксированного размера на устройстве, а не сразу отправляет ее в потоковом режиме.
  • Плоскость управления, которая поддерживает постоянное двунаправленное подключение к каждому клиенту и передает новую конфигурацию в реальном времени, определяя, какие данные собираются и загружаются.
  • Платформа bitdrift, где рабочие процессы, временные шкалы сеансов, графики, issue и alerts преобразуют телеметрию мобильных приложений в полезную информацию, доступную через веб-интерфейс, CLI, AI agents и публичный API.
bitdrift хранит телеметрию мобильных приложений на периферии, пока она не потребуется, поэтому команды могут получить полный сеанс без выборки, приведший к сбою или проблеме с производительностью, вместо того чтобы работать с фиксированным, заранее отобранным набором сигналов. Платформа bitdrift Capture доступна как SaaS, размещаемый bitdrift, или как развертывание в собственной Cloud (либо в бакете) в вашем аккаунте AWS. Панель мониторинга bitdrift User Journey, показывающая пути пользователей к ANR.

​
Почему bitdrift + ClickStack?

ClickStack предоставляет инженерным командам решение для обсервабилити на базе ClickHouse, которое собирает, хранит и позволяет запрашивать данные из backend-сервисов, веб-интерфейсов и инфраструктуры. bitdrift расширяет эту основу на мобильные устройства, где возникает множество самых сложных проблем в продакшне.
  • bitdrift показывает, что происходило на устройстве: действия пользователя, состояние приложения, сетевые запросы, журналы, ошибки, аварийные завершения, показатели производительности и контекст сеанса.
  • ClickStack показывает, что происходило после того, как запрос достиг backend-сервисов: распределённые трассировки, зависимости сервисов, журналы, метрики, операции с базой данных и поведение инфраструктуры.
  • Контекст трассировки OpenTelemetry связывает эти данные.
Расследование может начаться со сбоя при оформлении заказа, медленной загрузки экрана, ошибки аутентификации или аварийного завершения в bitdrift. От сетевого запроса инженер переходит по идентификатору трассировки в интерфейс ClickStack на базе HyperDX и отслеживает прохождение запроса через backend-сервисы — без необходимости вручную восстанавливать картину по разрозненным временным меткам.
Основные выводы
  • bitdrift собирает несэмплированную телеметрию, нативную для мобильных устройств, во всех мобильных приложениях и связывает полученные идентификаторы трассировки с соответствующими backend-трассировками.
  • ClickStack хранит и позволяет запрашивать полученные распределённые трассировки в ClickHouse, а также отображает их в HyperDX.

​
Предварительные требования

​
Настройка трассировки

Настройка полностью выполняется на стороне bitdrift и включает три шага:
  1. Обратитесь в службу поддержки bitdrift с просьбой включить трассировку для вашего тенанта и настроить глубокие ссылки трассировок на ваш экземпляр ClickStack (HyperDX). Настройка глубоких ссылок определяет, куда ведут ссылки View Trace в интерфейсе ClickStack; без неё трассировки собираются, но ссылка View Trace не отображается.
  2. Включите сетевую интеграцию bitdrift для вашей платформы, чтобы заголовки трассировки передавались в исходящих запросах.
  3. Добавьте в рабочий процесс действие Start Tracing, чтобы включить трассировку для нужных сеансов.
Сведения о каждом шаге для конкретных платформ см. в разделе How bitdrift and ClickStack work together документации bitdrift. После настройки в строках журнала временной шкалы bitdrift и представлениях спанов отображается ссылка View Trace, передающая захваченный идентификатор трассировки в интерфейс ClickStack (HyperDX). Переход по ссылке View Trace из сеанса bitdrift к распределённой трассировке в интерфейсе ClickStack (HyperDX).

​
Гибкость развертывания

Интеграция работает как с самоуправляемым ClickStack, так и с ClickHouse Cloud, поскольку не влияет на способ поступления данных в ClickStack. bitdrift не экспортирует мобильную телеметрию в ClickStack: он получает контекст трассировки OpenTelemetry запроса на устройстве и связывает его с backend-трассировкой, которую ваши сервисы с инструментированием OpenTelemetry уже отправляют в ClickStack. Для создания ссылки View Trace bitdrift нужен лишь адрес вашего интерфейса ClickStack (HyperDX), поэтому изменения в развертывании ClickStack или его конвейере ингестии не требуются.

​
Дальнейшие шаги

  • Проследите реальное расследование: от сбоя мобильного приложения или медленного запроса в bitdrift до backend-трассировки в ClickStack
  • Создавайте панели мониторинга в ClickStack (HyperDX) для backend-сервисов, от которых зависит ваше мобильное приложение
  • Ознакомьтесь с песочницей bitdrift, чтобы понять, как работать с Capture
  • Начните бесплатный пробный период, чтобы добавить bitdrift в своё мобильное приложение

​
Подробнее

Последнее изменение 14 августа 2026 г.