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

> Архитектура ClickStack — стека обсервабилити ClickHouse

# Архитектура

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

Архитектура ClickStack зависит от способа развертывания. Между **ClickStack с открытым исходным кодом**, где всеми компонентами вы управляете самостоятельно, и **Управляемым ClickStack**, где ClickHouse и интерфейс HyperDX размещаются и обслуживаются в ClickHouse Cloud, есть важные архитектурные различия. Хотя в обеих моделях используются одни и те же основные компоненты, ответственность за размещение, масштабирование и защиту каждого компонента различается.

<div id="architecture-overview">
  ## Обзор архитектуры
</div>

Ниже представлен обзор архитектур управляемого ClickStack и ClickStack с открытым исходным кодом.

<Tabs>
  <Tab title="Управляемый ClickStack">
    Управляемый ClickStack полностью работает в **ClickHouse Cloud**, предоставляя полностью управляемый бэкенд для обсервабилити и сохраняя при этом ту же модель данных ClickStack и тот же пользовательский опыт.

    В этой модели **ClickHouse и ClickStack UI (HyperDX)** размещаются, эксплуатируются и защищаются в ClickHouse Cloud. Пользователи отвечают только за запуск **OpenTelemetry Collector (OTel)**, который отправляет данные телеметрии в управляемый сервис.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-managed-architecture.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=4bd46e99747688259613fb6272cc5a7c" alt="Управляемая архитектура" size="lg" width="1024" height="730" data-path="images/use-cases/observability/clickstack-managed-architecture.png" />

    ### ClickHouse Cloud: движок

    В основе Управляемого ClickStack лежит ClickHouse Cloud — бессерверная версия ClickHouse, столбцовой базы данных, созданной для Real-time аналитики в любом масштабе. Она обеспечивает ингестию и выполнение запросов к данным обсервабилити, позволяя:

    * Выполнять поиск по терабайтам событий с задержкой менее секунды
    * Обеспечивать ингестию миллиардов записей с высокой кардинальностью в день
    * Достигать высокого уровня сжатия — не менее 10x для данных обсервабилити
    * Использовать нативную поддержку полуструктурированных данных JSON, допускающую динамическое развитие схемы
    * Использовать мощный SQL-движок с сотнями встроенных аналитических функций

    ClickHouse Cloud обрабатывает данные обсервабилити как широкие события, обеспечивая глубокую корреляцию между журналами, метриками и трейсами в рамках единой унифицированной структуры.

    По сравнению с ClickHouse Open Source, он предоставляет ряд преимуществ для обсервабилити:

    * Автоматическое масштабирование вычислительных ресурсов независимо от хранилища
    * Недорогое и фактически неограниченное хранение на базе объектного хранилища
    * Возможность независимо изолировать рабочие нагрузки чтения и записи с помощью хранилищ
    * Встроенная аутентификация
    * Автоматические резервные копии
    * Возможности безопасности и соответствия требованиям
    * Обновления без простоев

    ### OpenTelemetry Collector: ингестия данных

    Управляемый ClickStack включает предварительно настроенный OpenTelemetry Collector (OTel) для ингестии телеметрии открытым стандартизированным способом. Вы можете отправлять данные по протоколу OTLP через:

    * gRPC (порт `4317`)
    * HTTP (порт `4318`)

    Коллектор экспортирует телеметрию в ClickHouse Cloud эффективными батчами. Он поддерживает оптимизированные схемы таблиц для каждого источника данных, обеспечивая масштабируемую производительность для всех типов сигналов.

    **Этот компонент архитектуры управляется пользователем**

    ### ClickStack UI (HyperDX): интерфейс

    ClickStack UI (HyperDX) — это пользовательский интерфейс ClickStack. Он предлагает:

    * Поиск на естественном языке и в стиле Lucene
    * Live tailing для отладки в реальном времени
    * Единое представление журналов, метрик и трейсов
    * Воспроизведение сеанса для frontend-обсервабилити
    * Создание панелей мониторинга и настройку оповещений
    * Интерфейс SQL-запросов для углублённого анализа

    Разработанный специально для ClickHouse, HyperDX сочетает мощный поиск с интуитивно понятными сценариями работы, позволяя быстро находить аномалии, исследовать проблемы и получать полезные выводы.

    В Управляемом ClickStack интерфейс интегрирован в систему аутентификации консоли ClickHouse Cloud.
  </Tab>

  <Tab title="ClickStack с открытым исходным кодом">
    Архитектура ClickStack с открытым исходным кодом построена вокруг трёх основных компонентов: **ClickHouse**, **HyperDX** и **коллектора OpenTelemetry (OTel)**. Экземпляр **MongoDB** обеспечивает хранение состояния приложения. Вместе они образуют высокопроизводительный стек обсервабилити с открытым исходным кодом, оптимизированный для журналов, метрик и трассировок.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-oss-architecture.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=ef032701999483f13e90067b296cc3da" alt="Архитектура" size="lg" width="1024" height="730" data-path="images/use-cases/observability/clickstack-oss-architecture.png" />

    ### ClickHouse: движок базы данных

    В основе ClickStack лежит ClickHouse — столбцовая база данных, созданная для Real-time аналитики в большом масштабе. Она обеспечивает ингестию и выполнение запросов к данным обсервабилити, позволяя:

    * Выполнять поиск по терабайтам событий с задержкой менее секунды
    * Принимать миллиарды записей с высокой мощностью в день
    * Достигать высокого уровня сжатия — не менее 10x для данных обсервабилити
    * Нативно поддерживать полуструктурированные данные JSON, что позволяет схеме динамически развиваться
    * Использовать мощный SQL-движок с сотнями встроенных аналитических функций

    ClickHouse обрабатывает данные обсервабилити как широкие события, обеспечивая глубокую корреляцию между журналами, метриками и трассировками в единой структуре.

    ### OpenTelemetry collector: ингестия данных

    ClickStack включает предварительно настроенный коллектор OpenTelemetry (OTel) для приёма телеметрии открытым стандартизованным способом. Вы можете отправлять данные по протоколу OTLP через:

    * gRPC (порт `4317`)
    * HTTP (порт `4318`)

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

    ### ClickStack UI (HyperDX): интерфейс

    ClickStack UI (HyperDX) — это пользовательский интерфейс ClickStack. Он предлагает:

    * Поиск на естественном языке и в стиле Lucene
    * Live tailing для отладки в реальном времени
    * Единое представление журналов, метрик и трассировок
    * Воспроизведение сеанса для frontend-обсервабилити
    * Создание панелей мониторинга и настройку оповещений
    * Интерфейс SQL-запросов для расширенного анализа

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

    ### MongoDB: состояние приложения

    ClickStack использует MongoDB для хранения состояния на уровне приложения, включая:

    * Панели мониторинга
    * Оповещения
    * Профили пользователей
    * Сохранённые визуализации

    Такое отделение состояния от данных событий обеспечивает производительность и масштабируемость, а также упрощает резервное копирование и конфигурирование.

    Эта модульная архитектура позволяет ClickStack предоставлять готовую к использованию платформу обсервабилити — быструю, гибкую и с открытым исходным кодом.
  </Tab>
</Tabs>
