このガイドでは、ClickHouse Cloud を評価中のエンタープライズチーム向けに、本番環境へのデプロイにおける監視およびオブザーバビリティ機能に関する包括的な情報を提供します。Enterprise のお客様からは、標準で利用できる監視機能、Datadog や AWS CloudWatch などのツールを含む既存のオブザーバビリティスタックとのインテグレーション、さらに ClickHouse Cloud の監視がセルフホストのデプロイと比べてどう異なるのかについて、よく質問が寄せられます。
ClickHouse Cloud は、監視セクションからアクセスできる組み込みのダッシュボードインターフェイスを通じて、包括的な監視機能を提供します。これらのダッシュボードでは、追加の設定なしでシステムメトリクスやパフォーマンスメトリクスをリアルタイムに可視化でき、ClickHouse Cloud における本番環境のリアルタイム監視の主要なツールとして利用できます。
- 高度なダッシュボード: 監視 → 高度なダッシュボード からアクセスできるメインのダッシュボードインターフェイスです。クエリレート、リソース使用量、システムヘルス、ストレージパフォーマンスをリアルタイムで可視化できます。このダッシュボードでは別途認証は不要で、インスタンスのアイドル状態への移行を妨げることもなく、本番システムにクエリ負荷を追加することもありません。各可視化はカスタマイズ可能な SQL クエリに基づいており、すぐに使える chart は、ClickHouse 固有、システムヘルス、Cloud 固有のメトリクスごとにグループ化されています。SQL Console で直接カスタムクエリを作成して、監視を拡張することもできます。
これらのメトリクスにアクセスしても、基盤となるサービスに対してクエリは発行されず、アイドル状態のサービスが起動することもありません。
- ネイティブの高度なダッシュボード: 監視セクション内の「You can still access the native advanced dashboard」からアクセスできる、別のダッシュボードインターフェイスです。これは認証付きで別タブに開き、システムとサービスのヘルスを監視するための代替 UI を提供します。このダッシュボードでは基盤となる SQL クエリを変更できるため、より高度な分析が可能です。
どちらのダッシュボードも、外部依存なしでサービスのヘルスとパフォーマンスを即座に可視化できる点で、ClickStack のような外部のデバッグ重視ツールとは異なります。
ダッシュボードの詳細な機能と利用可能なメトリクスについては、高度なダッシュボードのドキュメントを参照してください。
ClickHouse Cloud には、追加の監視機能が用意されています。
- クエリインサイト: クエリのパフォーマンス分析とトラブルシューティングのための組み込みインターフェイス
- リソース使用状況ダッシュボード: メモリ、CPU 割り当て、データ転送の傾向を追跡します。CPU 使用率とメモリ使用量のグラフには、特定の時間範囲における最大使用率メトリクスが表示されます。CPU 使用率グラフには、システムレベルの CPU 使用率メトリクス (ClickHouse の CPU 使用率メトリクスではありません) が表示されます。
各機能の詳細については、クエリインサイト と リソース使用状況 のドキュメントを参照してください。
Prometheus 互換メトリクス エンドポイント
- フィルタ済みメトリクスのオプション: オプションの
filtered_metrics=true パラメーターにより、1000 を超える利用可能なメトリクスのうち 125 個の「ミッションクリティカル」なメトリクスに payload を絞り込み、コスト最適化と監視対象の明確化を容易にします
- キャッシュされたメトリクス配信: 1 分ごとに更新される materialized view を使用して、本番システムのクエリ負荷を最小限に抑えます
このアプローチはサービスの idling の挙動を考慮しており、サービスがクエリをアクティブに処理していない場合のコスト最適化を可能にします。この API エンドポイントでは、ClickHouse Cloud API の credentials を使用します。エンドポイント設定の詳細については、Cloud の Prometheus documentation を参照してください。 このアプローチでは、HyperDX がシステムテーブルに直接クエリを実行するため、アイドル状態のサービスが起動される点に注意してください。
- ClickHouse Cloud 上の HyperDX (プライベートプレビュー) : HyperDX は任意の ClickHouse Cloud サービス上で起動できます。
- Helm: Kubernetes ベースのデバッグ環境に推奨されます。ClickHouse Cloud とのインテグレーションをサポートし、
values.yaml を使用して環境固有の設定、リソース制限、スケーリングを行えます。
- Docker Compose: 各コンポーネント (ClickHouse、HyperDX、OTel collector、MongoDB) を個別にデプロイします。ClickHouse Cloud とインテグレーションする場合は、未使用のコンポーネント、具体的には ClickHouse と OpenTelemetry Collector を削除できるように compose ファイルを変更できます。
- HyperDX Only: スタンドアロンの HyperDX コンテナー。
デプロイオプションの全体像とアーキテクチャの詳細については、ClickStack ドキュメント と データのインジェストガイド を参照してください。
OpenTelemetry Collector 経由で ClickHouse Cloud の Prometheus エンドポイントからメトリクスを収集し、可視化用に別の ClickStack デプロイメントへ転送することもできます。
Grafanaプラグインとの直接インテグレーション
このインテグレーションは、コスト最適化のためのアイドル時の挙動との非互換性に加え、Cloud のプロキシ層に運用上の制約があるため、ClickHouse Cloud へのデプロイには推奨されません。
system.query_log を直接クエリすることで、クエリパフォーマンスを詳細に分析できます。SQL コンソールまたは ClickHouse client を使用すると、チームは低速なクエリを特定し、リソース使用状況を分析し、組織全体での利用パターンを追跡できます。
クエリパフォーマンス分析
システムテーブルのクエリログを使用して、クエリパフォーマンス分析を行えます。
クエリ例: すべてのクラスター レプリカにわたって、実行時間の長いクエリの上位 5 件を見つけます。
ClickHouseコミュニティでは、一般的なオブザーバビリティスタックと統合できる包括的な監視ソリューションが開発されています。ClickHouse Monitoring は、あらかじめ用意されたダッシュボードを備えた完全な監視環境を提供します。このオープンソースプロジェクトは、確立されたベストプラクティスと実績あるダッシュボード構成を活用してClickHouseの監視を導入したいチームに、すぐに始められるアプローチを提供します。
他のデータベース直接監視の手法と同様に、このソリューションはClickHouseのシステムテーブルを直接クエリするため、インスタンスがアイドル状態にならず、コスト最適化に影響します。
