--- title: Search RUM Events description: >- Search and filter RUM events by type, attributes, and full-text queries to analyze user sessions, performance, and errors. breadcrumbs: Docs > RUM & Session Replay > RUM Explorer > Search RUM Events --- # Search RUM Events ## Overview{% #overview %} After applying a time range on the top right, you can find events with `key:value` pairs and a full-text search in the RUM Explorer. ## Event types{% #event-types %} While RUM automatically captures events, you can also capture your own events. All auto-captured and custom events are stored into six event types for [browser](https://docs.datadoghq.com/real_user_monitoring/application_monitoring/browser/data_collected.md), [iOS](https://docs.datadoghq.com/real_user_monitoring/android/data_collected.md), [Android](https://docs.datadoghq.com/real_user_monitoring/ios/data_collected.md), and [React Native](https://docs.datadoghq.com/real_user_monitoring/reactnative.md) applications and indexed to become searchable. | Event Type | Retention | Description | | ---------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Session | 30 days | A user session begins when a user starts browsing the web application. It contains high-level information about the user (such as browser, device, and geolocation). It aggregates all RUM events collected during the user journey with a unique `session.id` attribute. | | View | 30 days | A view event is generated each time a user visits a page of the web application. While the user remains on the same page, resource, long-task, error, and action events are linked to the related RUM view with the `view.id` attribute. | | Action | 30 days | RUM action events track user interactions during a user journey and can be manually sent to monitor custom user actions. | | Error | 30 days | RUM collects every frontend error emitted by the browser. | | Resource | 15 days | A resource event is generated for images, XHR, Fetch, CSS, or JS libraries loaded on a webpage. It includes detailed loading timing information. | | Long Task | 15 days | A long task event is generated for any task in the browser that blocks the main thread for more than 50ms. | To search through your RUM events, select an event type from the dropdown menu to the left of the search bar. {% image source="https://docs.dd-static.net/images/real_user_monitoring/explorer/search/rum-explorer-search-4.1e2aeaee94583dd744fb02d9e1d92170.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/explorer/search/rum-explorer-search-4.1e2aeaee94583dd744fb02d9e1d92170.png?auto=format&fit=max&w=850&dpr=2 2x" alt="RUM Explorer" /%} ## Search query{% #search-query %} To filter on sessions produced by a specific application by real users over the past day, use the application selector from the top navigation, then create a custom query such as `@session.type:user` and set the time range to `1d`. **Note:** If you are including a facet in your query, be sure to create the facet first. ### Search syntax{% #search-syntax %} For more information about searching for RUM events and using time frames, see [Search Syntax](https://docs.datadoghq.com/real_user_monitoring/explorer/search_syntax.md) and [Custom Time Frames](https://docs.datadoghq.com/dashboards/guide/custom_time_frames.md). ## Setup facets and measures{% #setup-facets-and-measures %} All RUM events contain attributes, which are automatically collected by the RUM SDKs, and your custom attributes, which are displayed on the [event side panel](https://docs.datadoghq.com/real_user_monitoring/explorer/events.md). While most automatically collected attributes are indexed and faceted, your custom event attributes are not indexed and faceted by default. Index these attributes by creating a facet or measure to be able to access them in your search and [visualizations](https://docs.datadoghq.com/real_user_monitoring/explorer/visualize.md#timeseries). ### Facets{% #facets %} A facet displays all distinct members of an attribute or tag and provides basic analytics, such as the number of RUM events represented. Facets allow you to pivot or filter your datasets based on a given attribute. Selecting a value applies a filter in the search bar. {% image source="https://docs.dd-static.net/images/real_user_monitoring/explorer/rum-facet-3.b9d8330bec900bf760381ed83c567323.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/explorer/rum-facet-3.b9d8330bec900bf760381ed83c567323.png?auto=format&fit=max&w=850&dpr=2 2x" alt="List of facets to the left of the events list" /%} To create a facet, find and click on an attribute in the [event side panel](https://docs.datadoghq.com/real_user_monitoring/explorer/events.md). This creates a section of attributes for the values in the side panel, such as "Country subdivision". {% image source="https://docs.dd-static.net/images/real_user_monitoring/explorer/create_facet.13a4fbde2af9612ac12b743ce7d67348.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/explorer/create_facet.13a4fbde2af9612ac12b743ce7d67348.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Create a facet" /%} You can also take metadata from a session and turn it into a facet (Virginia, for example) by clicking **+ Add** from the left side panel, then entering or selecting a path to the facet. {% image source="https://docs.dd-static.net/images/real_user_monitoring/explorer/create-facet-3.31094e0c167c96dcd315b2fcf9632833.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/explorer/create-facet-3.31094e0c167c96dcd315b2fcf9632833.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Create a facet using the +Add button from the facet list" /%} You can click **Advanced options** to customize the facet further, such as providing a different display name, type, group, or description. {% image source="https://docs.dd-static.net/images/real_user_monitoring/explorer/create-facet-2.6854fb960701755c2c27107dab90a037.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/explorer/create-facet-2.6854fb960701755c2c27107dab90a037.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Advanced options for the new facet" /%} The value for the attribute is stored across all new views. You can access these attributes in the search bar, the **Facets** panel, and your [visualizations](https://docs.datadoghq.com/real_user_monitoring/explorer/visualize.md#timeseries). ### Measures{% #measures %} A measure is an attribute with a numerical value contained in your RUM events. To create a measure, find and click on a numerical attribute in the [event side panel](https://docs.datadoghq.com/real_user_monitoring/explorer/events.md). {% image source="https://docs.dd-static.net/images/real_user_monitoring/explorer/create_measure.0125dbbc6a11c2ce0afb39463d8348bf.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/explorer/create_measure.0125dbbc6a11c2ce0afb39463d8348bf.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Create a measure" /%} The value of this attribute is stored across all new RUM events. You can access these attributes in the search bar, the **Facets** panel, and your [visualizations](https://docs.datadoghq.com/real_user_monitoring/explorer/visualize.md#timeseries). {% image source="https://docs.dd-static.net/images/real_user_monitoring/explorer/edit_measure.c362e34924d461a2ba357f69d3cb285d.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/explorer/edit_measure.c362e34924d461a2ba357f69d3cb285d.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Edit a measure" /%} Every measure has a unit that is displayed in a column of the [RUM Explorer](https://docs.datadoghq.com/real_user_monitoring/explorer.md) and in [your visualizations](https://docs.datadoghq.com/real_user_monitoring/explorer/visualize.md#timeseries). ## Search for facets{% #search-for-facets %} To search for a specific attribute, add it as a facet and enter `@` in your search query. This specifies that you are searching for a facet. For example, if your facet name is **url** and you want to filter on the **url** value `www.datadoghq.com`, enter `@url:www.datadoghq.com`. ## Further Reading{% #further-reading %} - [Group queried RUM events](https://docs.datadoghq.com/real_user_monitoring/explorer/group.md) - [Apply visualizations on your events](https://docs.datadoghq.com/real_user_monitoring/explorer/visualize.md)