> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Только HyperDX

> Развертывание только HyperDX

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

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

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

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

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

<div id="suitable-for">
  ### Подходит для
</div>

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

<div id="deployment-steps">
  ## Шаги развертывания
</div>

<br />

<Steps>
  <Step>
    ### Развертывание с помощью Docker

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

    ```shell theme={null}
    docker run -e MONGO_URI=mongodb://YOUR_MONGODB_URI -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx
    ```
  </Step>

  <Step>
    ### Перейдите в интерфейс HyperDX

    Откройте [http://localhost:8080](http://localhost:8080), чтобы перейти в интерфейс HyperDX.

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

    После нажатия `Create` вам будет предложено ввести сведения о подключении.

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/Wpmp4N2VLv_V8ziJ/images/use-cases/observability/hyperdx-login.png?fit=max&auto=format&n=Wpmp4N2VLv_V8ziJ&q=85&s=a4a7f0f11f4ba3b35b9a6c6613b62f5e" alt="Интерфейс HyperDX" size="lg" width="3600" height="1900" data-path="images/use-cases/observability/hyperdx-login.png" />
  </Step>

  <Step>
    ### Заполните сведения о подключении

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/FZqG0tBuMc0GoOY1/images/use-cases/observability/hyperdx-2.png?fit=max&auto=format&n=FZqG0tBuMc0GoOY1&q=85&s=7b5a03c5b0e7f3ac5a446c49b020274c" alt="Вход в HyperDX" size="md" width="1966" height="1392" data-path="images/use-cases/observability/hyperdx-2.png" />

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

    <Info>
      **Создание источника**

      Для создания источника таблицы в ClickHouse уже должны существовать. Если данных у вас пока нет, мы рекомендуем развернуть коллектор ClickStack OpenTelemetry, чтобы создать таблицы.
    </Info>
  </Step>
</Steps>

<div id="using-docker-compose">
  ## Использование Docker Compose
</div>

Вы можете изменить [конфигурацию Docker Compose](/ru/clickstack/deployment/docker-compose), чтобы добиться того же эффекта, что и в этом руководстве, удалив из манифеста OTel collector и экземпляр ClickHouse.

<div id="otel-collector">
  ## ClickStack OpenTelemetry Collector
</div>

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

Подробнее о развертывании и настройке автономного коллектора см. в разделе ["Ингестия через OpenTelemetry"](/ru/clickstack/ingesting-data/collector#modifying-otel-collector-configuration).

<div id="schema-choice-map-vs-json">
  ## Выбор схемы: Map или JSON
</div>

По умолчанию ClickStack хранит атрибуты в столбцах `Map(LowCardinality(String), String)`. Это рекомендуемая схема для рабочих нагрузок обсервабилити. В сочетании с [сериализацией Map по бакетам](/ru/reference/data-types/map#bucketed-map-serialization) и текстовыми индексами по ключам и значениям в Map она обеспечивает точечные lookup-операции без накладных расходов на приём для каждого ключа, характерных для динамических подстолбцов JSON.

Схема с типом `JSON` доступна в статусе бета для оценки на рабочих нагрузках с небольшим стабильным набором ключей атрибутов. Использовать её **по умолчанию не рекомендуется**. Полное сравнение и переменные окружения, необходимые для включения поддержки JSON, см. в разделе [Map vs JSON type](/ru/clickstack/ingesting-data/schema/map-vs-json).