@hyperdx/browser), который расширяет OpenTelemetry SDK возможностями записи сеанса, захвата консоли и сетевых запросов. Если вам нужны только трассировки без воспроизведения сеанса, с ClickStack будет работать любой совместимый с OTel браузерный SDK.
В примерах ниже используется Browser SDK ClickStack. Чтобы добавить воспроизведение сеанса в приложение, достаточно трёх шагов: установить пакет, инициализировать SDK — и все действия пользователя будут автоматически записываться без каких-либо дополнительных изменений в коде.
- NPM
- Yarn
- Тег script
Параметр
tracePropagationTargets критически важен для связывания воспроизведения сеансов с трассировками на бэкенде — укажите в нём домен вашего API, чтобы включить полную распределённую трассировку от фронтенда до бэкенда. Полный список параметров SDK, включая настройки конфиденциальности, пользовательские actions, границы ошибок React и source maps, см. в справочнике по Browser SDK.

tracePropagationTargets связывает спаны браузера со спанами сервера через заголовок traceparent, создавая единую распределённую трассировку от клика пользователя до самой базы данных. Подробный практический разбор, включая инструментирование как frontend, так и backend, см. в статье Instrumenting your NextJS application with OpenTelemetry and ClickStack.


hyperdx_sessions в ClickHouse, отдельно от журналов и трассировок. Каждое событие сеанса представляет собой строку с полем Body, содержащим полезную нагрузку события, и полем LogAttributes типа map, в котором хранятся метаданные события. Столбцы Body и LogAttributes вместе содержат сведения о самих событиях сеанса, которые используются для восстановления воспроизведения.
Полную информацию о схеме таблицы см. в разделе Таблицы и схемы, используемые ClickStack.
Есть два способа посмотреть воспроизведение сеанса в действии:
- Онлайн-пример — перейдите на clickpy.clickhouse.com, поработайте с приложением, а затем откройте воспроизведение своего сеанса на play-clickstack.clickhouse.com в источнике ClickPy Sessions. Подробнее о том, как был инструментирован ClickPy, см. в статье блога Instrumenting your NextJS application with OpenTelemetry and ClickStack.
- Локальное демо — демо воспроизведения сеанса пошагово показывает, как инструментировать демонстрационное приложение, включая локальный запуск ClickStack и просмотр своих записей.
- Демо воспроизведения сеанса — интерактивное локальное демо-приложение с пошаговыми инструкциями
- Справочник по Browser SDK — все возможности SDK, source maps, пользовательские действия и расширенная конфигурация
- Поиск — синтаксис поиска для фильтрации сеансов и событий
- Панели мониторинга — создавайте визуализации и панели мониторинга на основе данных сеансов и трассировки
- Оповещения — настройка оповещений об ошибках, задержках и других сигналах
- Архитектура ClickStack — как ClickHouse, HyperDX и OTel collector связаны между собой