ClickStack へのデータ取り込み
All data は OpenTelemetry (OTel) collector を介して ClickStack Open Source または Managed ClickStack に取り込まれます。これは、ログ、メトリクス、トレース、およびセッションデータの主なエントリポイントとして機能します。
アーキテクチャ上の重要な違いは、コンポーネントがどこでホストされるかにあります。どちらの場合も、アプリケーションからのテレメトリデータを受信するために OpenTelemetry Collector を実行します。ClickStack Open Source では、ClickHouse と ClickStack UI (HyperDX) の両方を自分で管理およびホストします。Managed ClickStack では、ClickHouse と HyperDX UI は ClickHouse Cloud 上でホストおよび管理され、統合された認証および運用管理が提供されます。
- Managed ClickStack
- Open Source ClickStack
どちらのデプロイメントモデルでも、この collector は 2 つの OTLP エンドポイントを公開します:
- HTTP - ポート
4318 - gRPC - ポート
4317
ユーザーは、language SDKs から直接、または OTel 互換のデータ収集エージェント (例: インフラストラクチャのメトリクスやログを収集する他の OTel collector) から、これらのエンドポイントにデータを送信できます。
より具体的には:
-
Language SDKs はアプリケーション内部からのテレメトリ収集、特に トレース と ログ を担当し、このデータを OTLP エンドポイント経由で OpenTelemetry collector にエクスポートします。collector は ClickHouse へのインジェストを処理します。ClickStack で利用可能な language SDKs の詳細については、SDKs を参照してください。
-
データ収集エージェント は、サーバーや Kubernetes ノード、アプリケーションの横など、エッジにデプロイされるエージェントです。これらはインフラストラクチャのテレメトリ (例: ログ、メトリクス) を収集するか、SDK でインスツルメントされたアプリケーションからイベントを直接受信します。この場合、エージェントはアプリケーションと同じホスト上で動作し、多くの場合サイドカーまたはデーモンセットとして実行されます。これらのエージェントは、中央の ClickStack OTel collector にデータを転送します。これは通常、クラスタ、データセンター、またはリージョンごとに一度だけデプロイされる gateway として機能します。gateway はエージェントまたはアプリケーションからの OTLP イベントを受信し、ClickHouse へのインジェストを処理します。詳細については OTel collector を参照してください。これらのエージェントは、他のインスタンスの OTel collector である場合もあれば、Fluentd や Vector などの別のテクノロジーである場合もあります。
ClickStack は、拡張されたテレメトリと機能を備えた独自の language SDKs とカスタム OpenTelemetry を提供していますが、ユーザーは既存の OpenTelemetry SDKs やエージェントも引き続きシームレスに利用できます。
