ITRS named a Visionary in the 2025 Gartner® Magic Quadrant™ for Digital Experience Monitoring.

  1. Support
  2. Knowledge base
  3. Real User Monitoring (RUM)
  4. Set up Real User Monitoring

Set up Real User Monitoring

Tip: If you’re new to Real User Monitoring (RUM), start with Understanding Real User Monitoring for an overview of its features and key functions.

Real User Monitoring (RUM) collects performance data directly from your website’s actual visitors. It captures how your site performs in real-world conditions, measuring how your end users experience your site across different devices, browsers, and networks.

Prerequisites

To use RUM, you need permission to edit your website’s code. Uptrends provides a script that you insert into your site. Once the script is added, RUM begins collecting data.

Set up Uptrends RUM

To set up Uptrends RUM:

  1. Add a RUM website.
  2. Implement script on your website.
  3. Track your website performance using RUM dashboards.

Add a RUM website

  1. Go to RUM > Real users > RUM websites .
  2. Enter a name for your RUM website.
  3. Enter the URL to monitor.
  4. If you use a single-page application (SPA), enable Use Single Page Application Tracking.
  5. To track URL fragments (for example, #fragment in /page#fragment), enable Include URL fragment.
  6. Click Save to generate the RUM script.
  7. Go to Implementation and copy the script.

The RUM script is a lightweight JavaScript snippet that you insert on your website’s pages to measure your users' experience. The script is designed to avoid interfering with other scripts on your website, ensuring that your end users will not notice any impact. For more details, see Impact of the RUM script on your website.

Implement the script on your website

To add the script to your website:

  1. Paste the script into the <head> section of each page you want to monitor. Placing it in the <head> section ensures that the script loads as early as possible, capturing all relevant performance timing data.
  • If your site uses a Content Security Policy (CSP), ensure that the Uptrends RUM domain (https://hit.uptrendsdata.com) is added and correctly configured in your Content Security Policy.

  1. Verify that the Uptrends RUM script is working properly:

    a. Inspect your website’s source code and confirm that the Uptrends RUM script is present.

    b. Open the Developer Tools > Network tab in your browser and verify that Uptrends RUM resources load without errors.

  2. Deploy your website with the script included.

Once visitors access the updated pages, RUM will collect data and display it in your RUM dashboard in real time.

Note: If you enable Use Single Page Application tracking for an existing RUM website, the script changes after you save your settings. You must update the script on your website accordingly.

Site ID

Each RUM script is designed for a single website. It includes a unique sid (site ID) that identifies the corresponding RUM website in your account. Uptrends records page views only from the domain that you specify.

Example

If your site is www.your-domain.com, the script works on both www.your-domain.com and your-domain.com. However, if you use the script on test.your-domain.com or any other domain, Uptrends will not record page views. Each website or domain requires its own RUM website and script.

In this example, RUM only works in your production environment. If you have separate development and test environments running locally or under a different domain, RUM will not register page views for those sites.

Note: To track the same site across multiple domains as one RUM website, contact our Support team.

License

The Uptrends RUM script and its components are provided under a Berkeley Software Distribution (BSD) license. You can find the full BSD license text. For information about how Uptrends protects user privacy, see RUM and user privacy.

By using the Uptrends website, you consent to the use of cookies in accordance with our Cookie Policy.