eG Administration
 

Adding/Modifying a new Real User Monitor component

This page appears when you choose to add a new Real User Monitor component from the COMPONENTS page.

  • Provide a unique name for the web site/web application that you want to monitor in the Nick name text box.

  • Then, select the RUM collector you want to assign to the specified web site/web application. By default, the Nick Name of each of the RUM collectors that you have configured in your environment will populate the RUM collector drop-down list. From this drop-down list, select the nick name of the RUM collector that you want to assign to the web site/web application being managed.

  • Next, select the Remote agent that should monitor the web site/web application being managed by polling the selected collector.

  • Then, click the Add button to add the Real User Monitor component. Doing so will invoke a To instrument your html pages use the eG javascript agent section.This section provides you with multiple options to instrument the web pages in the managed web site/web application, so that they can capture user experience metrics.

  • These options have been briefly discussed below:

    • RUM Library for Java: Only Java-based web sites / web applications can be instrumented using this option. Some Java-based web sites / web applications are designed in such a way that they dynamically generate the web pages with HTML content at runtime. To ‘RUM-enable’ such web sites/applications, the RUM Library for Java can be used. This library includes a specialized egrum.jar, which has to be downloaded and included in the classpath of the target site/application. To download the egrum.jar file, click the Download button alongside egrum.jar in the To instrument your html pages use the eG javascript agent section. Once the download is complete, you will have to edit the page template that auto-generates web pages, and add the code block that eG prescribes to each of these pages. This code block will automatically inject a JavaScript into the page where it resides. This script will track the requests to every web page that is dynamically generated by the parent page in which it has been inserted, capture the response time metrics of these requests, and send these metrics to the collector. The detailed procedure for using the egrum.jar is provided in the Instrumenting a Java-based Web Site / Web Application page.

    • RUM Library for DotNet: Only DotNet-based web sites / web applications can be instrumented using this option. Some DotNet-based web sites / web applications are designed in such a way that they dynamically generate the web pageswith HTML content at runtime. To ‘RUM-enable’ such web sites/applications, the RUM Library for DotNet can be used. This library includes a specialized Eg_RUM.dll, which has to be downloaded to the target web application's host, and then included in the target web application via an assembly reference. To download this library, click the Download button alongside Eg_RUM.dll in the To instrument your html pages use the eG javascript agent section. Then, eG will provide you with a code block that you will have to insert in the Views\Shared_Layout.cshtml or Default.master file. This code block will automatically inject a JavaScript into all web pages that use the edited cshtml or master file. This script will track the requests to each of the web pages, capture the response time metrics, and send these metrics to the collector. The detailed procedure for using the Eg_RUM.dll is provided in the Instrumenting a DotNet-based Web Site / Web ApplicationSection page.

    • JavaScript: Any web site/web application to be monitored, regardless of the underlying development framework (be it Java, .Net, PHP, or others), can be instrumented using this option. This option is ideal in the case of web sites / web applications that do not dynamically generate web pages. In this case, you will just have to copy the JavaScript code-snippet that eG displays in the Include this line… text box in the To instrument your html pages use the eG javascript agent section to the <head> tag of every web page that you want to monitor. Every time the web page is hit, the JavaScript runs to collect response time metrics and sends them to the collector. The detailed procedure for inserting the code snippet is provided in the Instrumenting Using the JavaScript Code Snippet page.