概要
HyperDXはClickStackの中心的コンポーネントで、ClickHouse上でログ・トレースの検索と可視化を高速かつ簡単に実現。 KibanaのClickHouse版ともいえる存在で、直感的なUIと柔軟なスキーマ対応が特徴。 OpenTelemetry対応で多様な言語・環境に対応し、APMやアラート、ダッシュボード機能も充実。 DockerやClickHouse Cloudで手軽に導入可能、既存環境との連携も容易。 OSSとしてMITライセンスで公開、活発なコミュニティと貢献の機会を提供。
HyperDXとは
- ClickStack の中核を担う 可観測性ツール
- ClickHouseクラスタ 上で ログ・トレースの検索と可視化 を実現
- Kibana のClickHouse版という位置付け
- 直感的なUI と Luceneライクな検索構文 (例:level:err)を提供
- SQL不要、必要ならSQLモードも利用可能
- スキーマ非依存 で既存のClickHouseスキーマにそのまま対応
- 高速な検索・可視化 をClickHouseのパフォーマンスで実現
- アノマリー分析 や イベントデルタ によるトレンド解析
- アラート設定 や ダッシュボード機能 も数クリックで利用可能
- ネイティブなJSONクエリ、 ライブテール 機能で常に最新のイベントを確認
- OpenTelemetry標準対応、多様な言語・プラットフォームをサポート
主な機能
- ログ・メトリクス・トレース・セッションリプレイ を一元管理
- ブラウザ、Node.js、Python など多彩なSDK・インテグレーション
- APM機能 でHTTPリクエストからDBクエリまでのパフォーマンス監視
- 高カーディナリティイベント のダッシュボード化
- アラート や 異常検知 で障害の早期発見
- ライブデモ や ドキュメント、 Discordコミュニティ でのサポート
導入・デプロイ方法
- Dockerコマンド一発 でHyperDXを起動可能
docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one- UIはhttp://localhost:8080 でアクセス
- ClickStack 構成:ClickHouse、HyperDX、OpenTelemetry Collector、MongoDBを含む
- 既存ClickHouseインスタンス への接続や 本番環境用デプロイ にも対応
- ファイアウォール 設定:8080(UI)、8000(API)、4318(OTel Collector)ポートを開放
- 最低4GB RAM/2コア を推奨
- ClickHouse Cloud でも利用可能、数分でセットアップ完了
アプリケーションのインストルメント
- アプリからのテレメトリデータ送信 が必要
- SDK/インテグレーション を利用して簡単に導入
- OpenTelemetry 互換、 Kubernetes/Javascript/Python/Java/Go/Ruby/PHP/.NET/Elixir/Rust など幅広く対応
- OpenTelemetry Collector (http://localhost:4318)へのデータ送信で連携完了
貢献とコミュニティ
- OSS(MITライセンス) で公開、誰でも貢献可能
- PR、バグ報告、ドキュメント改善、機能要望 など多様な貢献方法
- GitHub、Discord、メール での連絡手段
- 匿名の利用データ収集 (USAGE_STATS_ENABLEDで無効化可)、多様な環境対応のため協力を推奨
開発の動機・背景
- エンジニアが信頼性の高いソフトウェアを迅速に出荷 できることを支援
- 既存の可観測性ツールの課題
- コスト高騰、大容量テレメトリ時代にスケールしない
- 導入・運用が難解、専任SREや専門知識が必要
- ツール間の連携不足、情報の断片化
- ClickStack でこれらの課題を一括解決、OSSならではのコスト効率と柔軟性を実現
参考リンク・リソース
- GitHubリポジトリ: https://github.com/hyperdxio/hyperdx
- ライブデモ: https://play.hyperdx.io/
- 公式ドキュメント: https://clickhouse.com/docs/use-cases/observability/clicksta...
- Discordコミュニティ: https://hyperdx.io/discord
- ランディングページ: https://clickhouse.com/o11y
まとめ
- HyperDX/ClickStack は ClickHouse のパワーを活用し、 可観測性の民主化 を目指す
- 低コスト・高性能・OSS でエンジニアの運用負荷とコストを大幅に削減
- 多機能・直感的UI・高い拡張性 で現場のニーズに即応
- コミュニティ主導で進化中、フィードバック歓迎