AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.

    Skip to end of metadata
    Go to start of metadata

    Related Pages:

    Your Rating:
    1 Star2 Star3 Star4 Star5 Star
    35 rates

    This page covers how to instrument a browser application by manually injecting the JavaScript Agent. To configure the JavaScript Agent before injection, see Configure the JavaScript Agent.

    Manually Inject the JavaScript Agent

    The Controller UI allows you to configure the JavaScript Agent, generate an HTML snippet, and add that snippet to the header of the web pages. 

    1. In the Controller UI, go to a browser application. 
    2. In the left navigation menu, select Configuration > Configure JavaScript Agent.
    3. Configure the JavaScript Agent.
    4. Save and copy the HTML snippet.
    5. Add the HTML snippet to the header of the web pages. 

    JavaScript Agent Placement

    The recommended location for the JavaScript Agent is at the top of the <head> section. The adrum.js file captures the time as the page begins to load and measures that amount of time against the time that other timings are calculated for all browsers. Many modern browsers, however, support the Navigation Timing API (see this list), and for these browsers, timings can be acquired via the API. In this case, it is possible to place the JavaScript Agent somewhere else on the page, but useful timing information is only available for those NavTime-capable browsers. 

    Synchronous versus Asynchronous Script Load

    AppDynamics recommends that the adrum.js file loads synchronously because once downloaded, the JavaScript Agent begins monitoring for page data such as Ajax events, resources, and errors. If adrum.js loads asynchronously for the first time (via the async attribute), the JavaScript Agent might not report all page data. 

    Use Previous JavaScript Agent Versions

    Previous versions of the agent can be found at the following location, where VERSION is the version number you want to access (for example, 4.5.0.).

    If you are using a SaaS EUM Cloud and want a hosted version of adrum.js, use the adrum-latest.js version. If you are using an on-prem EUM Server and want to use a hosted version of adrum.js, you need to match the adrum.js version to your EUM Server version.

    Verify Manual Injection

    Once the agent is injected, it can take the AppDynamic Controller a few minutes to discover and recognize the page, which must happen before data will begin to appear. If, however, you have configured your page using manual injection and are not seeing Browser RUM metrics after running load for a while, check the web page to confirm that the JavaScript Agent for Browser RUM is present in the page. If not, try injecting the script again.

    If, after two attempts, you still do not see Browser RUM metrics, try one of the other injection schemes if they are available for your platform. See Troubleshoot Browser RUM for more information.