ブラウザ エージェントの高度な設定

必要とされる可視性とパフォーマンスをバランスよく実現するため、デフォルト監視は変更することができます。
dxapm111
HID_BrowserAgentAdvancedConfig
必要とされる可視性とパフォーマンスをバランスよく実現するため、デフォルト監視は変更することができます。
自動 JavaScript スニペット挿入の有効化または無効化
ブラウザ エージェントをインストールした後に、bundle.properties ファイルを設定して、Web ページを監視するための自動 JavaScript スニペット挿入を有効にします。自動スニペット挿入が無効の場合、手動でスニペットを挿入し、ビジネス トランザクション マッチング サポートおよびエンド ツー エンドのトランザクション追跡相関の応答修飾を有効化して、ブラウザ エージェントを使用することができます。
以下の手順に従います。
  1. <Agent_Home>/core/config
    ディレクトリに移動し、
    IntroscopeAgent.profile
    ファイルをテキスト エディタで開きます。
  2. Java エージェントを使用した Web ページへの自動スニペット挿入を有効化(ture)または無効化(false)します。
    introscope.agent.browseragent.autoInjectionEnabled=true/false
  3. 以下のプロパティを有効にし、それに対して値を指定します。ガイドとして、ファイル内の例を使用します。
    introscope.agent.browseragent.autoInjection.appID=<key1> Specifies that the agent gets the snippetLocation and the includeURLsRegex property of the app ID. ? introscope.agent.browseragent.autoInjection.<key1>.snippetLocation=<full path to the snippet file> Specifies the full file path to the snippet file. For example, the path can be to within the <Agent_Home> folder or the application location. introscope.agent.browseragent.autoInjection.<key1>.includeURLsRegex=<Regex> Specifies that the agent inserts the snippet in only those URLs that match the Java regular expression. ? The following example matches all URLs with path "/mypage.jsp": introscope.agent.browseragent.autoInjection.<key1>.includeURLsRegex=.*/mypage.jsp
  4. ファイルを保存して閉じます。
応答修飾の有効化または無効化
ブラウザ エージェントをインストールした後に、bundle.properties ファイルを設定して、Web ページを監視するための応答修飾を有効にします。応答修飾が無効の場合、ビジネス トランザクション マッチングおよびエンド ツー エンドのトランザクション追跡相関は利用できず、動作しません。
以下の手順に従います。
  1. <
    Agent_Home
    >
    /
    core/config
    ディレクトリに移動し、
    IntroscopeAgent.profile
    ファイルをテキスト エディタで開きます。
  2. ブラウザ エージェント応答修飾を有効化(true)または無効化(false)します。ガイドとして、ファイル内の例を使用します。
    introscope.agent.browseragent.response.decoration.enabled=true/false Specifies the addition of the APM response cookie/header.
  3. 以下のプロパティを有効にし、それに対して値を指定します。ガイドとして、ファイル内の例を使用します。
    introscope.agent.browseragent.response.decoration.cookie.expirationTime=<seconds> Specifies the expiration time of the APM response cookie in the browser. introscope.agent.browseragent.response.decoration.includeURLsRegex=<Regex> Specifies that the agent adds the APM response cookie/header in only those URLs that match the regular expression. ? The following example matches all URLs with path "/mypage.jsp": introscope.agent.browseragent.response.decoration.includeURLsRegex=.*/mypage.jsp
  4. ファイルを保存して閉じます。
必要とされる可視性とパフォーマンスをバランスよく実現するため、デフォルト監視は変更することができます。
管理者として、ブラウザ エージェント応答修飾を理解し、オプションの設定タスクを実行してください。
ブラウザ エージェント応答修飾の制御
応答 cookie またはヘッダは、APM ビジネス トランザクション情報およびエンド ツー エンドの APM トランザクション相関を伝送します。しかし、短期間に発生する要求の数が多すぎると、クライアント Cookie が急増する場合があります。Cookie が急増すると、認証の問題が発生したり、「
413 リクエスト エンティティが大きすぎる
」という応答エラーがクライアントに表示されたりする可能性があります。この問題を解決するため、ブラウザ エージェントの応答修飾を制御できます。
以下の手順に従います。
  1. <
    Agent_Home
    >
    /
    core/config
    ディレクトリに移動し、
    IntroscopeAgent.profile
    ファイルをテキスト エディタで開きます。
  2. 以下のプロパティを変更し、値を指定します。
    introscope.agent.browseragent.response.decoration.cookie.expirationTime=<integer in seconds>
    introscope.agent.browseragent.response.decoration.includeURLsRegex=<regular expression>
    introscope.agent.browseragent.response.decoration.enabled=<true/false>
  3. ファイルを保存して閉じます。
同じエージェントの複数のアプリケーションの監視
エージェントごとに複数のスニペット コンテンツ ファイルを使用して、同じエージェントの複数のアプリケーションを監視できます。各スニペット コンテンツ ファイルには、ブラウザ エージェントの JavaScript ファイルおよびプロファイルで 1 つまたは複数のスクリプト タグがあります。このスクリプト タグは、各アプリケーションの独自の JavaScript ファイルとプロファイルに一致します。
以下の手順に従います。
  1. <
    Agent_Home
    >
    /
    core/config
    ディレクトリに移動し、
    IntroscopeAgent.profile
    ファイルをテキスト エディタで開きます。
  2. 以下のプロパティのコメントを外して有効にし、追加して、プロパティ値を指定します。
    introscope.agent.browseragent.autoInjection.appID=<APP1>,<APP2> introscope.agent.browseragent.autoInjection.<APP1>.snippetLocation=<snippet content file location> introscope.agent.browseragent.autoInjection.<APP1>.includeURLsRegex=<URI> introscope.agent.browseragent.autoInjection.<APP2>.snippetLocation=<snippet content file location> introscope.agent.browseragent.autoInjection.<APP2>.includeURLsRegex=<URI>
  3. ファイルを保存して閉じます。
ブラウザ エージェントからのブラウザ ページのフィルタ
ブラウザ エージェントから Web ページをフィルタすることが適切な場合があります。
以下の手順に従います。
  1. <
    Agent_Home
    >
    /
    core/config
    ディレクトリに移動し、
    IntroscopeAgent.profile
    ファイルをテキスト エディタで開きます。
  2. プロパティのコメント化を解除し、プロパティ値を指定して、以下のプロパティを有効にします。
    introscope.agent.browseragent.autoInjection.<key1>.includeURLsRegex This property specifies that the agent attempts to insert the snippet in only URLs that match the Java regular expression.
  3. ファイルを保存して閉じます。
Java エージェント応答修飾内のトランザクション情報の暗号化
Java エージェントは、応答 cookie またはヘッダを使用して、ブラウザ エージェントに
DX APM
のトランザクション情報を送信します。
Java エージェントが、
DX APM
のトランザクション情報を収集し暗号化するのを有効にすることができます。Java エージェントを使用して、応答 cookie またはヘッダに暗号化された情報を埋め込み、ブラウザ エージェントにその cookie またはヘッダを送信します。ブラウザ エージェントは、トランザクション情報を復号化し、レポートする をDigital Experience Collector に情報を渡します。以下のように、このプロセスは 1 つの要求および応答トランザクション内で実行されます。
  1. introscope.agent.decorator.userid.cookie.name
    が IntroscopeAgent.profile ファイルに設定された場合、Java エージェントは cookie からユーザ ID の値を読み込みます。
  2. Java エージェントは、ユーザ ID、エージェント名、エージェント ホスト、エージェントのプロセス、サーブレット名、および Web アプリケーションの名前を収集し、暗号化します。
    各 Java エージェント用フィールドは別々に暗号化します。
  3. Java エージェントは、応答 cookie およびヘッダに暗号化された情報を追加し、ブラウザに cookie およびヘッダを送信します。
  4. ブラウザ エージェントは、JSON オブジェクトを作成するときに、Java エージェントの情報を抽出します。ブラウザ エージェントは、オブジェクトを Digital Experience Collector に送信します。
  5. Digital Experience Collector では、JSON オブジェクトを解析て、Java エージェントの情報を復号化します。
  6. Digital Experience Collector では、トランザクション追跡で使用するために Enterprise Manager に復号化された Java エージェントの情報を送信します。
    暗号化中に、Java エージェント用フィールドが空の場合、Enterprise Manager に使用するための復号化に値がありません。たとえば、ユーザ ID フィールドは暗号化中に空です。Digital Experience Collector では、Enterprise Manager にユーザ ID の値を送信できません。このような状況では、トランザクション追跡追跡ビューで[ユーザ ID]列に値が存在しません。
以下の手順に従います。
  1. <
    Agent_Home
    >
    /
    core/config
    ディレクトリに移動し、
    IntroscopeAgent.profile
    ファイルをテキスト エディタで開きます。
  2. 以下のプロパティを設定します。
    introscope.agent.decorator.userid.cookie.name=<
    cookie_name
    >
    introscope.agent.browseragent.response.decoration.apmData.enabled=<true/false>
    introscope.agent.browseragent.response.decoration.enabled=<true/false>
    1. introscope.agent.browseragent.response.decoration.enabled プロパティが
      true
      に設定されていることを確認します。
    2. introscope.agent.decorator.userid.cookie.name
      プロパティ値を指定します。
    3. リクエスト URL に一致する introscope.agent.browseragent.response.decoration.includeURLsRegex プロパティの値を指定します。
  3. ファイルを保存して閉じます。
    応答修飾データが暗号化されていることを確認するには、
    x-apm-brtm-response-bt-page-<page URL>
    応答 cookie または
    x-apm-brtm-response-bt
    応答ヘッダ値のいずれかを参照します。
gzip 圧縮された応答内のフィルタのスキップ
gzip は、ファイルを圧縮および解凍するファイル形式です。gzip 圧縮された応答内のフィルタをスキップするよう、ブラウザ エージェントを設定することができます。
以下の手順に従います。
  1. <
    Agent_Home
    >
    /
    core/config
    ディレクトリに移動し、
    IntroscopeAgent.profile
    ファイルをテキスト エディタで開きます。
  2. 以下のプロパティのコメントを外して有効にし、値を指定します。
    introscope.agent.browseragent.contentencoding.enabled: This property enables content encoding support property for the Browser Agent. introscope.agent.browseragent.instrumentclass.autoskip.depth: This property specifies the skip level to instrument the class for the Browser Agent.
  3. ファイルを保存して閉じます。
  4. (WebSphere Application Server 7 のみ)
    <wily>
    /
    core/config
    ディレクトリに移動し、テキスト エディタで
    browseragent.pbd
    ファイルを開きます。
    1. 以下の追跡ディレクティブをオフにします。
      TurnOff: BRTM_WASStaticServletTracing
    2. ファイルを保存して閉じます。
    3. エージェントのアプリケーション サーバを再起動します。
最初のフィルタから gzip フィルタの後のフィルタまでのブラウザ エージェントのインスツルメンテーションを変更できます。このインスツルメンテーションは、
introscope.agent.browseragent.instrumentclass.autoskip.depth
プロパティの値を使用します。また、ブラウザ エージェントでは、応答をラップする複数の再入をサポートしています。いくつかのクラスの後に再度、応答をラップする場合は、
browseragent.pbd
ファイル内の
BrtmResetTracer
を設定できます。
以下の手順に従います。
  1. <
    Agent_Home
    >
    /
    core/config
    ディレクトリに移動し、browseragent.pbd ファイルをテキスト エディタで開きます。
  2. 以下の追跡ディレクティブ スキップを追加および有効にします。
    ######################################################
    ## BrtmResetTracer
    ######################################################
    SetFlag: BRTM_SELFRESET_Tracing
    TurnOn: BRTM_SELFRESET_Tracing
    SetFlag: BRTM_RESET_Tracing
    IdentifyTwoFlagIntersectionAsAggregateFlag: BRTMTracing BRTM_SELFRESET_Tracing BRTM_RESET_Tracing
    SetTracerClassMapping: BrtmResetTracer com.wily.introscope.agent.brtm.trace.BrtmResetTracer com.wily.introscope.probebuilder.validate.ResourceNameValidator
    SetTracerOrdering: BrtmResetTracer -10000000
    IdentifyClassAs: org.eclipse.jetty.server.Dispatcher BRTM_RESET_Tracing
    TraceOneMethodWithParametersIfFlagged: BRTM_RESET_Tracing forward(Ljavax/servlet/ServletRequest;Ljavax/servlet/ServletResponse;Ljavax/servlet/DispatcherType;)V BrtmResetTracer Servlets
  3. ファイルを保存して閉じます。
  4. エージェントのアプリケーション サーバを再起動します。