インジェクションタイプの概要

ブラウザ RUM を使用するには、JavaScript エージェントを Web ページに挿入する必要があります。使用例によっては、いくつかのインジェクションタイプが使用できます。このページでは、さまざまなインジェクションタイプ、それらの機能、および各タイプを使用するタイミングについて説明します。

インジェクション方式の選択

エージェントを Web ページに挿入するために使用する手順が不明な場合は、次のガイドラインをこの順序で実行してください。

手動インジェクション

手動インジェクションは、すべてのプラットフォームとフレームワークでサポートされています。手動で挿入されるページを設定するには、次のようにします。

  • JavaScript エージェント ホスティング オプションを選択します。ユースケースに最も適したオプションについては、「JavaScript エージェント ホスティング オプション」を参照してください。

  • 各ページが JavaScript エージェントの場所を検出するように手動で構成すると、エージェントはページがブラウザによって生成されるときに実行されます。

アプリケーションでの手動インジェクションの使用方法については、「JavaScript エージェントの手動インジェクション」を参照してください。

自動インジェクション

サーバ側で Java または .NET アプリケーション エージェントを使用しており、アプリケーションが次のいずれかをサポートする環境で実行されている場合、自動インジェクションが使用できます。

  • Apache Jasper JSP コンパイラ（Java 用）または
  • ASP.NET または ASPX（.NET 用）または
  • ASP.NET Core（.NET 用、Windows サポートのみ）

サーバー側のアプリケーション エージェントが実行時にコードの挿入を完全に管理する場合、自動インジェクションを使用できる場合があります。アプリケーションでの自動インジェクションの使用方法については、「JavaScript エージェントの自動インジェクション」を参照してください。

補助インジェクション

補助インジェクションは 2 つの種類があります。いずれの場合も、作業の一部は手動で実行され、一部の作業はサーバ側の Java または .NET アプリケーション エージェントによって実行されます。

注: 補助インジェクションは、現在 .NET Core ではサポートされていません。

インジェクションルールを使用した補助インジェクション（Java のみ）

このタイプの補助インジェクションでは、アプリケーションの出力ストリームに書き込むアプリケーションサーバー Java クラスとメソッド、およびその書き込みを実行するために使用するライターオブジェクトを定義するルールを構成します。Splunk AppDynamics はメソッドを代行受信し、JavaScript エージェントを出力ストリームに挿入します。また、この方法で、インストゥルメント化するサーバ側ビジネストランザクションの指定も行います。

この形式の補助インジェクションの使用方法の詳細については、「補助インジェクション」を参照してください。

属性インジェクションを使用した補助インジェクション

このタイプの補助インジェクションでは、フレームワークに適した小さなコードスニペットをページテンプレートまたはページを作成するその他のコードにコピーします。このスニペットには 2 つの変数 JS_HEADER と JS_FOOTER が含まれていて、アプリケーション エージェントが実行時の応答オブジェクト内の適切な情報に置き換えます。

この形式の補助インジェクションの使用方法の詳細については、「属性インジェクションの使用」を参照してください。