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

# 커뮤니티 및 파트너 통합

> ClickHouse Cloud용 타사 모니터링 통합 및 청구 및 사용량 API

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>

Datadog에서 ClickHouse 배포를 모니터링하기 위해, ClickHouse는 다양한 배포 모드에 맞는 여러 통합을 제공합니다. 각 통합에는 고유한 장단점이 있으며, 일부는 ClickHouse에서 제공하고 다른 일부는 Datadog에서 제공합니다. 통합은 권장 순서대로 나열되어 있습니다.

| 통합                                                                                  | 문서                                                                                             | 배포          | 시그널              |
| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ----------- | ---------------- |
| [ClickHouse Cloud Datadog API 통합](#clickhouse-cloud-datadog-api-integration) *(권장)* | [docs.datadoghq.com](https://docs.datadoghq.com/integrations/clickhouse-cloud/)                | Cloud       | 메트릭              |
| [ClickHouse Cloud Prometheus 통합](#clickhouse-cloud-prometheus-integration)          | [clickhouse.com/docs](/docs/ko/integrations/prometheus)                                             | Cloud       | 메트릭              |
| [ClickHouse Datadog Agent 통합](#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 | 로그, 메트릭, 쿼리 인사이트 |

<div id="clickhouse-cloud-datadog-api-integration">
  ### ClickHouse Cloud Datadog API 통합
</div>

<PrivatePreviewBadge />

Datadog에서 ClickHouse Cloud의 서비스 수준 메트릭을 제공할 때 권장되는 방법입니다.

OAuth 핸드셰이크를 통해 Datadog 계정을 ClickHouse Cloud에 연결합니다(Datadog 통합 타일의 **Connect Accounts**). 그러면 Datadog가 서비스를 직접 폴링하는 대신 ClickHouse Cloud가 서비스 수준 메트릭을 Datadog로 푸시합니다.

* **Cloud 전용** — OSS ClickHouse에는 적합하지 않습니다
* 메트릭은 Datadog에서 사용자 지정 메트릭으로 처리되지 **않습니다**
* 서비스가 유휴 상태로 전환되는 것을 방지하지 **않습니다**
* 미리 구성된 대시보드와 모니터 세트가 함께 제공됩니다

온보딩 단계는 [Datadog의 ClickHouse Cloud 통합 가이드](https://docs.datadoghq.com/integrations/clickhouse-cloud/)를 참조하십시오.

<div id="clickhouse-cloud-prometheus-integration">
  ### ClickHouse Cloud Prometheus 통합
</div>

ClickHouse Cloud에서 서비스 수준 및 org 수준 텔레메트리를 수집하는 가장 일반적이고 범용적인 방법입니다.

Datadog Agent에서 [OpenMetrics 통합](https://docs.datadoghq.com/integrations/openmetrics/)을 구성하여 ClickHouse Cloud API를 주기적으로 폴링하고 메트릭을 수집합니다. 구성 세부 사항은 [Prometheus 통합 페이지](/docs/ko/integrations/prometheus#integrating-with-datadog)를 참조하세요.

* **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-agent` 대신 `datadog-cluster-agent`가 필요합니다
* **서비스가 유휴 상태로 전환되는 것을 막습니다**

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

ClickHouse용 Database Monitoring(DBM)은 Datadog에서 개발하고 유지 관리합니다. Datadog Agent가 ClickHouse 인스턴스에서 시스템 테이블(system tables) 데이터를 수집하도록 구성해, ClickHouse Cloud 콘솔이 네이티브로 제공하는 것과 유사한 쿼리 수준의 성능 인사이트를 제공합니다. 이 통합에는 ClickHouse가 관여하지 않으므로, 문제가 발생하면 ClickHouse가 아니라 Datadog에 문의하십시오.

* 메트릭은 무료이며, 로그 및 시스템 테이블 데이터 수집에는 추가 비용이 발생합니다
* **OSS ClickHouse:** 완전히 지원됩니다
* **ClickHouse Cloud (부분 지원):** `datadog-agent` 대신 `datadog-cluster-agent`가 필요합니다. **서비스가 유휴 상태로 전환되지 않습니다**

<div id="community-monitoring">
  ## 커뮤니티 모니터링 솔루션
</div>

ClickHouse 커뮤니티는 널리 사용되는 관측성 스택과 통합되는 종합적인 모니터링 솔루션을 개발해 왔습니다. [ClickHouse Monitoring](https://github.com/duyet/clickhouse-monitoring)은 사전 구축된 대시보드와 함께 완전한 모니터링 구성을 제공합니다. 이 오픈 소스 프로젝트는 검증된 대시보드 구성과 확립된 모범 사례를 바탕으로 ClickHouse 모니터링을 도입하려는 팀에 빠른 시작 방법을 제공합니다.

<Note>
  다른 직접 데이터베이스 모니터링 방식과 마찬가지로, 이 솔루션은 ClickHouse 시스템 테이블(system tables)을 직접 쿼리하므로 인스턴스가 유휴 상태로 전환되지 않으며 비용 최적화에도 영향을 줍니다.
</Note>

<div id="billing-usage-api">
  ## 청구 및 사용량 API
</div>

청구 및 사용량 API를 사용하면 Cloud 조직의 청구 및 사용량 기록에 프로그래밍 방식으로 액세스할 수 있습니다. 사용자 지정 비용 모니터링 대시보드를 구축하거나 청구 데이터를 기존 재무 보고 워크플로에 통합할 때 유용합니다.

전체 API 참조는 [Billing API 문서](/docs/ko/products/cloud/api-reference/billing/get-organization-usage-costs)를 참조하십시오.