Zipkin

Zipkin のトレースデータをインジェストする。

Instana のホストエージェントは、 Zipkin トレース形式の および v1 の両方で、 Zipkinv2 のトレースデータを取り込むことができます。

セットアップ

  1. 「 Zipkin 」トレースを出力するプロセスと同じホストに、 Instana ホストエージェントをインストールしてください。
  2. ホスト・エージェントのポート 42699 にトレースを送信するように Zipkin の HTTP コレクターを構成します。 ホスト・ローカル・プロセスの値の例は、 http://localhost:42699/api/v2/spansのようになります。 Zipkin で計測対象となっているプロジェクトごとに、設定方法は異なります。 したがって、その endpoint 設定について通常記載されている各ドキュメントを参照してください。

インフラストラクチャー相関

ホストエージェント 1.1.582( Zipkin )において、ホストエージェントが受信したトレースデータは、以下の前提条件が満たされている場合、そのデータを送信したプロセスと関連付けられます

  • ホストエージェントは Linux システム上で動作しており、以下のコマンドが利用可能です: lsns, nsenter, および ss
  • トレースデータを送信するプロセスは、ホストエージェントと同じホスト上で実行されています。
  • トレースデータを送信するプロセスは、「プロセスの無視 」機能によって無視されません。
  • トレースは、 OpenTelemetry Collector などのプロキシを経由するのではなく、ホストエージェントに直接送信されます。 トレース・データがプロキシーを経由する場合は、代わりにプロキシーがトレースに関連付けられます。

Application Perspective サービス・ダッシュボードは、このサービスに対して行われたインフラストラクチャーの変更など、関連するトレースが取り込まれたプロセスを正しく参照します。

これらの前提条件のいずれかが満たされていない場合、トレース・データは、ホスト・エージェントが実行されているホストと相関されます。

既知の制限

  • Zipkin から収集されるトレースデータは、 AutoTrace, を使用して収集されるトレースデータとは関連付けられていないため、 Zipkin、 Instana、および AutoTrace, でそれぞれトレースされたシステムが互いに直接やり取りしていたとしても、別々のトレースとして記録されます。

  • Zipkin にはユーザー・モニターの概念はありません (ただし、これは W3C TraceContextの採用によって最終的に変更される可能性があります)。 したがって、 Instana のWebサイト監視機能で収集されたビーコンは、 Zipkin から収集されたバックエンドのトレースとは関連付けられません。

  • ホスト・エージェントは、HTTP を介した Zipkin トレースの収集のみをサポートします。これは、Zipkin の COLLECTOR_HTTP_ENABLED設定に対応します。