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

Только локальный режим

Аналогично all-in-one image, этот единый Docker-образ включает все компоненты ClickStack:

  • ClickHouse
  • HyperDX
  • OpenTelemetry (OTel) collector (слушает OTLP на портах 4317 и 4318)
  • MongoDB (для хранения постоянного состояния приложения)

Однако в этой сборке HyperDX аутентификация пользователей отключена

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

  • Демонстраций
  • Отладки
  • Разработки, где используется HyperDX

Этапы развертывания​


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

В локальном режиме интерфейс HyperDX разворачивается на порту 8080.

docker run -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx-local

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

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

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

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

Создание учетной записи

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

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

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

Beta feature. Learn more.
Beta Feature - not production ready

Поддержка типа JSON в ClickStack находится в статусе бета-версии. Хотя сам тип JSON готов к промышленной эксплуатации в ClickHouse 25.3+, его интеграция в ClickStack всё ещё активно разрабатывается и может иметь ограничения, изменяться в будущем или содержать ошибки.

Поддержка типа JSON в ClickStack доступна в статусе бета-версии, начиная с версии 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.

Для образа, предназначенного только для локального режима, пользователям нужно задать параметр BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true, например:

docker run -e BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx-local