Bindplane とは何ですか?
Bindplane は、OpenTelemetry Collector を一元管理するための OpenTelemetry ネイティブなテレメトリー パイプラインです。視覚的な設定編集、安全なロールアウト、パイプラインインテリジェンスを提供することで、大規模な collector 群の運用を簡素化します。
なぜ Bindplane + ClickStack なのか?
大規模環境では、OpenTelemetry Collector の管理運用がボトルネックになりがちです。ClickStack は非常に大規模なインジェストを処理できることを実証しており、実際に顧客は毎秒数 GB のテレメトリーを取り込み、数百 PB を保存しています。課題はクエリ性能そのものではなく、ClickHouse にデータを送り込む collector インフラストラクチャをいかに確実に運用するかへと移っています。
Bindplane は、次の機能によってこの課題を解決します。
- 数千台から 100 万台超までの OpenTelemetry Collector を一元管理
- 安全にワンクリックでロールアウトできる、視覚的な設定編集
- データが ClickStack に到達する前に、一貫して適用される自動リソース検出とエンリッチメント
- ファンアウトルーティングにより、同じテレメトリーストリームを ClickStack と他の宛先に同時に送信
- collector の健全性、スループット、エンドツーエンドのパフォーマンスを含む、パイプライン全体の可視性
前提条件
- ClickStack インスタンスが稼働していること (ローカル、Server、または ClickHouse Cloud)
- Bindplane アカウント (
app.bindplane.comでアカウントを作成) - Bindplane OTel Collector がインストールされていること (Install Your First Collector を参照)
- Bindplane collector から ClickStack の OTLP endpoint へのネットワーク接続
- ClickStack API Ingestion Key (ClickStack Team Settings > API Keys で確認できます。詳細はこちらのドキュメントを参照)
- 必要なネットワークポートが開放されていること (HTTP/s は
4318、gRPC は4317)
ClickStack と Bindplane を統合する
ClickStack を宛先として設定する
- Bindplane アカウントにログインします
- Library に移動します
- Add Destination をクリックします
- 利用可能な宛先の一覧から ClickStack を選択します
- 接続を設定します。
- Protocol: HTTP または gRPC を選択します (デフォルト: ポート
4318の HTTP) - Hostname: ClickStack の OTLPendpoint のホスト名または IP アドレスを入力します
- Port: ポート番号を入力します (HTTP は
4318、gRPC は4317) - API Ingestion Key: ClickStack の API Ingestion Key を入力します
- Protocol: HTTP または gRPC を選択します (デフォルト: ポート
- 宛先に名前を付けます (例: "ClickStack Production")
- Save をクリックして宛先を作成します
構成を作成する
ClickStack の宛先を設定したら、テレメトリーを処理してルーティングするための構成を作成します。
- Configurations → Create Configuration に移動します
- 構成に名前を付けます (例: "ClickStack Pipeline")
- デプロイ対象に応じて Collector Type と Platform を選択します
- SOURCES を追加します。
- Add Source をクリックして、80 種類以上の利用可能な SOURCES から選択します
- テスト用途では、トラフィックをシミュレートするテレメトリー生成 SOURCES を追加できます
- 本番環境では、実際のテレメトリー (ログ、メトリクス、トレース) の SOURCES を追加します
- ClickStack の宛先を追加します。
- Add Destination をクリックします
- 前の手順で作成した ClickStack の宛先を選択します
- 送信するテレメトリーの種類を選択します (Logs、Metrics、Traces、またはすべて)
プロセッサを追加する (任意)
Bindplane は、パイプラインインテリジェンスとプロセッサの推奨機能を提供します。次の目的でプロセッサを追加できます。
- Filter: 不要なテレメトリーを除外してデータ量を削減する
- Sample: 大量の トレース に sampling 戦略を適用する
- Enrich: リソース属性、labels、メタデータを追加する
- Transform: テレメトリーの構造や内容を変更する
- Batch: 効率的に送信できるようバッチサイズを最適化する
これらのプロセッサは、データが ClickStack に届く前に、collector フリート全体に一貫して適用されます。
collector をデプロイして rollout を開始する
-
構成に collector (BDOT Collector) を追加します。
- Bindplane の Agents に移動します
- Bindplane のインストール手順に従って、対象システムに Bindplane collector をインストールします
- 接続されると、collector 一覧に collector が表示されます
-
collector に構成を割り当てます。
- 使用する collector を選択します
- それらに ClickStack の構成を割り当てます
-
rollout を開始します。
- Start Rollout をクリックして構成をデプロイします
- Bindplane は rollout 前に構成を検証します
- Bindplane UI で rollout の状態を監視します

ClickStack でテレメトリーを確認する
構成が rollout されると、管理対象の collector フリートから ClickStack へテレメトリーが流れ始めます。
- ClickStack インスタンス (HyperDX UI) にログインします
- Logs、Metrics、または Traces のエクスプローラーに移動します
- Bindplane 管理下の collector から送られてくるテレメトリーデータが表示されるはずです
- ClickStack に到着するデータは、すでに Bindplane のプロセッサによって enrich され、構造化されています

詳細設定
ファンアウトルーティング
Bindplane はファンアウトルーティングをサポートしており、同じテレメトリーストリームを複数の宛先へ同時に送信できます。次のことが可能です。
- ログ、メトリクス、トレースを ClickStack に送信し、長期保存と分析に利用する
- 同じデータを他のオブザーバビリティプラットフォームにもルーティングし、リアルタイムのアラートに活用する
- 特定のテレメトリーを SIEM プラットフォームに転送し、セキュリティ分析に利用する
これは、Bindplane の構成に複数の宛先を追加することで設定できます。
圧縮とパフォーマンス
大量データを扱う環境では、ClickStack の宛先で圧縮を設定してください。
- HTTP: gzip、deflate、snappy、zstd、または none をサポート (デフォルト: gzip)
- gRPC: gzip、snappy、zstd、または none をサポート (デフォルト: gzip)
圧縮を有効にすると、ClickStack にテレメトリーを送信する際の帯域幅使用量を削減できます。特に大規模環境では重要です。
次のステップ
これで、Bindplane から ClickStack へテレメトリーが送られるようになったので、次のことができます。
- ダッシュボードを作成する: ClickStack (HyperDX) で、ログ、メトリクス、トレースの可視化を作成する
- アラートを設定する: 重要な状態に対するアラートを ClickStack で設定する
- デプロイメントをスケールする: オブザーバビリティのニーズの拡大に応じて、collector とログソースを追加する
- パイプラインを最適化する: Bindplane のパイプラインインテリジェンスを使用して、最適化の余地を特定する