> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Интеграции с решениями сообщества и партнеров

> Сторонние интеграции для мониторинга и API Billing & Usage в ClickHouse Cloud

export const PrivatePreviewBadge = () => {
  return <div className="privatePreviewBadge">
            <div className="privatePreviewIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M5.33301 6.66667V4.66667V4.66667C5.33301 3.194 6.52701 2 7.99967 2V2C9.47234 2 10.6663 3.194 10.6663 4.66667V4.66667V6.66667" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path d="M8.00033 9.33337V11.3334" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path fillRule="evenodd" clipRule="evenodd" d="M11.333 14H4.66634C3.92967 14 3.33301 13.4033 3.33301 12.6666V7.99996C3.33301 7.26329 3.92967 6.66663 4.66634 6.66663H11.333C12.0697 6.66663 12.6663 7.26329 12.6663 7.99996V12.6666C12.6663 13.4033 12.0697 14 11.333 14Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'Закрытая предварительная версия в ClickHouse Cloud'}
        </div>;
};

<div id="direct-datadog">
  ## Интеграция с Datadog
</div>

Для мониторинга развертывания ClickHouse в Datadog ClickHouse предлагает несколько интеграций для разных вариантов развертывания. У каждой из них есть свои особенности и компромиссы: одни разрабатываются ClickHouse, другие — Datadog. Интеграции перечислены в рекомендуемом порядке.

| Интеграция                                                                                                 | Документация                                                                                   | Развертывание | Сигналы                          |
| ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------- | -------------------------------- |
| [Интеграция Datadog API для ClickHouse Cloud](#clickhouse-cloud-datadog-api-integration) *(рекомендуется)* | [docs.datadoghq.com](https://docs.datadoghq.com/integrations/clickhouse-cloud/)                | Cloud         | Метрики                          |
| [Интеграция Prometheus для ClickHouse Cloud](#clickhouse-cloud-prometheus-integration)                     | [clickhouse.com/docs](/docs/ru/integrations/prometheus)                                             | Cloud         | Метрики                          |
| [Интеграция Datadog Agent для ClickHouse](#clickhouse-datadog-agent-integration)                           | [docs.datadoghq.com](https://docs.datadoghq.com/integrations/clickhouse/?tab=host)             | OSS / Cloud   | Журналы, Метрики                 |
| [ClickHouse Datadog DBM](#clickhouse-datadog-dbm)                                                          | [datadoghq.com](https://www.datadoghq.com/product-preview/database-monitoring-for-clickhouse/) | OSS / Cloud   | Журналы, Метрики, Query Insights |

<div id="clickhouse-cloud-datadog-api-integration">
  ### Интеграция ClickHouse Cloud с API Datadog
</div>

<PrivatePreviewBadge />

Рекомендуемый способ передачи метрик уровня сервиса из ClickHouse Cloud в Datadog.

Вы подключаете свой аккаунт Datadog к ClickHouse Cloud с помощью OAuth-рукопожатия (**Connect Accounts** в плитке интеграции Datadog). Затем ClickHouse Cloud отправляет метрики уровня сервиса в Datadog вместо того, чтобы Datadog напрямую опрашивал сервис.

* **Только в ClickHouse Cloud** — не подходит для OSS ClickHouse
* Datadog **не** считает эти метрики пользовательскими
* **Не** предотвращает переход сервиса в состояние простоя
* Поставляется с предварительно настроенным набором панелей мониторинга и мониторов

Информацию по шагам онбординга см. в [руководстве Datadog по интеграции ClickHouse Cloud](https://docs.datadoghq.com/integrations/clickhouse-cloud/).

<div id="clickhouse-cloud-prometheus-integration">
  ### Интеграция Prometheus с ClickHouse Cloud
</div>

Самый распространённый и универсальный способ собирать телеметрию на уровне сервиса и организации в ClickHouse Cloud.

Настройте Datadog Agent с помощью [интеграции OpenMetrics](https://docs.datadoghq.com/integrations/openmetrics/) для периодического опроса ClickHouse Cloud API и сбора метрик. Подробные сведения о настройке см. на [странице интеграции Prometheus](/docs/ru/integrations/prometheus#integrating-with-datadog).

* **Только в ClickHouse Cloud** — не подходит для OSS ClickHouse
* В Datadog эти метрики учитываются как **пользовательские метрики**
* **Не** предотвращает переход сервиса в режим простоя

<div id="clickhouse-datadog-agent-integration">
  ### Интеграция ClickHouse с Datadog Agent
</div>

Это самый распространённый способ передачи данных из сервисов OSS ClickHouse в Datadog. Он также работает с ClickHouse Cloud, но с некоторыми оговорками.

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

**OSS ClickHouse:** журналы и метрики поддерживаются полностью.

**ClickHouse Cloud (частичная поддержка):**

* Только метрики — журналы не поддерживаются
* Требуется `datadog-cluster-agent` вместо `datadog-agent`
* **Не позволит сервису перейти в режим простоя**

<div id="clickhouse-datadog-dbm">
  ### ClickHouse Datadog DBM
</div>

Database Monitoring (DBM) для ClickHouse разрабатывает и поддерживает Datadog. Для этого Datadog Agent настраивается на сбор данных из системных таблиц экземпляра ClickHouse, что позволяет получать информацию о производительности на уровне запросов, аналогичную той, что встроенно доступна в ClickHouse Cloud Console. ClickHouse не участвует в этой интеграции — по всем проблемам обращайтесь в Datadog, а не в ClickHouse.

* Метрики бесплатны; отдельно оплачиваются журналы и ингестия данных из системных таблиц
* **OSS ClickHouse:** полностью поддерживается
* **ClickHouse Cloud (частичная поддержка):** требует `datadog-cluster-agent` вместо `datadog-agent`; **не даст сервису перейти в режим простоя**

<div id="community-monitoring">
  ## Решения сообщества для мониторинга
</div>

Сообщество ClickHouse разработало комплексные решения для мониторинга, интегрируемые с популярными стеками обсервабилити. [ClickHouse Monitoring](https://github.com/duyet/clickhouse-monitoring) предоставляет полноценное решение для мониторинга с преднастроенными дашбордами. Этот проект с открытым исходным кодом предлагает быстрый старт для команд, которые хотят внедрить мониторинг ClickHouse, опираясь на устоявшиеся лучшие практики и проверенные конфигурации дашбордов.

<Note>
  Как и другие подходы к прямому мониторингу базы данных, это решение выполняет запросы напрямую к системным таблицам ClickHouse, из-за чего инстансы не могут переходить в состояние простоя, что негативно сказывается на оптимизации затрат.
</Note>

<div id="billing-usage-api">
  ## API Billing & Usage
</div>

API Billing & Usage позволяет программно получать доступ к данным о биллинге и использовании вашей организации в Cloud. Это полезно при создании собственных панелей мониторинга затрат или интеграции данных о биллинге в существующие процессы финансовой отчетности.

Полное справочное описание API см. в [документации Billing API](/docs/ru/products/cloud/api-reference/billing/get-organization-usage-costs).