Перейти к основному содержанию
Этот вариант предназначен для случаев, когда у вас уже есть работающий экземпляр ClickHouse, заполненный данными обсервабилити или событийными данными. HyperDX можно использовать независимо от остального стека, и он совместим с любой схемой данных, а не только с OpenTelemetry (OTel). Это делает его подходящим для собственных конвейеров обсервабилити, уже построенных на ClickHouse. Для полноценной работы необходимо предоставить экземпляр MongoDB для хранения состояния приложения, включая панели мониторинга, сохранённые поиски, пользовательские настройки и оповещения. В этом режиме вся ингестия данных полностью остаётся на стороне пользователя. Вы можете выполнять ингестию данных в ClickHouse, используя собственный OpenTelemetry Collector, прямую ингестию из клиентских библиотек, встроенные в ClickHouse движки таблиц (такие как Kafka или S3), ETL-конвейеры или управляемые сервисы ингестии, такие как ClickPipes. Такой подход обеспечивает максимальную гибкость и подходит для команд, которые уже эксплуатируют ClickHouse и хотят использовать поверх него HyperDX для визуализации, поиска и оповещений.

​
Подходит для

  • Действующих пользователей ClickHouse
  • Пользовательских конвейеров событий

​
Шаги развертывания


1

​
Развертывание с помощью Docker

Выполните следующую команду, при необходимости заменив YOUR_MONGODB_URI.
2

​
Перейдите в интерфейс HyperDX

Откройте http://localhost:8080, чтобы перейти в интерфейс HyperDX.Создайте пользователя, указав имя пользователя и пароль, соответствующие требованиям.После нажатия Create вам будет предложено ввести сведения о подключении.
3

​
Заполните сведения о подключении

Подключитесь к своему внешнему кластеру ClickHouse, например ClickHouse Cloud.Если будет предложено создать источник, оставьте все значения по умолчанию и укажите в поле Table значение otel_logs. Все остальные настройки должны быть определены автоматически, после чего вы сможете нажать Save New Source.
Создание источникаДля создания источника таблицы в ClickHouse уже должны существовать. Если данных у вас пока нет, мы рекомендуем развернуть коллектор ClickStack OpenTelemetry, чтобы создать таблицы.

​
Использование Docker Compose

Вы можете изменить конфигурацию Docker Compose, чтобы добиться того же эффекта, что и в этом руководстве, удалив из манифеста OTel collector и экземпляр ClickHouse.

​
ClickStack OpenTelemetry Collector

Даже если вы управляете собственным OpenTelemetry Collector отдельно от других компонентов стека, мы всё равно рекомендуем использовать дистрибутив коллектора ClickStack. Это гарантирует использование схемы по умолчанию и применение лучших практик ингестии. Подробнее о развертывании и настройке автономного коллектора см. в разделе “Ингестия через OpenTelemetry”.

​
Выбор схемы: Map или JSON

По умолчанию ClickStack хранит атрибуты в столбцах Map(LowCardinality(String), String). Это рекомендуемая схема для рабочих нагрузок обсервабилити. В сочетании с сериализацией Map по бакетам и текстовыми индексами по ключам и значениям в Map она обеспечивает точечные lookup-операции без накладных расходов на приём для каждого ключа, характерных для динамических подстолбцов JSON. Схема с типом JSON доступна в статусе бета для оценки на рабочих нагрузках с небольшим стабильным набором ключей атрибутов. Использовать её по умолчанию не рекомендуется. Полное сравнение и переменные окружения, необходимые для включения поддержки JSON, см. в разделе Map vs JSON type.
Последнее изменение 2 июля 2026 г.