Edit

How to send Real User Measurements to Azure Traffic Manager using web pages

  • Article

You can configure your web pages to send Real User Measurements to Traffic Manager by obtaining a Real User Measurements (RUM) key and embedding the generated code to a web page.

Obtain a Real User Measurements key

The measurements you take and send to Traffic Manager from your client application gets identified by the service using a unique string, called the Real User Measurements (RUM) Key. You can get a RUM key by using the Azure portal, a REST API, PowerShell, or Azure CLI.

To obtain the RUM Key using Azure portal:

  1. In the portal’s search bar, search for the Traffic Manager profile name that you want to modify, and then select the Traffic Manager profile in the results that are displayed.

  2. In the Traffic Manager profile page, select Real User Measurements under Settings.

  3. Select Generate Key to create a new RUM Key.

    Screenshot of how to generate key.

    Figure 1: Real User Measurements Key Generation

  4. The page now displays the generated RUM Key and a JavaScript code snippet that needs to be embedded into your HTML page.

    Screenshot of generated JavaScript code.

    Figure 2: Real User Measurements Key and Measurement JavaScript

  5. Select the Copy button to copy the JavaScript code.

Important

Use the generated JavaScript for the Real User Measurements feature to function properly. Any changes to this script or the scripts used by Real User Measurements can lead to unpredictable behavior.

Embed the code to an HTML web page

After you've obtained the RUM key, the next step is to embed this copied JavaScript into an HTML page that your end users visit. This example shows how to update an HTML page to add this script. You can use this guidance to adapt it to your HTML source management workflow.

  1. Open the HTML page in a text editor.

  2. Paste the JavaScript code you copied in the last section into the BODY section of the HTML. The copied code is on line 8 & 9, see figure 3.

    Screenshot of generated JavaScript embedded into webpage.

    Figure 3: Simple HTML with embedded Real User Measurements JavaScript

  3. Save the HTML file and host it on a webserver connected to the internet.

  4. The next time that this page will render on a web browser, the JavaScript referenced gets downloaded, and the script will execute the measurement and reporting operations.

Next steps