Jaeger

Instana のホストエージェントを使用して、 Jaeger のトレースデータを取り込むことができます。

詳細については、 「 Instana ホストエージェント 」および「 Jaeger 」を参照してください。

セットアップ

Jaeger を設定するには、以下の手順を実行してください:

  1. Jaeger のトレースを出力するプロセスと同じホストに、 Instana のホストエージェントをインストールします。
  2. JAEGER_ENDPOINT 環境変数を http://localhost:42699/com.instana.plugin.jaeger.trace に設定します。これは、Jaeger トレース・プロセスがその IP アドレスおよびポートでホスト・エージェントに接続できることを前提とします。ただし、一部のコンテナー化された環境では、これは既定の事実ではありません。この場合、ネットワークのセットアップと JAEGER_ENDPOINT 環境変数の値が適宜調整されなければなりません。

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

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

  1. ホスト・エージェントは、 lsnsnsenter、および ssの各コマンドが使用可能な Linux システム上で実行されています。
  2. トレース・データを送信するプロセスは、ホスト・エージェントと同じホストで実行されています。
  3. プロセスを無視 」機能を使用しても、トレースデータを送信するプロセスは無視されません。
  4. トレースは、 OpenTelemetry Collectorなどのプロキシーを介して実行されるのではなく、ホスト・エージェントに直接報告されます。 トレース・データがプロキシーを経由する場合、プロキシーは代わりにトレースに関連付けられます。

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

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

既知の制限

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

  • Jaeger のトレースデータには、どのプロセスがホストエージェントにデータを送信しているかという情報が含まれていないため、 Instana は、それらのトレースをホストエージェントの基盤となっているホストと関連付けます。 これにより、プロセスとの関連付けが防止されるほか、コンテナおよびプラットフォームの階層構造(例: Kubernetes ポッド、ネームスペース、クラスター)も同様に防止されます。

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

  • ホスト・エージェントは、HTTP のみを介した Jaeger トレースの収集をサポートします。 JAEGER_AGENT_HOST および JAEGER_AGENT_PORT 環境変数を構成する場合に使用されるプロトコルである UDP は、サポートされません。