要点このガイドでは、Telflo が管理する OpenTelemetry Collector から ClickStack へテレメトリーを送信する方法を説明します。本ガイドで学べる内容は次のとおりです。
- Telflo のビジュアルエディターまたは CLI を使用して collector 設定 を作成する
- テレメトリーをオープンソース版または Managed ClickStack へ送信する、あるいは ClickHouse へ直接書き込む
- collector のフリートに 設定 をリモートでデプロイする
- テレメトリーが ClickStack または ClickHouse のテーブルに到達していることを確認する
Telfloとは？
Telfloは、OpenTelemetry Collector向けのベンダー中立なcontrol planeであり、フリート全体にわたるcollector 設定を一元管理できます。ビジュアルエディター、pipelineテスト、設定のリモートデプロイにより、大規模なフリートでも無理なく運用できます。Telfloが管理するのは標準のアップストリームOpenTelemetry collectorのbuildであり、Telflo専用のdistributionや独自のエージェントは存在しません。そのため、チームがすでに運用しているcollectorは同じbuildのまま使い続けられます。 Telfloはコマンドラインインターフェイスを通じて、ブラウザー外からも利用できます。これをClickStack MCPサーバーと組み合わせれば、テレメトリーを問い合わせるエージェントが、そのテレメトリーを生成したpipelineの修正まで行えるようになります。なぜ Telflo + ClickStack なのか？
ClickStack は、大量のデータのインジェスト、保存、分析クエリを処理します。Telflo は、ClickStack にデータを供給する OpenTelemetry Collector のフリートを、ホスト、クラスター、リージョンを横断して一元的に運用します。 Telflo が提供する機能:- ホスト、コンテナー、Kubernetes を横断した OpenTelemetry Collector の一元管理
- 視覚的なパイプライン編集と、フリート全体または単一グループへの制御されたロールアウト
- 本番環境の collector に反映される前に、サンプルテレメトリーで変更内容を検証
- 同一のテレメトリーを ClickStack と他の宛先へ同時にルーティング
- フリートの可視性: どの collector がオンラインか、各 collector が何を実行しているか、どれが設定のずれを起こしているか
前提条件
- 宛先: オープンソース版 ClickStack、Managed ClickStack、またはセルフマネージドの ClickHouse インスタンス
- Telflo アカウント (telflo.com でアカウントを作成)
- collector を実行する環境: VM または Kubernetes cluster
- オープンソース版 ClickStack: ClickStack の OTLP endpoint (HTTP は
4318、gRPC は4317) と、HyperDX の Team Settings → API Keys で確認できるインジェスト API key (詳細はこちらのドキュメントを参照) - Managed ClickStack: ClickHouse Cloud の service endpoint (ポート
8443) とインジェスト用ユーザー (インジェスト用ユーザーの作成 を参照) - Self-managed ClickHouse: ClickHouse の endpoint、ClickStack のテーブル 用の database、およびそれらを作成・書き込みできるユーザー (インジェスト用ユーザーの作成 を参照)
- collector から ClickStack または ClickHouse の endpoint への到達性 (ネットワーク接続)
ClickStack を Telflo と統合する
1
collector configuration を作成する
- Telflo にサインインします。Configurations 一覧で New Configuration をクリックし、続いて Blank configuration をクリックします。
- Name Your Configuration で名前を入力し、Create をクリックします。
- receiver を追加します。収集するテレメトリーの種類ごとに、パレットからキャンバスへ 1 つずつドラッグします。
- プロセッサを追加します。Memory Limiter と Batch に加え、collector から送出される前にデータを整形するために必要なプロセッサを追加します。Telflo がサポートするプロセッサの一覧を参照してください。
2
エクスポーターを追加する
3つのパスはいずれも同じエディター、同じパブリッシュ手順、同じフリートを使用し、異なるのはエクスポーターだけです。ご利用のデプロイ形態に応じたタブを選択してください。Open Source ClickStack ではインジェストキーを用いた OTLP を使用し、Managed ClickStack とセルフマネージドの ClickHouse では ClickStack のテーブルへ直接書き込みます。receiver からプロセッサを経由してエクスポーターへとエッジを描画し、シグナルごとに 1 つのパイプラインを構成します。status 行には config valid か、修正が必要なエラーの件数が表示され、YAML タブでは生成された設定を確認できます。実際に展開する前に、サンプルのテレメトリーを構成に流して、出力結果を確認できます。Telflo でのテストを参照してください。また、実現したい内容を説明するだけで、ツールバーの AI ボタンから開く Telflo AI アシスタントが構成の作成、検証、テストを代行します。独自のエージェントからも Telflo CLI を使って同じことが行えます。
- Open Source ClickStack
- Managed ClickStack
- Self-managed ClickHouse
- OTLP/HTTP エクスポーターをキャンバスにドラッグします。
- Endpoint に ClickStack の OTLP HTTP endpoint (例:
http://clickstack.example.com:4318) を指定します。 - HTTP Headers で Add header をクリックし、Header name に
authorization、Header value に${env:CLICKSTACK_INGESTION_KEY}を入力します。この値は collector のインストール時に Telflo から入力を求められるため、キーが configuration に保存されることはありません。
4317 で OTLP エクスポーターを使用し、同じ header を gRPC Metadata Headers に設定します。3
バージョンをパブリッシュする
ツールバーの Publish をクリックします。パブリッシュされたバージョンは読み取り専用です。引き続き編集する場合は、Create New Version をクリックします。
4
フリートを作成してデプロイする
- Fleet に移動し、New Fleet をクリックして、collector を実行する場所 (VM または Kubernetes) を選択します。Name を入力し、Create fleet をクリックします。
- フリートの Deploy Groups タブで、Default グループの Assign をクリックし、パブリッシュ済みの configuration と version を選択します。
- グループの Install をクリックし、configuration が参照する各 environment variable の値を入力します。Telflo がそれらをインストールコマンドに追加します。Telflo のインストール手順に従って、collector を実行させたい場所でそのコマンドを実行します。このコマンドには入力した値とともにフリートのインストール token が含まれるため、機密情報として扱ってください。
- Collectors タブでは、collector の状態が Pending pickup、Applying、In sync の順に報告されます。
5
テレメトリーを確認する
HyperDX を開き、Search ビューでいずれかのサービスを検索します。メトリクスの場合は Chart Explorer を使用します。Managed ClickStack では、ClickHouse Cloud console でサービスを開き、Launch ClickStack をクリックします。セルフマネージドの ClickHouse では、ClickStack のテーブルを直接クエリします。例:
SELECT ServiceName, count() FROM otel_logs GROUP BY ServiceName高度な設定
ファンアウトルーティング
同一のテレメトリーを、長期保存用の ClickStack、移行期間中の別プラットフォーム、セキュリティ分析用の SIEM へ同時に送信できます。キャンバス上にエクスポーターを追加し、データを流し込むパイプラインに接続してください。あるいは、Telflo のフローライブラリにある構築済みパイプラインから始めることもできます。圧縮とパフォーマンス
- OTLP/HTTP および OTLP エクスポーター: Compression は gzip のままにします。
- ClickHouse exporter: Async Insert は有効のまま、Compression は lz4 のままにし、その前段に Batch processor を追加します。Optimizing inserts を参照してください。
次のステップ
- ダッシュボードの構築: HyperDX でログ、メトリクス、トレースの可視化を作成します
- アラートの設定: ClickStack で重要な状態を監視するアラートを設定します
- AI アシスタントによる改善: パイプラインの調整やテストの提案を依頼できます
- 他ベンダーからの移行: flows は切り替え作業に対応しており、既にフリート上で稼働しているエージェントを置き換えつつ、比較期間中は両方のバックエンドへ二重送信できます