コミュニティおよびパートナー向けインテグレーション

Datadogインテグレーション

DatadogでClickHouseのデプロイメントを監視するために、ClickHouseでは、さまざまなデプロイメントモードに対応した複数のインテグレーションを提供しています。それぞれに利点とトレードオフがあり、ClickHouseが提供するものもあれば、Datadogが提供するものもあります。以下のインテグレーションは推奨順に並んでいます。

インテグレーション	ドキュメント	デプロイメント	シグナル
ClickHouse Cloud Datadog APIインテグレーション (推奨)	docs.datadoghq.com	Cloud	メトリクス
ClickHouse Cloud Prometheusインテグレーション	clickhouse.com/docs	Cloud	メトリクス
ClickHouse Datadog Agentインテグレーション	docs.datadoghq.com	OSS / Cloud	ログ、メトリクス
ClickHouse Datadog DBM	datadoghq.com	OSS / Cloud	ログ、メトリクス、クエリインサイト

ClickHouse Cloud Datadog API インテグレーション

ClickHouse Cloud でのプライベートプレビュー

Datadog で ClickHouse Cloud のサービスレベルのメトリクスを利用するには、この方法が推奨されます。

Datadog アカウントを ClickHouse Cloud に OAuth ハンドシェイクで接続します (Datadog のインテグレーションタイルにある Connect Accounts) 。その後、ClickHouse Cloud がサービスレベルのメトリクスを Datadog にプッシュするため、Datadog がサービスを直接ポーリングする必要はありません。

Cloud のみ — OSS 版 ClickHouse には適していません
メトリクスは Datadog でカスタムメトリクスとしては扱われません
サービスがアイドル状態になるのを防ぐものではありません
あらかじめ設定されたダッシュボードとモニターが付属します

オンボーディング手順については、Datadog の ClickHouse Cloud インテグレーションガイドを参照してください。

ClickHouse Cloud Prometheus インテグレーション

ClickHouse Cloud からサービスレベルおよび組織レベルのテレメトリーを収集する、最も一般的で汎用性の高い方法です。

Datadog Agent を OpenMetrics インテグレーションで設定し、ClickHouse Cloud API を定期的にポーリングしてメトリクスを収集します。設定の詳細については、Prometheus インテグレーションのページを参照してください。

Cloud のみ — OSS 版 ClickHouse には適していません
メトリクスは Datadog で カスタムメトリクス として扱われます
サービスがアイドル状態になるのを防ぐものではありません

ClickHouse Datadog Agentインテグレーション

OSS版ClickHouseサービスからDatadogにデータを取り込む、最も一般的な方法です。いくつか注意点はありますが、ClickHouse Cloudでも利用できます。

Datadog Agentは定期的にClickHouseインスタンスをポーリングし、メトリクスとログを収集します。このインテグレーションには、あらかじめ設定されたダッシュボード一式が付属しています。

OSS ClickHouse: ログとメトリクスを完全にサポート。

ClickHouse Cloud (部分サポート) :

メトリクスのみ — ログはサポートされていません
datadog-agent ではなく datadog-cluster-agent が必要
サービスがアイドル状態に移行しなくなります

ClickHouse Datadog DBM

ClickHouse 向けの Database Monitoring (DBM) は、Datadog が開発・保守しています。Datadog Agent を設定して ClickHouse インスタンスからシステムテーブルのデータを収集することで動作し、ClickHouse Cloud Console がネイティブで提供するものと同様に、クエリレベルのパフォーマンス分析情報を得られます。ClickHouse はこのインテグレーションには関与していないため、問題がある場合は ClickHouse ではなく Datadog にお問い合わせください。

メトリクスは無料です。ログとシステムテーブルデータのインジェストには追加料金がかかります
OSS ClickHouse: 完全対応
ClickHouse Cloud (部分対応) : datadog-agent ではなく datadog-cluster-agent が必要です。サービスがアイドル状態になるのを防ぎます

コミュニティ監視ソリューション

ClickHouseコミュニティでは、一般的なオブザーバビリティスタックと統合できる包括的な監視ソリューションが開発されています。ClickHouse Monitoring は、あらかじめ用意されたダッシュボードを備えた完全な監視環境を提供します。このオープンソースプロジェクトは、確立されたベストプラクティスと実績あるダッシュボード構成を活用してClickHouseの監視を導入したいチームに、すぐに始められるアプローチを提供します。

請求と使用状況 API

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

API リファレンスの詳細については、請求 API ドキュメントを参照してください。