メインコンテンツへスキップ
メインコンテンツへスキップ

ClickStack - ClickHouse オブザーバビリティスタック

ランディングページ

ClickStack は ClickHouse 上に構築された本番運用レベルのオブザーバビリティプラットフォームであり、ログ、トレース、メトリクス、セッションを単一の高性能なソリューションとして統合します。複雑なシステムの監視とデバッグのために設計されており、開発者や SRE がツール間を行き来したり、タイムスタンプや相関 ID を使って手作業でデータを突き合わせたりすることなく、エンドツーエンドで問題を追跡できるようにします。

ClickStack の中核にあるのは、「すべてのオブザーバビリティデータは、情報量の多いワイドなイベントとして取り込むべきだ」というシンプルかつ強力な考え方です。これらのイベントはログ、トレース、メトリクス、セッションといったデータ種別ごとに ClickHouse のテーブルに保存されますが、データベースレベルで完全にクエリ可能であり、相互に関連付けて分析することができます。

ClickStack は、ClickHouse のカラム指向アーキテクチャ、ネイティブな JSON サポート、完全に並列化された実行エンジンを活用することで、高カーディナリティなワークロードを効率的に処理できるように構築されています。これにより、巨大なデータセットに対するサブ秒レイテンシのクエリ、長期間にわたる高速な集計、個々のトレースの詳細な調査が可能になります。JSON は圧縮されたカラムナ形式で保存されるため、手動での対応や事前定義なしにスキーマを柔軟に進化させることができます。

機能​

このスタックには、デバッグおよび根本原因分析のために設計された、主要な機能が複数含まれています。

  • ログ・メトリクス・セッションリプレイ・トレースをすべて 1 か所で相関付けて検索
  • スキーマに依存せず、既存の ClickHouse スキーマ上で動作
  • ClickHouse に最適化された超高速な検索と可視化
  • 直感的な全文検索およびプロパティ検索構文（例: level:err）、SQL は必須ではない
  • イベントの差分（event delta）により異常のトレンドを分析
  • 数回のクリックでアラートを設定
  • 複雑なクエリ言語なしで高カーディナリティなイベントをダッシュボード化
  • ネイティブな JSON 文字列クエリ
  • 常に最新のイベントを取得するためのログおよびトレースのライブテール表示
  • OpenTelemetry (OTel) を標準でサポート
  • HTTP リクエストから DB クエリ (APM) までの健全性とパフォーマンスを監視
  • 異常やパフォーマンス回帰を特定するためのイベントの差分（event delta）
  • ログのパターン認識

コンポーネント​

ClickStack は、次の3つのコアコンポーネントで構成されています。

  1. ClickStack UI (HyperDX) – オブザーバビリティデータを探索・可視化するための専用フロントエンド
  2. OpenTelemetry collector – ログ、トレース、メトリクス向けに、一定の前提に基づいて設計されたスキーマを備えた、カスタムビルドかつ事前設定済みのコレクター
  3. ClickHouse – スタックの中核となる高性能な分析データベース

これらのコンポーネントは、完全に セルフマネージドな ClickStack Open Source 構成としてまとめてデプロイすることも、マネージド環境とセルフホスト環境に分散してデプロイすることもできます。Managed ClickStack では、ClickHouse と HyperDX UI は ClickHouse Cloud 上でホストおよび運用され、ユーザーは OpenTelemetry Collector のみを実行します。

ブラウザベースの HyperDX UI も利用可能で、追加の UI インフラをデプロイすることなく、既存の ClickHouse デプロイメントに直接接続できます。

利用を開始するには、まず Getting started guide を参照し、その後に sample dataset を読み込みます。deployment options や production best practices に関するドキュメントもあわせて確認できます。

原則​

ClickStackは、オブザーバビリティスタックのあらゆるレイヤーにおいて、使いやすさ、パフォーマンス、柔軟性を優先する一連の中核となる原則に基づいて設計されています。

数分で簡単にセットアップ​

ClickStack は、あらゆる ClickHouse インスタンスおよびスキーマで導入直後から動作し、必要な設定は最小限です。新規導入でも既存環境との統合でも、数分で利用を開始できます。

使いやすく用途に特化​

HyperDX UI は SQL と Lucene スタイルの両方の構文をサポートしており、ユーザーは自分のワークフローに適したクエリインターフェースを選択できます。オブザーバビリティ向けに特別に設計されたこの UI は、チームが根本原因を迅速に特定し、複雑なデータをスムーズに探索できるよう最適化されています。

エンドツーエンドのオブザーバビリティ​

ClickStack は、フロントエンドのユーザーセッションから、バックエンドのインフラストラクチャのメトリクス、アプリケーションログ、分散トレースまでを対象としたフルスタックの可観測性を提供します。この統合されたビューにより、システム全体にわたる詳細な相関分析とインサイトの抽出が可能になります。

ClickHouse 向けに構築​

スタックの全レイヤーが、ClickHouse の機能を最大限に活用できるよう設計されています。クエリは ClickHouse の分析関数とカラム型エンジンを活用するよう最適化されており、大規模なデータに対する高速な検索と集約を実現します。

OpenTelemetry ネイティブ​

ClickStack は OpenTelemetry にネイティブ対応しており、すべてのデータを OpenTelemetry Collector のエンドポイント経由で取り込みます。上級ユーザー向けには、ネイティブなファイルフォーマット、カスタムパイプライン、Vector のようなサードパーティーツールを利用して、ClickHouse へデータを直接インジェストすることもサポートしています。

オープンソースで完全にカスタマイズ可能​

ClickStack は完全にオープンソースであり、あらゆる環境にデプロイできます。スキーマは柔軟でユーザーが変更可能であり、UI は変更を加えることなくカスタムスキーマに対応できるよう設計されています。コレクター、ClickHouse、UI を含むすべてのコンポーネントは、それぞれ独立してスケールできるため、インジェスト、クエリ、ストレージの要件に対応できます。

アーキテクチャ概要​

ClickStack のアーキテクチャは、デプロイ方法によって異なります。すべてのコンポーネントをセルフマネージドで運用する ClickStack Open Source と、ClickHouse と HyperDX UI が ClickHouse Cloud 上でホスト・運用される Managed ClickStack の間には、重要なアーキテクチャ上の違いがあります。両方のモデルで中核コンポーネントは同じですが、各コンポーネントのホスティング、スケーリング、セキュリティの責任分担が異なります。

Managed ClickStack architecture

Managed ClickStack は ClickHouse Cloud 上で完全に稼働し、同じ ClickStack のデータモデルとユーザー体験を維持しながら、フルマネージドなオブザーバビリティのバックエンドを提供します。

このモデルでは、ClickHouse と ClickStack UI (HyperDX) は ClickHouse Cloud によってホスト・運用・保護されます。ユーザーは、テレメトリーデータをマネージドサービスに送信するための OpenTelemetry Collector を実行するだけで済みます。

Managed ClickStack は次のコンポーネントで構成されます。

  1. ClickStack UI (HyperDX)
    HyperDX UI は ClickHouse Cloud に完全に統合され、サービスの一部としてマネージドされています。ログ検索、トレースの探索、ダッシュボード、アラート、テレメトリー種別をまたいだ相関分析を提供し、認証およびアクセス制御が統合されています。

  2. OpenTelemetry collector（セルフマネージド）
    ユーザーは、自身のアプリケーションおよびインフラストラクチャからテレメトリーデータを受信する OpenTelemetry Collector を実行します。このコレクターは、OTLP 経由で ClickHouse Cloud にデータを転送します。標準準拠の任意の OpenTelemetry Collector を使用できますが、ClickStack ディストリビューション の利用を強く推奨します。これは事前に構成されており、ClickHouse へのインジェストに最適化されていて、ClickStack のスキーマとそのまま連携します。

  3. ClickHouse Cloud
    ClickHouse は ClickHouse Cloud でフルマネージドされ、すべてのオブザーバビリティデータのストレージおよびクエリエンジンとして機能します。ユーザーはクラスタ管理、アップグレード、運用面の課題を気にする必要はありません。

Managed ClickStack には、次のような主な利点があります。

  • ストレージとは独立した コンピュートの自動スケーリング
  • オブジェクトストレージによって支えられた 低コストかつ事実上無制限の保持期間
  • ClickHouse Cloud Warehouses を利用した 読み取りと書き込みの分離
  • 統合された認証およびアクセス制御
  • 自動バックアップ
  • セキュリティおよびコンプライアンス機能
  • 運用停止を伴わないシームレスなアップグレード

このデプロイモデルにより、チームは ClickHouse や ClickStack UI 自体の運用を自ら行うことなく、オブザーバビリティのワークフローとインストルメンテーションに専念できます。

ClickStack を本番環境にデプロイするユーザーには、Managed ClickStack を推奨します。ClickHouse Cloud を用いた ClickStack のデプロイ手順については、はじめに ガイドを参照してください。