Network Performance Monitoring is now generally available! Network Monitoring is now available!

RUM Explorer

The Real User Monitoring (RUM) Explorer allow you to explore all your views collected from your different applications.

Context

Build up a context to explore your views in your RUM Explorer page first by selecting the proper time range then by using the search bar to filter your views and analytics.

Time Range

It appears directly under the search bar as a timeline. The time range feature allows you to display view in the view steam or analytics within a given time period.

Quickly change the time range by selecting a preset range from the dropdown:

All of the search parameters are contained within the URL. You can share your view by sharing the URL.

Search syntax

A query is composed of terms and operators.

There are two types of terms:

  • A single term is a single word such as test or hello.

  • A sequence is a group of words surrounded by double quotes, such as "hello dolly".

To combine multiple terms into a complex query, you can use any of the following Boolean operators:

OperatorDescription
ANDIntersection: both terms are in the selected views (if nothing is added, AND is taken by default)
ORUnion: either term is contained in the selected views
-Exclusion: the following term is NOT in the view

To search on a specific attribute, first add it as a facet and then add @ to specify you are searching on a facet.

For instance, if your facet name is url and you want to filter on the url value www.datadoghq.com, enter:

@url:www.datadoghq.com

Escaping of special characters

Searching on a facet value that contains special characters requires escaping or double quotes. The following characters are considered special: ?, >, <, :, =,", ~, /, and \ require escaping with the \ character.

The same logic is applied to spaces within views facet names. Views facets should not contain spaces, but if they do, spaces must be escaped. If a facet is named user.first name, perform a facet search by escaping the space: @user.first\ name:myvalue.

Wildcards

To perform a multi-character wildcard search, use the * symbol. For instance, @http.url:https:\/\/* matches every views that has an url starting with https://.

Numerical values

Use <,>, <=, or >= to perform a search on numerical attributes. For instance, retrieve all views that have a duration over 100ns with:

@duration:>100

You can search for numerical attribute within a specific range. For instance, retrieve all your views with a duration between 100ns and 300ns:

@duration:[100 TO 300]

Autocomplete

Use the search bar’s autocomplete feature to complete your query using existing values:

Examples

Search queryDescription
@http.url_details.path:"/api/v1/test"Searches all views containing /api/v1/test in the attribute http.url_details.path.
@http.url:\/api\/v1\/*Searches all views containing a value in http.url attribute that start with /api/v1/
@duration:[100 TO 300] @http.url_details.path:\/api\/v1\/*Searches all views with a duration between 100 and 300 ns, and containing a value in http.url_details.path attribute that start with /api/v1/

Vizualisation

Click on any view to open the views panel and see more details (Resources, Traces, Errors, User Action, Long task, Logs, or Attributes) about it:

Facets & Measures

After being collected, your views attributes can be indexed as facets or measures in order to be accessible for your context creation and analytics.

Note: To leverage the most out of your RUM Explorer page, make sure your views attributes follow Datadog attribute naming convention.

A facet displays all the distinct members of an attribute or a tag and provides some basic analytics, such as the number of views represented. Facets allow you to pivot or filter your datasets based on a given attribute. To filter, select the values that you want to see.

Create a Facet:

To start using an attribute as a facet or in the search, click on it and add it as a facet in the:

Once this is done, the value of this attribute is stored for all new views and can be used in the search bar, the facets panel, and in the RUM Analytics query.

A measure is an attribute with a numerical value contained in your views.

Create a Measure:

To start using an attribute as a measure, click on a numerical attribute of your views:

Once this is done, the value of this attribute is stored for all new views and can be used in the search bar, the facets panel, and in the RUM Analytics query.

Select the Measure Unit:

Each measure has its own unit that is then used for display in the RUM Explorer columns and RUM Analytics.

Further Reading

Additional helpful documentation, links, and articles: