Перейти к основному содержимому
Перейти к основному содержимому

HyperDX только

Этот вариант предназначен для пользователей, у которых уже есть работающий экземпляр ClickHouse, заполненный данными об наблюдаемости или событиях.

HyperDX может использоваться независимо от остальной части стека и совместим с любой схемой данных — не только с OpenTelemetry (OTel). Это делает его подходящим для пользовательских конвейеров наблюдаемости, уже построенных на ClickHouse.

Чтобы обеспечить полную функциональность, вам необходимо предоставить экземпляр MongoDB для хранения состояния приложения, включая панели управления, сохраненные поисковые запросы, настройки пользователей и оповещения.

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

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

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

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


Развертывание с Docker​

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

docker run -e MONGO_URI=mongodb://YOUR_MONGODB_URI -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx

Посетите http://localhost:8080, чтобы получить доступ к интерфейсу HyperDX.

Создайте пользователя, указав имя пользователя и пароль, соответствующий требованиям.

После нажатия Создать вам будут предложены данные для подключения.

HyperDX UI

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

Подключитесь к вашему собственному внешнему кластеру ClickHouse, например, ClickHouse Cloud.

HyperDX Login

Если вас просят создать источник, оставьте все значения по умолчанию и заполните поле Table значением otel_logs. Все остальные настройки должны быть автоматически обнаружены, что позволит вам нажать Сохранить новый источник.

Создание источника

Создание источника требует существования таблиц в ClickHouse. Если у вас нет данных, мы рекомендуем развернуть сборщик OpenTelemetry ClickStack для создания таблиц.

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

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

Сборщик OpenTelemetry ClickStack​

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

Для получения информации о развертывании и настройке автономного сборщика смотрите "Прием данных с помощью OpenTelemetry".

Поддержка типа JSON​

Beta feature. Learn more.

ClickStack имеет бета-поддержку типа JSON с версии 2.0.4.

Для получения преимуществ этого типа смотрите Преимущества типа JSON.

Чтобы включить поддержку типа JSON, пользователи должны установить следующие переменные окружения:

  • OTEL_AGENT_FEATURE_GATE_ARG='--feature-gates=clickhouse.json' - включает поддержку в OTel collector, гарантируя, что схемы создаются с использованием типа JSON.
  • BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true - включает поддержку в приложении HyperDX, позволяя запрашивать данные в формате JSON.

Для изображения только с HyperDX пользователям нужно установить параметр BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true, например,

docker run -e BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true -e MONGO_URI=mongodb://YOUR_MONGODB_URI -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx