Enable RUM for your RUM Classic web applications
- Latest Dynatrace
- How-to guide
If you already monitor your web frontends with RUM Classic, upgrading to RUM requires only a configuration change. Once your setup meets the prerequisites, enable RUM for an individual web frontend, for all web frontends at the environment level, or via API. Afterwards, apply the new configuration if you insert the RUM JavaScript manually, and verify your setup.
Prerequisites
Before enabling RUM, make sure the following conditions are met.
- RUM Classic is enabled at the level—frontend or environment—where you want to enable RUM.
- The RUM JavaScript version is RUM JavaScript version 1.329+. Because new features are added regularly, we recommend updating it automatically as described in Configure the RUM JavaScript version for a frontend. Upgrade readiness for Latest Dynatrace requires RUM JavaScript version 1.347+.
- The snippet format code snippet, which is only supported by RUM Classic, isn't used. For alternatives, see Recommendations for selecting the snippet format.
- The OneAgent version is OneAgent version 1.301+. We recommend keeping OneAgent up to date, as new features are added regularly. For full frontend-backend linking functionality, including support for the
Server-Timingheader, OneAgent version 1.331+ is required. - Your infrastructure complies with the infrastructure pass-through requirements. If it's already configured for RUM Classic, no additional adjustments are typically required, except in cases where the beacon URL query string is altered; see Upgrade data capturing.
Enable RUM for a web frontend
To enable RUM for a web frontend
-
Go to
Experience Vitals > Overview. -
Select Web to view all web frontends.
-
Select the frontend you want to configure.
-
Switch to the Settings tab.
-
Under Enablement and cost control, turn on RUM.
-
Optional If you want to capture user interactions such as clicks and scrolls, enable User Interactions.
Enable RUM at the environment level
To enable RUM for web frontends at the environment level
- Go to
Settings > Collect and capture > Real User Monitoring > Enablement and cost control > Web. - Turn on RUM. Note that this setting is accessible only if RUM Classic is enabled; see Prerequisites.
Enable RUM via API
The Settings API allows you to enable RUM either for a web frontend or at the environment level. For details, see Settings API - Enablement and cost control schema table.
Apply the new configuration for manual insertion
If you use automatic injection, the new configuration is applied within 5 minutes, and no further action is required. If you insert the RUM JavaScript manually, you may need to update the snippet, depending on the snippet format you're using:
- JavaScript tag: The new configuration is applied automatically, but it may not take effect immediately due to caching. The file that contains the monitoring code and configuration is cached for one hour on the Dynatrace CDN. Additionally, browsers respect the configured cache duration.
- OneAgent JavaScript tag, OneAgent JavaScript tag with SRI or inline code: As with any configuration change, you need to update the inserted snippet.
To retrieve the updated snippet via API, use the RUM manual insertion tags API.
Verify your setup
If your frontend is receiving traffic, the charts in Experience Vitals should begin showing data within minutes after the configuration takes effect. If no data appears, verify that the prerequisites are met.