The following instructions use the RUM enablement setting at the application 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 application-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 application detection rules that apply to these web applications, the captured RUM data is associated with a catch-all application 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, perform the following actions to implement a selective RUM rollout.
To identify your catch-all application
EA7C4B59F27D43EB
. You'll be redirected to your catch-all application.To implement a phased RUM rollout, it's essential that your catch-all application 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 applications, as described in Define applications for Real User Monitoring | Suggested approach or Define applications for Real User Monitoring | Application detection rules approach.
Ensure that your application detection rules use patterns that are specific enough to distinguish between applications. 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
When you are ready to roll out RUM for an application, define a new RUM application, as described in Define applications for Real User Monitoring | Application detection rules approach. As already recommended in step 2, choose patterns that are specific enough to distinguish between applications.
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 an application, define a new RUM application, as described in Define applications for Real User Monitoring | Application detection rules approach.
Ensure that your application detection rules use patterns that are specific enough to distinguish between applications. 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 application