Repolode
hyperdxio

hyperdxio/hyperdx

ClickHouse上でログ、トレース、メトリクス、セッションリプレイ、エラーを検索・可視化できるオープンソースのオブザーバビリティプラットフォーム。

代替できる製品:DatadogKibanaNew Relic

スター
9,963
フォーク
500
未解決の Issue
244
最終コミット
52 分前

これは何?

HyperDXは、ClickHouseクラスターに保存されたログやトレースを検索・可視化し、本番環境の問題の原因を特定するためのオブザーバビリティプラットフォームです。既存のClickHouseスキーマで動作し、テレメトリの収集にはOpenTelemetryを採用しているため、標準のOpenTelemetry SDKで計装されたアプリケーションで利用できます。

インターフェースでは、全文検索に加えて、level:errのようなプロパティ検索構文や任意のraw SQLを利用できます。ダッシュボードの作成、アラートの設定、ログやトレースのライブテーリングができるほか、セッションリプレイとバックエンドデータを関連付けられます。HTTPリクエストからデータベースクエリまで、アプリケーションパフォーマンスの監視にも対応しています。

HyperDXはローカルテスト用の単一Dockerコンテナとして実行できるほか、既存のClickHouseインスタンスにデプロイしたり、ClickHouse Cloudと組み合わせて利用したりできます。コマンドラインツールの@hyperdx/cliを使うと、ターミナルUIから同じデータにアクセスでき、スクリプトからの操作も可能です。

主な機能

  • 01ログ、トレース、メトリクス、セッションリプレイ、エラーを一元的に検索・関連付け。
  • 02任意のClickHouseスキーマで使えるプロパティ検索構文と、任意で利用できるraw SQL。
  • 03複雑なクエリ言語を使わずにダッシュボードとアラートを作成。
  • 04ログとトレースのライブテーリング。
  • 05ブラウザ、Node.js、Python向けSDKによるOpenTelemetryのネイティブなデータ取り込み。
  • 06HyperDXのデータをクエリできるターミナルUIとCLI。

ユースケース

  • セッションリプレイから、その背後にあるバックエンドのログやトレースをたどって本番環境のエラーを診断する。
  • 既存のClickHouseクラスター上でセルフホスト型のオブザーバビリティスタックを運用する。
  • HTTPリクエストからデータベースクエリまで、アプリケーションのパフォーマンスを監視する。
  • CLIを通じて、スクリプトやAIエージェントからテレメトリをクエリする。

クイックスタート

  1. 1

    DockerでオールインワンのHyperDXコンテナを起動します

    docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one
  2. 2

    ブラウザーで http://localhost:8080 を開いてUIにアクセスします

使う前に知っておきたいこと

  • テストには少なくとも4GBのRAMと2コアを推奨します。
  • フルデプロイにはClickHouse、OpenTelemetry Collector、MongoDBが含まれるため、セルフホスティングには運用上の作業が必要です。

トピック

よくある質問

hyperdx とは?
ClickHouse上でログ、トレース、メトリクス、セッションリプレイ、エラーを検索・可視化できるオープンソースのオブザーバビリティプラットフォーム。 HyperDXは、ClickHouseクラスターに保存されたログやトレースを検索・可視化し、本番環境の問題の原因を特定するためのオブザーバビリティプラットフォームです。既存のClickHouseスキーマで動作し、テレメトリの収集にはOpenTelemetryを採用しているため、標準のOpenTelemetry SDKで計装されたアプリケーションで利用できます。
hyperdx は無料で使えますか?ライセンスは?
hyperdx は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
hyperdx は今もメンテナンスされていますか?
活発にメンテナンス中。hyperdx の最終コミットは 2026年10月22日 です。
hyperdx は何に使えますか?
セッションリプレイから、その背後にあるバックエンドのログやトレースをたどって本番環境のエラーを診断する。 既存のClickHouseクラスター上でセルフホスト型のオブザーバビリティスタックを運用する。 HTTPリクエストからデータベースクエリまで、アプリケーションのパフォーマンスを監視する。 CLIを通じて、スクリプトやAIエージェントからテレメトリをクエリする。
hyperdx のインストール方法は?
DockerでオールインワンのHyperDXコンテナを起動します: docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one ブラウザーで http://localhost:8080 を開いてUIにアクセスします
hyperdx はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/hyperdxio/hyperdx

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト