DatadogでClickHouseのデプロイメントを監視するために、ClickHouseでは、さまざまなデプロイメントモードに対応した複数のインテグレーションを提供しています。それぞれに利点とトレードオフがあり、ClickHouseが提供するものもあれば、Datadogが提供するものもあります。以下のインテグレーションは推奨順に並んでいます。
ClickHouse Cloud Datadog API インテグレーション
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 向けの 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の監視を導入したいチームに、すぐに始められるアプローチを提供します。
他のデータベース直接監視の手法と同様に、このソリューションはClickHouseのシステムテーブルを直接クエリするため、インスタンスがアイドル状態にならず、コスト最適化に影響します。
Billing & Usage API を使用すると、Cloud 組織の請求および使用状況の記録にプログラム経由でアクセスできます。これは、カスタムのコスト監視ダッシュボードを構築したり、請求データを既存の財務レポートのワークフローに統合したりする場合に役立ちます。
API リファレンスの詳細については、請求 API ドキュメントを参照してください。