Page tree

BMC Real End User Experience Monitoring includes monitoring capabilities for end-user metrics in internet applications, such as rich internet applications (RIAs). Monitoring of internet applications uses components from the BMC Application Diagnostics product. After you configure the Diagnostics Agent to monitor end-user page-render times of internet applications, you must configure the web beacons in the BMC Real End User Experience Monitoring system.

The Diagnostics Agent monitors internet applications by deploying a page-render beacon (or web beacon) to calculate the page-render time metric.

The following table presents the tasks and references the you need to configure the system to monitor internet applications and access the results on the Performance Analysis page of the BMC Application Management Console.

Note

You can implement this feature without integration with BMC Application Diagnostics product, but some of the components are from the BMC Application Diagnostics components.

Tasks to collect end-user metrics for the BMC Real End User Experience Monitoring product

Task

Description

Install the Server component (Portal) or all components

If you want to collect end-user metrics without recording transactions, install the only the BMC Application Diagnostics Portal component.

If you want to collect end-user metrics and record diagnostics data, install all three Diagnostics Server components: Portal, Collector, and APM proxy.

Configure the Portal on the ConsoleConfigure the BMC Application Diagnostics Portal address so that the Application Management Console can display the transaction and trace data.

Set the mode in the Agent Policy

 

Ensure that you configure the Diagnostics Agent to one of the following modes:

  • euem—Enables the collection of end-user metrics in internet applications, such as rich internet applications (RIAs), for the BMC Real End User Experience Monitoring product. In this mode, the Agent does not record transactions.
  • apm—(Default) Records diagnostics data and enables end-user monitoring the BMC Real End User Experience Monitoring product. You must have a valid BMC Application Diagnostics license to use this mode.

    To collect end-user metrics with the APM mode, you also need to install the APM proxy.

Install the Diagnostics Agent for Java or install the Diagnostics Agent for .NET

The Diagnostics Agent deploys a web beacon to calculate the page-render time metric. In the apm mode, it also captures a sample of the transactions that have latency violations or errors.

Deploy and detect web beacons in the Real User Analyzer

  1. In the Real User Analyzer, open the Administration > Data flow settings > Web beacons page. Ensure that the name of the default page-render beacon is crd_prm_go. Ignore the user-defined beacon. Turn on the page-render beacon.
  2. In the Real User Analyzer, open the Administration > Data flow settings > Object type detection rule page. Edit the Component object in the Default catch-all policy and append the following expression:
OR (url.stem_string contains "crd_prm_go" ignorecase)

The following expression is the complete expression for the Component object, with the appended rule:

url.extension in ("js","css","gif","jpg","jpeg","png","htc","swf") ignorecase OR mime_type startswith "image" OR mime_type contains "javascript" OR mime_type = "text/css" OR (url.stem_string contains "crd_prm_go" ignorecase)


Apply the browser instrumentation settings globally to the Collectors

  1. In the Real User Analyzer, open the Administration > Data flow settings > Analyzer & Collectors management page, Collector feeds settings tab.
  2. Ensure that the Username and Collector field is an Administrator or Security user on the Collector.
  3. For each associated Collector, select Manage configuration.
Verify that the script stub is injected to the web pages

Open a web browser to the monitored web application and view the page source or frame source. In the following example, the <script> elements are injected into the <head> element of the page:

<head><script>
        /* Variable optionally set by admin. */
        BMCRum = {
            beaconName : 'crd_prm_go',
            hostName : document.location.host,
            protocol : document.location.protocol
        };
</script>
<script type="text/javascript" src="http://updates.bmc.com/apm/bmc_eum.js" async></script>
 
    <title>Request Summary</title>
</head>

Notes:

  • The default Agent Policy sets the sampling rate at 100%. If the rate is less than 100%, then you might need to check several pages before finding one with the injected script stub.
  • BMC hosts the injected JavaScript.

Locate problematic sessions in the BMC Application Management Console

Create a query, such as a page-type query for a specified Watchpoint, to look for one or more of the following document object model metrics:
  • DOM Interactive
  • DOM Loading to Interactive
  • DOM Content Loaded
  • DOM Completed

For details about these latency metrics, see End-user experience performance metrics.

Open a single session and download session details

Open the page.csv file.

End-user metrics are located in the following columns:

  • bnt_cache_fetch
  • bnt_dns_resolve
  • bnt_tcp_connect
  • bnt_dom_inter
  • bnt_dom_loaded2inter
  • bnt_content_loaded
  • bnt_complete
  • bnt_loaded

Related topics

Setting up the system to report page-render time

Troubleshooting application diagnostics

Monitoring application health and performance