Configure Browser Agent Automatic Snippet Injection for .NET

The .NET automatic snippet injection properties configure the Browser Agent use of the automatic snippet Injection. The default snippet file is brtmsnippet.js, and is located in the <.NET_Agent_Home> directory.
apmdevops106
The .NET automatic snippet injection properties configure the Browser Agent use of the automatic snippet Injection. The default snippet file is brtmsnippet.js, and is located in the
<.NET_Agent_Home>
 directory.
The properties that are listed in the .NET IntroscopeAgent.profile are the only supported properties. No other properties from the Java IntroscopeAgent.profile are supported.
When the content encoding type is gzip, auto injection stops and the response header is not edited.
Follow these steps:
  1. Navigate to  the
    <Agent_Home>
    directory on the server for the application you want to monitor.
  2. Open the IntroscopeAgent.profile in a text editor.
  3. Go to this section:
    # Browser Agent Business Transaction Monitoring properties
  4. Modify any of the following properties as required:
    • introscope.agent.browseragent.autoInjectionEnabled
      Turns Browser Agent automatic JavaScript snippet injection on and off.
      Default:
       false (disabled)
    • introscope.agent.browseragent.snippetLocation
      This property specifies the path to the JavaScript snippet file value. The agent ignores this property when the
      introscope.agent.browseragent.snippetString
      property is set.
      Default: 
      None
    • introscope.agent.browseragent.snippetString
      This property specifies the value of the JavaScript snippet. This value takes precedence over the
      introscope.agent.browseragent.snippetLocation
       value when both properties are set.
      Default
      : An empty string
      Modify these properties to enable automatic snippet injection to work with a configured Digital Experience Collector.
    • introscope.agent.browseragent.dxchost
      This property specifies the CA Experience Collector host that is used in the snippet file. The property completes the URL for downloading the JavaScript file and sending performance data to the CA Experience Collector.
      Default:
       localhost
    • introscope.agent.browseragent.dxcport
      This property specifies the CA Experience Collector port that is used in the snippet file to complete the URL. The Browser Agent uses the URL to download the JavaScript file and to send performance data to the CA Experience Collector.
      Default:
       80
    • introscope.agent.browseragent.ssl.enable
      This property specifies whether SSL should be enabled during JavaScript file downloading and sending performance data to the CA Experience Collector.
      Default:
       false
      Modify these properties, which work together, to enable automatic snippet injection to match specific URLs:  Use a comma-separated set of keys to specify regular expressions for matching URLs. URLs that  match the regular expressions are injected with the Browser Agent JavaScript snippet.
    • introscope.agent.browseragent.autoInjection.appID
      This property specifies the group keys for Browser Agent automatic JavaScript snippet injection.
      Default:
       default
    • introscope.agent.browseragent.autoInjection.default.includeURLsRegex
    • This property specifies the RegEx pattern that is used to match against the request URL for adding the Browser Agent response cookie.
      Default
      : .*
      Example
      : Use two keys to match two different pages.
      introscope.agent.browseragent.autoInjection.appID=key1, key 2
      introscope.agent.browseragent.autoInjection.key1.includeURLsRegex=.*<
      example_page_1
      >
      introscope.agent.browseragent.autoInjection.key2.includeURLsRegex=.*<
      example_page_2
      >
  5. Save and close the IntroscopeAgent.profile file.
    No managed application restart is needed.
More information:
Browser Agent Properties for .NET. Find this topic in the CA Experience Collector documentation.