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

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

Аналогично 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 type support

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

JSON type support in ClickStack is a beta feature. While the JSON type itself is production-ready in ClickHouse 25.3+, its integration within ClickStack is still under active development and may have limitations, change in the future, or contain bugs.

ClickStack has beta support for the JSON type from version 2.0.4.

For the benefits of this type see Benefits of the JSON type.

In order to enable support for the JSON type users must set the following environment variables:

  • OTEL_AGENT_FEATURE_GATE_ARG='--feature-gates=clickhouse.json' - enables support in the OTel collector, ensuring schemas are created using the JSON type.
  • BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true - enables support in the HyperDX application, allowing JSON data to be queried.

Для образа, предназначенного только для локального режима, пользователям нужно задать параметр 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