> ## 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.

# Встроено в ClickHouse

> Использование ClickStack, встроенного в ClickHouse Server, — стек обсервабилити ClickHouse

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

ClickStack встроен непосредственно в бинарный файл сервера ClickHouse. Это означает, что вы можете получить доступ к интерфейсу ClickStack (HyperDX) прямо из своего экземпляра ClickHouse, не развертывая никаких дополнительных компонентов. Такой вариант развертывания похож на публичное демо по адресу [play-clickstack.clickhouse.com](https://play-clickstack.clickhouse.com), но работает с вашим собственным экземпляром ClickHouse и вашими данными.

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

* первого знакомства с ClickStack с минимальной настройкой
* изучения собственных данных ClickHouse через интерфейс обсервабилити
* демонстраций и оценки

<div id="limitations">
  ### Ограничения
</div>

Эта встроенная версия **не предназначена для использования в продакшн-среде**. По сравнению с [готовыми для продакшна OSS-развертываниями](/ru/clickstack/deployment/oss) в ней недоступны следующие возможности:

* [Оповещения](/ru/clickstack/features/alerts)
* Сохранение [панелей мониторинга](/ru/clickstack/features/dashboards/overview) и [поиска](/ru/clickstack/features/search) — панели мониторинга и сохранённые поиски не сохраняются между сеансами
* Настраиваемые параметры запроса
* [Шаблоны событий](/ru/clickstack/features/event-patterns)

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

<Tabs>
  <Tab title="Docker">
    <Steps>
      <Step>
        ### Запустите ClickHouse

        Загрузите и запустите образ сервера ClickHouse, задав пароль:

        ```shell theme={null}
        docker run --rm -it -p 8123:8123 -e CLICKHOUSE_PASSWORD=password clickhouse/clickhouse-server:head-alpine
        ```

        <Tip>
          **Запуск без пароля**

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

          ```shell theme={null}
          docker run --rm -it -p 8123:8123 -e CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT=1 clickhouse/clickhouse-server:head-alpine
          ```
        </Tip>
      </Step>

      <Step>
        ### Откройте интерфейс ClickStack

        Откройте [http://localhost:8123](http://localhost:8123) в браузере и нажмите **ClickStack**.

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

        <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/zXCQbzXFHfeD9FBK/images/clickstack/deployment/embedded/authenticate.png?fit=max&auto=format&n=zXCQbzXFHfeD9FBK&q=85&s=4ea48f0f53a6768b6405df3c024187be" alt="Аутентификация" size="lg" width="3818" height="1938" data-path="images/clickstack/deployment/embedded/authenticate.png" />
      </Step>

      <Step>
        ### Создайте источник

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

        При чистой установке вам будет предложено создать источник. Укажите в поле **Table** нужное имя таблицы (например, `otel_logs`) и нажмите **Save New Source**.

        <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/zXCQbzXFHfeD9FBK/images/clickstack/deployment/embedded/inferred-source.png?fit=max&auto=format&n=zXCQbzXFHfeD9FBK&q=85&s=3a07cff85bf9b3ec48ca6f6cdca2598a" alt="Создать источник" size="lg" width="3820" height="1938" data-path="images/clickstack/deployment/embedded/inferred-source.png" />

        Если данных у вас пока нет, см. [ингестия данных](/ru/clickstack/ingesting-data), чтобы узнать о доступных вариантах.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Бинарный файл">
    <Steps>
      <Step>
        ### Запустите ClickHouse

        Скачайте и запустите ClickHouse:

        ```shell theme={null}
        curl https://clickhouse.com/ | sh
        ```

        <Accordion title="Необязательно: включить системные таблицы логов">
          Чтобы просматривать внутренние журналы и метрики самого ClickHouse, перед запуском сервера создайте фрагмент конфигурации в рабочем каталоге:

          ```shell theme={null}
          mkdir -p config.d && cat > config.d/query_logs.xml << 'EOF'
          <clickhouse>
              <query_log>
                  <database>system</database>
                  <table>query_log</table>
              </query_log>
              <query_thread_log>
                  <database>system</database>
                  <table>query_thread_log</table>
              </query_thread_log>
              <query_views_log>
                  <database>system</database>
                  <table>query_views_log</table>
              </query_views_log>
              <metric_log>
                  <database>system</database>
                  <table>metric_log</table>
              </metric_log>
              <asynchronous_metric_log>
                  <database>system</database>
                  <table>asynchronous_metric_log</table>
              </asynchronous_metric_log>
          </clickhouse>
          EOF
          ```

          После этого, открыв ClickStack, вы сможете создать **Log Source** для `system.query_log`:

          | Параметр             | Значение                                                                                                                                |
          | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
          | **Name**             | `Журналы запросов`                                                                                                                      |
          | **Database**         | `system`                                                                                                                                |
          | **Table**            | `query_log`                                                                                                                             |
          | **Timestamp Column** | `event_time`                                                                                                                            |
          | **Default Select**   | `event_time, query_kind, query, databases, tables, initial_user, projections, memory_usage, written_rows, read_rows, query_duration_ms` |
        </Accordion>

        Запустите сервер:

        ```shell theme={null}
        ./clickhouse server
        ```
      </Step>

      <Step>
        ### Откройте интерфейс ClickStack

        Откройте [http://localhost:8123](http://localhost:8123) в браузере и нажмите **ClickStack**. Подключение к локальному экземпляру будет создано автоматически.
      </Step>

      <Step>
        ### Создайте источник

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

        Если данных у вас пока нет, см. [ингестия данных](/ru/clickstack/ingesting-data), чтобы узнать о доступных вариантах.

        <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/zXCQbzXFHfeD9FBK/images/clickstack/deployment/embedded/inferred-source.png?fit=max&auto=format&n=zXCQbzXFHfeD9FBK&q=85&s=3a07cff85bf9b3ec48ca6f6cdca2598a" alt="Создать источник" size="lg" width="3820" height="1938" data-path="images/clickstack/deployment/embedded/inferred-source.png" />
      </Step>
    </Steps>
  </Tab>
</Tabs>

<div id="next-steps">
  ## Следующие шаги
</div>

Если вы готовы выйти за рамки оценки, рассмотрите вариант развертывания для продакшна:

* [All-in-One](/ru/clickstack/deployment/all-in-one) — один контейнер со всеми компонентами, включая постоянное хранение данных и аутентификацию
* [Docker Compose](/ru/clickstack/deployment/docker-compose) — отдельные компоненты для более гибкого управления
* [Helm](/ru/clickstack/deployment/helm) — рекомендуется для развертываний Kubernetes в продакшне
* [Управляемый ClickStack](/ru/clickstack/getting-started/managed) — полностью управляемый сервис в ClickHouse Cloud