Once Sumo Logic detects data coming from user browsers, the RUM app will be installed automatically for all users of your organization. No action is required.
The data will populate in your organization's Sumo Logic RUM - default dashboards, located inside of your Admin Recommended folder. Do not modify or delete content in this folder, as it's maintained and updated automatically.
If your RUM app is removed accidentally, here's how to install it manually (click to expand).
- Go to the App Catalog, then search for and select the Real User Monitoring app.
- Click Add to Library.
- Provide an App Name. You can retain the existing name or enter a name of your choice for the app.
- Advanced. Select the Location in Library (the default is the Personal folder in the library), or click New Folder to add a new folder.
- Click Add to Library.
- Once the app is installed, it will appear in your Personal folder or the folder you specified. From here, you can share it with your organization.
Using Explore View
Once the RUM app has been installed, use our Explore view to gain visibility into your web app's performance and end-user activity, such as geographic location, browser type, operating systems used. These dashboards visualize RUM metrics gathered from browser tracing instrumentation.
Explore organizes RUM data on four levels:
- Action Type: can be one of:
- document loads: representing loading of actual documents and their resources into the browser
- XHR actions: representing any interaction with a page like click or submit that executes AJAX requests in the background to communicate with the backend, or
- route changes: single-page-app specific way to navigate to a new page/view without having to load a new document.
- Action Name: automatically generated from URLs. No configuration is required. The specifics of it will depend on action type.
Action names can contain asterisks (
*) to replace automatically-detected dynamic parts of the URL. If you have action names that overlap, the action name with an asterisk contains data for page loads NOT contained in more specific action names:
http://www.site.com/path/page.htm does not contain actions from
There are three dashboard types on the Application and Service level and a single one on the Action type and Action level. You can select the appropriate dashboard from dropdown menu in the header:
Navigating RUM Dashboards
RUM Overview Application/Service/Action Type/Action
The RUM Overview Application, Service, Action Type, and Action dashboards dashboards show the user experience for performance and requests metrics for selected application, service, or action, broken down per top geo-locations, operating systems, and browsers.
Use these dashboards to:
- Analyze load and paint timings for page document loads by application, service, or action.
- View information about core web vitals, XHR processing times/errors, and log errors.
- Understand what top browsers, operating systems, and geolocations are active with your website.
You can select the timing metric type in the statistic dropdown on the dashboard header. This will change the browser time metrics types on charts.
You can also click on any data-point on the charts to open a details panel and view the Infrastructure tab to drill down to traces representing user transactions from the selected time point.
Overview dashboards on all Explore levels have a panel showing geographical user activity for the selected entity. Geographic dashboards do not measure performance.
RUM TopN Application/Service
The RUM - TopN - Application and RUM - TopN - Application Service dashboards show top N browsers, operating systems, and geographical locations by load time and requests for the selected application or service.
Use this dashboard to:
- Find out top N browsers, operating systems, and geolocations by load or requests.
- Understand the slowest and fastest browsers from a rendering perspective or geographical locations from a network perspective.
- Understand XHR and log errors your users are experiencing.
- Find out which browsers, operating systems are in use by your users and where are they are geographically located.
You can select the timing metric type in the statistic dropdown on the dashboard header. This will change the browser time metrics types on charts. You can also define the top N number for all charts.
RUM Performance Analytics Application/Service
The RUM Performance Analytics Application and Service dashboards show the page performance and requests for a cohort of users specified by selecting the desired combination of dimensions.
Use this dashboard to:
- Filter data for specific combinations of application, browser, operating system, and/or geolocation.
- Understand XHR, load, timing metrics for the selected user cohort.
- Compare your selected timings against data for a different time period by selecting the appropriate option in the compare_with dropdown.
You can click on any data point on the charts to open a details panel and view the Infrastructure tab to drill-down to traces representing user transactions from the selected time point. For cross-dimensional metrics, only the average statistic type is available.
Collecting Browser Errors
Sometimes browser UI breaks in an unhandled way, failing to deliver the transaction and degrading user experience. That can happen in situations of unhandled errors or rejections, or failed resources. Also, developers can design the page to write erroneous messages to the console.
All of these situations are captured by Sumo Logic RUM browser instrumentation and forwarded to the same RUM source that is configured for traces data, that then forwards log data to
sumologic_rum_errors log view. Aggregates from this view are also available on RUM dashboards in "Log errors" panels.
This way, you can have full visibility into the flow and categories of errors generated by various parts of your browser applications with contextual drill-down, free-form search and ability to build custom dashboards, which gives you the ability to shorten the troubleshooting time and pro-activeness in error tracing.
Browser error logs, although collected via RUM script, contribute to your log Continuous Tier quota and credit consumption.
Working with Browser Errors data
Data in the index is query-able using normal log search query. Here’s a sample query and results:
The following fields are available to better aggregate and filter your results:
- Action name and type
- Geolocation data
- User agent
- Span and Trace ids
Because errors don't always have to be connected with user actions, it is ok to leave some of these fields empty.
In addition to that, we also aggregate that information in form of log-query based panels and display on various dashboards:
Logs collection is enabled by default. You can disable by setting
collectErrors=false in your RUM script options.