Корреляция мобильных сеансов bitdrift с трассировками ClickStack

bitdrift — динамическая платформа обсервабилити, созданная специально для мобильных приложений. Она состоит из трех основных компонентов:

• Capture SDK — легковесная кроссплатформенная библиотека на Rust с тонкими платформозависимыми обертками, которая записывает телеметрию в кольцевой буфер фиксированного размера на устройстве, а не сразу отправляет ее в потоковом режиме.
• Плоскость управления, которая поддерживает постоянное двунаправленное подключение к каждому клиенту и передает новую конфигурацию в реальном времени, определяя, какие данные собираются и загружаются.
• Платформа bitdrift, где рабочие процессы, временные шкалы сеансов, графики, issue и alerts преобразуют телеметрию мобильных приложений в полезную информацию, доступную через веб-интерфейс, CLI, AI agents и публичный API.

bitdrift хранит телеметрию мобильных приложений на периферии, пока она не потребуется, поэтому команды могут получить полный сеанс без выборки, приведший к сбою или проблеме с производительностью, вместо того чтобы работать с фиксированным, заранее отобранным набором сигналов. Платформа bitdrift Capture доступна как SaaS, размещаемый bitdrift, или как развертывание в собственной Cloud (либо в бакете) в вашем аккаунте AWS.

Панель мониторинга bitdrift User Journey, показывающая пути пользователей к ANR.

ClickStack предоставляет инженерным командам решение для обсервабилити на базе ClickHouse, которое собирает, хранит и позволяет запрашивать данные из backend-сервисов, веб-интерфейсов и инфраструктуры. bitdrift расширяет эту основу на мобильные устройства, где возникает множество самых сложных проблем в продакшне.

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

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

• Установленный ClickStack, доступный вашим backend-сервисам: самоуправляемый или в ClickHouse Cloud. См. Начало работы с ClickStack с открытым исходным кодом или Начало работы с управляемым ClickStack.
• Ваши backend-сервисы должны быть инструментированы с помощью OpenTelemetry и отправлять трассировки в ClickStack. См. Приём данных с OpenTelemetry.
• bitdrift Capture SDK, интегрированный в мобильное приложение. Инструкции по установке см. в документации bitdrift SDK.
• Аккаунт bitdrift с возможностью обратиться в службу поддержки, чтобы включить трассировку для вашего тенанта (трассировка — экспериментальная возможность, которую bitdrift включает для каждого тенанта отдельно).

Настройка полностью выполняется на стороне 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 в своё мобильное приложение

• Документация bitdrift: интеграция с ClickHouse
• Начало работы с ClickStack с открытым исходным кодом
• Приём данных через OpenTelemetry