Set up docs MCPすべてのデータは、OpenTelemetry (OTel) collector を介して ClickStack Open Source または Managed ClickStack にインジェストされます。これは、ログ、メトリクス、トレース、セッションデータの主要なエントリポイントとして機能します。
これら 2 つのアーキテクチャの主な違いは、コンポーネントをどこでホストするかにあります。どちらの場合も、アプリケーションからテレメトリーを受信するために OpenTelemetry Collector を実行します。ClickStack Open Source では、ClickHouse と ClickStack UI (HyperDX) も自分でホストおよび管理します。Managed ClickStack では、ClickHouse と HyperDX UI は ClickHouse Cloud でホストおよび管理され、認証統合や運用管理もあわせて提供されます。
どちらのデプロイメントモデルでも、collector は 2 つの OTLP エンドポイントを公開します。
- HTTP - ポート
4318 - gRPC - ポート
4317
これらのエンドポイントには、言語別 SDK から直接、または OTel 互換のデータ収集エージェント (例: インフラストラクチャのメトリクスやログを収集する他の OTel collector) からデータを送信できます。
より具体的には、次のとおりです。
-
言語別 SDK は、アプリケーション内部からテレメトリー、特に トレース と ログ を収集し、このデータを OTLP エンドポイント経由で OpenTelemetry collector にエクスポートします。collector はその後、ClickHouse へのインジェストを処理します。ClickStack で利用できる言語別 SDK の詳細については、SDKs を参照してください。
-
データ収集エージェント は、サーバー、Kubernetes ノード、またはアプリケーションの近くなど、エッジにデプロイされるエージェントです。これらはインフラストラクチャのテレメトリー (例: ログ、メトリクス) を収集したり、SDK でインストルメントされたアプリケーションから直接イベントを受信したりします。この場合、エージェントはアプリケーションと同じホスト上で動作し、多くの場合、サイドカーまたはデーモンセットとして実行されます。これらのエージェントはデータを中央の ClickStack OTel collector に転送し、この collector は ゲートウェイ として機能します。通常、クラスター、データセンター、またはリージョンごとに 1 つデプロイされます。ゲートウェイ は、エージェントまたはアプリケーションから OTLP イベントを受信し、ClickHouse へのインジェストを処理します。詳細については、OTel collector を参照してください。これらのエージェントには、OTel collector の別インスタンスや、Fluentd、Vector などの代替技術を使用できます。