ブラウザ RUM を使用するには、JavaScript エージェントを Web ページに挿入する必要があります。使用例によっては、いくつかのインジェクションタイプが使用できます。次のセクションでは、さまざまなインジェクションタイプ、それらの機能、および各タイプを使用するタイミングについて説明します。
インジェクション方式の選択
エージェントを Web ページに挿入するために使用する手順が不明な場合は、次のガイドラインをこの順序で実行してください。
手動インジェクション
手動インジェクションは、すべてのプラットフォームとフレームワークでサポートされています。手動で挿入されるページを設定するには、次のようにします。
アプリケーションでの手動インジェクションの使用方法の詳細については、「JavaScriptエージェントの手動組み込み」を参照してください。
自動インジェクション
サーバー側で Java または .Net アプリケーション エージェントを使用していて、アプリケーションが Apache Jasper JSP コンパイラ(Java の場合)または ASP.NET/ASPX(.NET の場合)をサポートする環境で実行されている場合は、自動インジェクションを使用できます。この場合、サーバー側アプリケーション エージェントが実行時にコードインジェクション全体を管理します。アプリケーションでの自動インジェクションの使用方法の詳細については、「JavaScriptエージェントの自動インジェクション」を参照してください。
補助インジェクション
補助インジェクションは 2 つの種類があります。いずれの場合も、作業の一部は手動で実行され、一部の作業はサーバー側の Java または .NET アプリケーション エージェントによって実行されます。
インジェクションルールを使用した補助インジェクション(Java のみ)
このタイプの補助インジェクションでは、アプリケーションの出力ストリームに書き込むアプリケーションサーバ Java クラスとメソッド、およびその書き込みを実行するために使用するライターオブジェクトを定義するルールを構成します。AppDynamics はメソッドをインターセプトし、JavaScript エージェントを出力ストリームに挿入します。また、この方法で、インストゥルメント化するサーバ側ビジネストランザクションの指定も行います。
この形式の補助インジェクションの使用方法の詳細については、「補助インジェクション」を参照してください。
属性インジェクションを使用した補助インジェクション
このタイプの補助インジェクションでは、フレームワークに適した小さなコードスニペットをページテンプレートまたはページを作成するその他のコードにコピーします。このスニペットには 2 つの変数 JS_HEADER
と JS_FOOTER
が含まれていて、アプリケーション エージェントは実行時の応答オブジェクト内の適切な情報に置き換えます。
この形式の補助インジェクションの使用方法の詳細については、「属性インジェクションの使用」を参照してください。
コンテナベースのインジェクション
Web コンテナとして、または Web コンテナの前でリバースプロキシとして、Nginx または Apache を使用する場合は、ディレクティブを使用してエージェントを応答オブジェクトに挿入できます。詳細については、「Nginx を使用したインジェクション」または「Apache を使用したインジェクション」を参照してください。