> ## 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 の Billing & Usage 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/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 のサービスレベルのメトリクスを利用するには、この方法が推奨されます。

Datadog アカウントを ClickHouse Cloud に OAuth ハンドシェイクで接続します (Datadog のインテグレーションタイルにある **Connect Accounts**) 。その後、ClickHouse Cloud がサービスレベルのメトリクスを Datadog にプッシュするため、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 からサービスレベルおよび組織レベルのテレメトリーを収集する、最も一般的で汎用性の高い方法です。

Datadog Agent を [OpenMetrics インテグレーション](https://docs.datadoghq.com/integrations/openmetrics/)で設定し、ClickHouse Cloud API を定期的にポーリングしてメトリクスを収集します。設定の詳細については、[Prometheus インテグレーションのページ](/docs/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 インスタンスからシステムテーブルのデータを収集することで動作し、ClickHouse Cloud Console がネイティブで提供するものと同様に、クエリレベルのパフォーマンス分析情報を得られます。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のシステムテーブルを直接クエリするため、インスタンスがアイドル状態にならず、コスト最適化に影響します。
</Note>

<div id="billing-usage-api">
  ## 請求と使用状況 API
</div>

Billing & Usage API を使用すると、Cloud 組織の請求および使用状況の記録にプログラム経由でアクセスできます。これは、カスタムのコスト監視ダッシュボードを構築したり、請求データを既存の財務レポートのワークフローに統合したりする場合に役立ちます。

API リファレンスの詳細については、[請求 API ドキュメント](/docs/ja/products/cloud/api-reference/billing/get-organization-usage-costs)を参照してください。