--- title: RUM Events description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > DDSQL Reference > Data Directory > RUM Events --- # RUM Events This dataset represents Real User Monitoring (RUM) events collected by Datadog. It captures user sessions, page views, user actions, frontend errors, resource loading, and performance metrics from web and mobile applications. RUM data enables analysis of user experience, frontend performance, and application behavior across browsers, devices, and geographic regions. ``` dd.rum ``` Real User Monitoring Public Documentation {% icon name="icon-external-link" /%} RUM Browser Data Collected Documentation {% icon name="icon-external-link" /%} ## Query Parameters This dataset uses a **polymorphic table function**. You must specify parameters when querying. | Parameter | Type | Required | Description | | ---------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `columns` | `array` | Yes | List of fields to return for each RUM event (e.g., 'timestamp', '@session.id', '@view.url', '@error.message'). Must follow with AS (…) to name and type outputs. | | `event_type` | `string` | No | Optional event subtype to filter by (e.g., event_type => 'error'). | | `filter` | `string` | No | Optional search string. For example: filter => '@application.name:my-app AND @error.source:source'. | | `from_timestamp` | `string` | No | Lower time bound for the query; defaults to the query context if omitted. | | `to_timestamp` | `string` | No | Upper time bound for the query; defaults to the query context if omitted. | ## Example Queries ```sql -- Fetch recent RUM errors for a specific application SELECT * FROM dd.rum( columns => ARRAY[ 'timestamp', '@session.id', '@view.url', '@error.source', '@error.type', '@error.message', '@usr.id' ], event_type => 'error', filter => '@application.name:my-web-app', from_timestamp => now() - interval '1 hour', to_timestamp => now() ) AS ( ts TIMESTAMP, session_id VARCHAR, view_url VARCHAR, error_source VARCHAR, error_type VARCHAR, error_msg VARCHAR, user_id VARCHAR ); ``` ## Fields | Title | ID | Type | Data Type | Description | | ----------------------------------- | ----------------------------------------------- | --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | Timestamp | timestamp | core | timestamp | Time the RUM event was recorded. Applies to: all. | | Service | service | core | string | Unified service name for the application emitting RUM events. Applies to: all. | | Source | source | core | string | SDK that emitted the event (browser, android, ios, flutter, react-native, roku). Applies to: all. | | Team | team | core | string | Owning team tagged on the event. Applies to: all. | | Event Type | @type | event_attribute | string | Type of RUM event (session, view, action, error, resource, long_task, vital). Applies to: all. | | Application ID | @application.id | event_attribute | string | Unique identifier for the RUM application. Applies to: all. | | Application Name | @application.name | event_attribute | string | Name of the RUM application (e.g., my-web-app). Applies to: all. | | Session ID | @session.id | event_attribute | string | Unique identifier for the user session. Applies to: all. | | Session Type | @session.type | event_attribute | string | Type of session (user, synthetics, ci_test). Applies to: all. | | Session Active | @session.is_active | event_attribute | bool | Whether the session is currently active. Applies to: session. | | Session Has Replay | @session.has_replay | event_attribute | bool | Whether the session has an associated session replay recording. Applies to: session. | | Session Time Spent | @session.time_spent | event_attribute | int64 | Time spent in the session in nanoseconds. Applies to: session. | | Session Sample Rate | @session.sample_rate | event_attribute | float64 | Client-side session sampling rate (0.0–1.0). Applies to: session. | | Session IP | @session.ip | event_attribute | string | Client IP address captured at the start of the session. Applies to: session. | | Session Referrer | @session.referrer | event_attribute | string | Referrer URL for the session. Applies to: session. | | Session View Count | @session.view.count | event_attribute | int64 | Number of views in the session. Applies to: session. | | Session Error Count | @session.error.count | event_attribute | int64 | Number of errors in the session. Applies to: session. | | Session Crash Count | @session.crash.count | event_attribute | int64 | Number of crashes recorded in the session. Applies to: session. | | Session Resource Count | @session.resource.count | event_attribute | int64 | Number of resources loaded in the session. Applies to: session. | | Session Action Count | @session.action.count | event_attribute | int64 | Number of actions in the session. Applies to: session. | | Session Long Task Count | @session.long_task.count | event_attribute | int64 | Number of long tasks recorded in the session. Applies to: session. | | Session Frustration Count | @session.frustration.count | event_attribute | int64 | Number of frustration signals recorded in the session. Applies to: session. | | Session Initial View ID | @session.initial_view.id | event_attribute | string | Identifier of the first view captured in the session. Applies to: session. | | Session Initial View Name | @session.initial_view.name | event_attribute | string | Name of the first view captured in the session. Applies to: session. | | Session Initial View URL | @session.initial_view.url | event_attribute | string | URL of the first view captured in the session. Applies to: session. | | Session Initial View URL Host | @session.initial_view.url_host | event_attribute | string | Host of the initial view URL. Applies to: session. | | Session Initial View URL Path | @session.initial_view.url_path | event_attribute | string | Path portion of the initial view URL. Applies to: session. | | Session Initial View URL Path Group | @session.initial_view.url_path_group | event_attribute | string | Parameterized path group of the initial view URL. Applies to: session. | | Session Initial View URL Scheme | @session.initial_view.url_scheme | event_attribute | string | URL scheme (e.g., https) of the initial view. Applies to: session. | | Session Last View ID | @session.last_view.id | event_attribute | string | Identifier of the most recent view captured in the session. Applies to: session. | | Session Last View Name | @session.last_view.name | event_attribute | string | Name of the most recent view captured in the session. Applies to: session. | | Session Last View URL | @session.last_view.url | event_attribute | string | URL of the most recent view captured in the session. Applies to: session. | | Session Last View URL Host | @session.last_view.url_host | event_attribute | string | Host of the last view URL. Applies to: session. | | Session Last View URL Path | @session.last_view.url_path | event_attribute | string | Path portion of the last view URL. Applies to: session. | | Session Last View URL Path Group | @session.last_view.url_path_group | event_attribute | string | Parameterized path group of the last view URL. Applies to: session. | | Session Last View URL Scheme | @session.last_view.url_scheme | event_attribute | string | URL scheme (e.g., https) of the last view. Applies to: session. | | View ID | @view.id | event_attribute | string | Unique identifier for the page view. Applies to: all. | | View Name | @view.name | event_attribute | string | Name of the view (page or screen). Applies to: all. | | View URL | @view.url | event_attribute | string | Full URL of the page view. Applies to: all. | | View URL Host | @view.url_host | event_attribute | string | Host portion of the view URL. Applies to: all. | | View URL Path | @view.url_path | event_attribute | string | Path portion of the view URL. Applies to: all. | | View URL Path Group | @view.url_path_group | event_attribute | string | Parameterized path group for the view URL (high-cardinality reduction). Applies to: all. | | View Referrer | @view.referrer | event_attribute | string | HTTP referrer captured when the view started. Applies to: view. | | View Loading Type | @view.loading_type | event_attribute | string | How the view was loaded (e.g., initial_load, route_change). Applies to: view. | | View Loading Time | @view.loading_time | event_attribute | int64 | Time to fully load the page in nanoseconds. Applies to: view. | | View Time Spent | @view.time_spent | event_attribute | int64 | Time spent on the view in nanoseconds. Applies to: view. | | First Contentful Paint | @view.first_contentful_paint | event_attribute | int64 | Time to first contentful paint (FCP) in nanoseconds. Applies to: view. | | Largest Contentful Paint | @view.largest_contentful_paint | event_attribute | int64 | Time to largest contentful paint (LCP) in nanoseconds. Applies to: view. | | First Input Delay | @view.first_input_delay | event_attribute | int64 | First input delay (FID) in nanoseconds. Applies to: view. | | Interaction to Next Paint | @view.interaction_to_next_paint | event_attribute | int64 | Interaction to next paint (INP) in nanoseconds. Applies to: view. | | INP Target Selector | @view.interaction_to_next_paint_target_selector | event_attribute | string | CSS selector for the element that triggered the INP measurement. Applies to: view. | | INP Time | @view.interaction_to_next_paint_time | event_attribute | int64 | Timestamp offset at which the INP was measured, in nanoseconds. Applies to: view. | | Cumulative Layout Shift | @view.cumulative_layout_shift | event_attribute | float64 | Cumulative layout shift (CLS) score, unitless. Applies to: view. | | DOM Interactive | @view.dom_interactive | event_attribute | int64 | Time to DOM interactive in nanoseconds. Applies to: view. | | DOM Content Loaded | @view.dom_content_loaded | event_attribute | int64 | Time to DOM content loaded in nanoseconds. Applies to: view. | | DOM Complete | @view.dom_complete | event_attribute | int64 | Time to DOM complete in nanoseconds. Applies to: view. | | Load Event | @view.load_event | event_attribute | int64 | Time to load event in nanoseconds. Applies to: view. | | View Is Active | @view.is_active | event_attribute | bool | Whether the view was still active when the event was recorded. Applies to: view. | | View Is Slow Rendered | @view.is_slow_rendered | event_attribute | bool | Whether the view was flagged as slow rendered (mobile SDKs). Applies to: view. | | View Error Count | @view.error.count | event_attribute | int64 | Number of errors in the view. Applies to: view. | | View Long Task Count | @view.long_task.count | event_attribute | int64 | Number of long tasks recorded in the view. Applies to: view. | | View Resource Count | @view.resource.count | event_attribute | int64 | Number of resources loaded in the view. Applies to: view. | | View Action Count | @view.action.count | event_attribute | int64 | Number of actions in the view. Applies to: view. | | View Frustration Count | @view.frustration.count | event_attribute | int64 | Number of frustration signals in the view. Applies to: view. | | Action ID | @action.id | event_attribute | string | Unique identifier for the user action. Applies to: action. | | Action Type | @action.type | event_attribute | string | Type of action (click, tap, scroll, custom). Applies to: action. | | Action Name | @action.name | event_attribute | string | User-friendly name for the action. Applies to: action. | | Action Target Name | @action.target.name | event_attribute | string | Name of the target element. Applies to: action. | | Action Loading Time | @action.loading_time | event_attribute | int64 | Time to complete the action in nanoseconds. Applies to: action. | | Frustration Type | @action.frustration.type | event_attribute | string | Type of frustration signal (dead_click, rage_click, error_click). Applies to: action. | | Action Error Count | @action.error.count | event_attribute | int64 | Number of errors associated with the action. Applies to: action. | | Action Long Task Count | @action.long_task.count | event_attribute | int64 | Number of long tasks associated with the action. Applies to: action. | | Action Resource Count | @action.resource.count | event_attribute | int64 | Number of resources loaded as part of the action. Applies to: action. | | Error ID | @error.id | event_attribute | string | Unique identifier for the error event. Applies to: error. | | Error Source | @error.source | event_attribute | string | Source of the error (source, network, agent, console, logger, report, custom). Applies to: error. | | Error Source Type | @error.source_type | event_attribute | string | Underlying source-language classification of the error (e.g., javascript, ios, android). Applies to: error. | | Error Type | @error.type | event_attribute | string | Type or class of the error. Applies to: error. | | Error Category | @error.category | event_attribute | string | High-level error category (e.g., ANR, App Hang, Exception). Applies to: error. | | Error Message | @error.message | event_attribute | string | Error message text. Applies to: error. | | Error Stack | @error.stack | event_attribute | string | Stack trace for the error. Applies to: error. | | Error Handling | @error.handling | event_attribute | string | Whether the error was handled or unhandled. Applies to: error. | | Error Handling Stack | @error.handling_stack | event_attribute | string | Stack trace captured at the error handler, distinct from the origin stack. Applies to: error. | | Error Fingerprint | @error.fingerprint | event_attribute | string | Stable fingerprint used to group similar errors together. Applies to: error. | | Error Is Crash | @error.is_crash | event_attribute | bool | Whether the error caused an application crash. Applies to: error. | | Error Resource Method | @error.resource.method | event_attribute | string | HTTP method of the resource request that produced a network error. Applies to: error. | | Error Resource Status Code | @error.resource.status_code | event_attribute | int64 | HTTP status code of the resource request that produced a network error. Applies to: error. | | Error Resource URL | @error.resource.url | event_attribute | string | URL of the resource request that produced a network error. Applies to: error. | | Resource ID | @resource.id | event_attribute | string | Unique identifier for the resource event. Applies to: resource. | | Resource Type | @resource.type | event_attribute | string | Type of resource (xhr, fetch, css, js, image, font, document, media, beacon, other). Applies to: resource. | | Resource Method | @resource.method | event_attribute | string | HTTP method for the resource request. Applies to: resource. | | Resource Status Code | @resource.status_code | event_attribute | int64 | HTTP status code of the resource response. Applies to: resource. | | Resource URL | @resource.url | event_attribute | string | Full URL of the resource. Applies to: resource. | | Resource URL Scheme | @resource.url_scheme | event_attribute | string | Scheme portion of the resource URL (e.g., https). Applies to: resource. | | Resource URL Host | @resource.url_host | event_attribute | string | Host portion of the resource URL. Applies to: resource. | | Resource URL Path | @resource.url_path | event_attribute | string | Path portion of the resource URL. Applies to: resource. | | Resource URL Path Group | @resource.url_path_group | event_attribute | string | Parameterized path group of the resource URL. Applies to: resource. | | Resource Duration | @resource.duration | event_attribute | int64 | Total time to load the resource in nanoseconds. Applies to: resource. | | Resource Size | @resource.size | event_attribute | int64 | Size of the resource in bytes. Applies to: resource. | | Resource Encoded Body Size | @resource.encoded_body_size | event_attribute | int64 | Encoded body size of the resource in bytes (compressed). Applies to: resource. | | Resource Decoded Body Size | @resource.decoded_body_size | event_attribute | int64 | Decoded body size of the resource in bytes (uncompressed). Applies to: resource. | | Resource Transfer Size | @resource.transfer_size | event_attribute | int64 | Total bytes transferred for the resource, including headers. Applies to: resource. | | Resource Protocol | @resource.protocol | event_attribute | string | Network protocol used to fetch the resource (e.g., http/1.1, h2, h3). Applies to: resource. | | Resource Delivery Type | @resource.delivery_type | event_attribute | string | Delivery type of the resource (cache, navigational-prefetch, other). Applies to: resource. | | Resource Render Blocking Status | @resource.render_blocking_status | event_attribute | string | Whether the resource was render-blocking (blocking, non-blocking). Applies to: resource. | | Resource Cache Status | @resource.cache_status | event_attribute | string | Cache hit/miss status for the resource. Applies to: resource. | | Resource Cache Reason | @resource.cache_reason | event_attribute | string | Reason describing the resource cache outcome. Applies to: resource. | | Resource Redirect Time | @resource.redirect_time | event_attribute | int64 | Redirect phase duration in nanoseconds. Applies to: resource. | | Resource DNS Time | @resource.dns_time | event_attribute | int64 | DNS lookup duration in nanoseconds. Applies to: resource. | | Resource Connect Time | @resource.connect_time | event_attribute | int64 | TCP connect duration in nanoseconds. Applies to: resource. | | Resource SSL Time | @resource.ssl_time | event_attribute | int64 | TLS handshake duration in nanoseconds. Applies to: resource. | | Resource First Byte Time | @resource.first_byte_time | event_attribute | int64 | Time-to-first-byte (TTFB) for the resource in nanoseconds. Applies to: resource. | | Resource Download Time | @resource.download_time | event_attribute | int64 | Download phase duration in nanoseconds. Applies to: resource. | | Resource Worker Time | @resource.worker_time | event_attribute | int64 | Service worker processing time in nanoseconds. Applies to: resource. | | Resource Provider Name | @resource.provider.name | event_attribute | string | Name of the third-party provider serving the resource. Applies to: resource. | | Resource Provider Domain | @resource.provider.domain | event_attribute | string | Domain of the third-party provider serving the resource. Applies to: resource. | | Resource Provider Type | @resource.provider.type | event_attribute | string | Type of the third-party provider (e.g., cdn, analytics, advertising). Applies to: resource. | | Long Task ID | @long_task.id | event_attribute | string | Unique identifier for the long task event. Applies to: long_task. | | Long Task Duration | @long_task.duration | event_attribute | int64 | Duration of the long task in nanoseconds. Applies to: long_task. | | Long Task Blocking Duration | @long_task.blocking_duration | event_attribute | int64 | Portion of the long task that blocked the main thread, in nanoseconds. Applies to: long_task. | | Long Task Entry Type | @long_task.entry_type | event_attribute | string | Performance entry type that produced the long task (e.g., longtask, long-animation-frame). Applies to: long_task. | | Long Task Is Frozen Frame | @long_task.is_frozen_frame | event_attribute | bool | Whether the long task is classified as a frozen frame (mobile). Applies to: long_task. | | Long Task Start Time | @long_task.start_time | event_attribute | int64 | Start time offset of the long task in nanoseconds. Applies to: long_task. | | Long Task Render Start | @long_task.render_start | event_attribute | int64 | Render start offset of the long task in nanoseconds. Applies to: long_task. | | Long Task Style and Layout Start | @long_task.style_and_layout_start | event_attribute | int64 | Style-and-layout phase start offset of the long task in nanoseconds. Applies to: long_task. | | Vital ID | @vital.id | event_attribute | string | Unique identifier for the vital event. Applies to: vital. | | Vital Name | @vital.name | event_attribute | string | Name of the custom vital. Applies to: vital. | | Vital Type | @vital.type | event_attribute | string | Type of the vital (e.g., duration). Applies to: vital. | | Vital Value | @vital.value | event_attribute | float64 | Numeric value of the vital measurement. Applies to: vital. | | Vital Duration | @vital.duration | event_attribute | int64 | Duration of the vital measurement in nanoseconds. Applies to: vital. | | Vital Description | @vital.description | event_attribute | string | Free-form description associated with the custom vital. Applies to: vital. | | Device Type | @device.type | event_attribute | string | Type of device (desktop, mobile, tablet). Applies to: all. | | Device Brand | @device.brand | event_attribute | string | Brand of the device (e.g., Apple, Samsung). Applies to: all. | | Device Model | @device.model | event_attribute | string | Model of the device (e.g., iPhone 14). Applies to: all. | | Device Name | @device.name | event_attribute | string | Device name as reported by the user agent. Applies to: all. | | OS Name | @os.name | event_attribute | string | Operating system name (e.g., iOS, Android, Windows). Applies to: all. | | OS Version | @os.version | event_attribute | string | Operating system version. Applies to: all. | | OS Major Version | @os.version_major | event_attribute | string | Major version of the operating system. Applies to: all. | | Browser Name | @browser.name | event_attribute | string | Browser name (e.g., Chrome, Safari, Firefox). Applies to: all. | | Browser Version | @browser.version | event_attribute | string | Browser version. Applies to: all. | | Browser Major Version | @browser.version_major | event_attribute | string | Major version of the browser. Applies to: all. | | Country | @geo.country | event_attribute | string | Country name from geo IP lookup. Applies to: all. | | Country ISO Code | @geo.country_iso_code | event_attribute | string | ISO country code from geo IP lookup. Applies to: all. | | City | @geo.city | event_attribute | string | City name from geo IP lookup. Applies to: all. | | Continent | @geo.continent | event_attribute | string | Continent name from geo IP lookup. Applies to: all. | | User ID | @usr.id | event_attribute | string | Unique identifier for the user. Applies to: all. | | User Email | @usr.email | event_attribute | string | Email address of the user. Applies to: all. | | User Name | @usr.name | event_attribute | string | Display name of the user. Applies to: all. | | Event ID | id | core | string | A unique identifier for the event. | | Discovery Timestamp | discovery_timestamp | core | int64 | The time when Datadog first received the event (milliseconds since Unix epoch). May differ from timestamp if there was an ingestion delay. | | Tiebreaker | tiebreaker | core | int64 | A value used to establish deterministic ordering among events that share the same timestamp. | | Ingest Size | ingest_size_in_bytes | core | int64 | The size of the event payload in bytes at the time of ingestion, before any processing. | | Random Draw | random_draw | core | float64 | A random value between 0.0 and 1.0 assigned at ingestion, useful for consistent sampling across queries. |