The following instructions use the RUM enablement setting at the frontend level. While the RUM enablement setting at the process group level, in principle, also allows for implementing a selective RUM rollout approach, this tends to be complex and error-prone—particularly in multi-tier environments. For this reason, we recommend using the frontend-level setting instead.
After deploying OneAgent in full-stack monitoring mode on a host, web applications running on that host are, by default, automatically monitored using RUM. This means that the RUM JavaScript is injected into web pages, and RUM-specific headers and cookies are added to both HTTP requests and responses. Unless you've already defined frontend detection rules that apply to these web applications, the captured RUM data is associated with a catch-all frontend that, by default, has the name My web application.
However, there may be cases where you prefer to roll out RUM in a more selective or phased manner after deploying OneAgent. The steps for doing this depend on whether your environment has already captured RUM data or not. The following sections guide you through both scenarios.
If your environment has already captured RUM data—even if it’s exclusively RUM Classic so far—perform the following actions to implement a selective RUM rollout.
To identify your catch-all frontend
Experience Vitals.EA7C4B59F27D43EB in the Search frontends field.To implement a phased RUM rollout, it's essential that your catch-all frontend does not contain any relevant traffic and disabling it is safe. You can achieve this by moving any relevant traffic into one or more dedicated frontends, as described in Set up an auto-injected frontend in the New RUM Experience. If you haven't enabled the New RUM Experience for your catch-all frontend yet, examine the captured data in RUM Classic.
Ensure that your frontend detection rules use patterns that are specific enough to distinguish between frontends. For example, if you create a detection rule for www.example.com, using a broader pattern like example.com may be too general—especially if all your company’s application domains end with example.com. In this case, www.example.com would be a more precise and appropriate choice.
To disable RUM in advance for all web applications running on hosts where OneAgent has not yet been deployed
Experience Vitals.When you are ready to roll out RUM for a frontend, define a new RUM frontend and frontend detection rules, as described in Set up an auto-injected frontend in the New RUM Experience. As already recommended in step 2, choose patterns that are specific enough to distinguish between frontends.
If your environment has not captured RUM data yet, perform the following actions to implement a selective RUM rollout.
To disable RUM in advance for all web applications running on hosts where OneAgent has not yet been deployed
When you are ready to roll out RUM for a frontend, define a new frontend and frontend detection rules, as described in Set up an auto-injected frontend in the New RUM Experience.
Ensure that your frontend detection rules use patterns that are specific enough to distinguish between frontends. For example, if you create a detection rule for www.example.com, using a broader pattern like example.com may be too general—especially if all your company’s application domains end with example.com. In this case, www.example.com would be a more precise and appropriate choice.
To enable RUM for your newly created frontend
Experience Vitals.