For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/ddsql_reference/data_directory/dd/dd.rum.dataset.md. A documentation index is available at /llms.txt.

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

RUM Browser Data Collected Documentation

Query Parameters

This dataset uses a polymorphic table function. You must specify parameters when querying.

ParameterTypeRequiredDescription
columnsarray<string>YesList 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_typestringNoOptional event subtype to filter by (e.g., event_type => ’error’).
filterstringNoOptional search string. For example: filter => ‘@application.name:my-app AND @error.source:source’.
from_timestamptimestampNoLower time bound for the query; defaults to the query context if omitted.
to_timestamptimestampNoUpper time bound for the query; defaults to the query context if omitted.

Example Queries

-- 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

TitleIDTypeData TypeDescription
TimestamptimestampcoretimestampTime the RUM event was recorded. Applies to: all.
ServiceservicecorestringUnified service name for the application emitting RUM events. Applies to: all.
SourcesourcecorestringSDK that emitted the event (browser, android, ios, flutter, react-native, roku). Applies to: all.
TeamteamcorestringOwning team tagged on the event. Applies to: all.
Event Type@typeevent_attributestringType of RUM event (session, view, action, error, resource, long_task, vital). Applies to: all.
Application ID@application.idevent_attributestringUnique identifier for the RUM application. Applies to: all.
Application Name@application.nameevent_attributestringName of the RUM application (e.g., my-web-app). Applies to: all.
Session ID@session.idevent_attributestringUnique identifier for the user session. Applies to: all.
Session Type@session.typeevent_attributestringType of session (user, synthetics, ci_test). Applies to: all.
Session Active@session.is_activeevent_attributeboolWhether the session is currently active. Applies to: session.
Session Has Replay@session.has_replayevent_attributeboolWhether the session has an associated session replay recording. Applies to: session.
Session Time Spent@session.time_spentevent_attributeint64Time spent in the session in nanoseconds. Applies to: session.
Session Sample Rate@session.sample_rateevent_attributefloat64Client-side session sampling rate (0.0–1.0). Applies to: session.
Session IP@session.ipevent_attributestringClient IP address captured at the start of the session. Applies to: session.
Session Referrer@session.referrerevent_attributestringReferrer URL for the session. Applies to: session.
Session View Count@session.view.countevent_attributeint64Number of views in the session. Applies to: session.
Session Error Count@session.error.countevent_attributeint64Number of errors in the session. Applies to: session.
Session Crash Count@session.crash.countevent_attributeint64Number of crashes recorded in the session. Applies to: session.
Session Resource Count@session.resource.countevent_attributeint64Number of resources loaded in the session. Applies to: session.
Session Action Count@session.action.countevent_attributeint64Number of actions in the session. Applies to: session.
Session Long Task Count@session.long_task.countevent_attributeint64Number of long tasks recorded in the session. Applies to: session.
Session Frustration Count@session.frustration.countevent_attributeint64Number of frustration signals recorded in the session. Applies to: session.
Session Initial View ID@session.initial_view.idevent_attributestringIdentifier of the first view captured in the session. Applies to: session.
Session Initial View Name@session.initial_view.nameevent_attributestringName of the first view captured in the session. Applies to: session.
Session Initial View URL@session.initial_view.urlevent_attributestringURL of the first view captured in the session. Applies to: session.
Session Initial View URL Host@session.initial_view.url_hostevent_attributestringHost of the initial view URL. Applies to: session.
Session Initial View URL Path@session.initial_view.url_pathevent_attributestringPath portion of the initial view URL. Applies to: session.
Session Initial View URL Path Group@session.initial_view.url_path_groupevent_attributestringParameterized path group of the initial view URL. Applies to: session.
Session Initial View URL Scheme@session.initial_view.url_schemeevent_attributestringURL scheme (e.g., https) of the initial view. Applies to: session.
Session Last View ID@session.last_view.idevent_attributestringIdentifier of the most recent view captured in the session. Applies to: session.
Session Last View Name@session.last_view.nameevent_attributestringName of the most recent view captured in the session. Applies to: session.
Session Last View URL@session.last_view.urlevent_attributestringURL of the most recent view captured in the session. Applies to: session.
Session Last View URL Host@session.last_view.url_hostevent_attributestringHost of the last view URL. Applies to: session.
Session Last View URL Path@session.last_view.url_pathevent_attributestringPath portion of the last view URL. Applies to: session.
Session Last View URL Path Group@session.last_view.url_path_groupevent_attributestringParameterized path group of the last view URL. Applies to: session.
Session Last View URL Scheme@session.last_view.url_schemeevent_attributestringURL scheme (e.g., https) of the last view. Applies to: session.
View ID@view.idevent_attributestringUnique identifier for the page view. Applies to: all.
View Name@view.nameevent_attributestringName of the view (page or screen). Applies to: all.
View URL@view.urlevent_attributestringFull URL of the page view. Applies to: all.
View URL Host@view.url_hostevent_attributestringHost portion of the view URL. Applies to: all.
View URL Path@view.url_pathevent_attributestringPath portion of the view URL. Applies to: all.
View URL Path Group@view.url_path_groupevent_attributestringParameterized path group for the view URL (high-cardinality reduction). Applies to: all.
View Referrer@view.referrerevent_attributestringHTTP referrer captured when the view started. Applies to: view.
View Loading Type@view.loading_typeevent_attributestringHow the view was loaded (e.g., initial_load, route_change). Applies to: view.
View Loading Time@view.loading_timeevent_attributeint64Time to fully load the page in nanoseconds. Applies to: view.
View Time Spent@view.time_spentevent_attributeint64Time spent on the view in nanoseconds. Applies to: view.
First Contentful Paint@view.first_contentful_paintevent_attributeint64Time to first contentful paint (FCP) in nanoseconds. Applies to: view.
Largest Contentful Paint@view.largest_contentful_paintevent_attributeint64Time to largest contentful paint (LCP) in nanoseconds. Applies to: view.
First Input Delay@view.first_input_delayevent_attributeint64First input delay (FID) in nanoseconds. Applies to: view.
Interaction to Next Paint@view.interaction_to_next_paintevent_attributeint64Interaction to next paint (INP) in nanoseconds. Applies to: view.
INP Target Selector@view.interaction_to_next_paint_target_selectorevent_attributestringCSS selector for the element that triggered the INP measurement. Applies to: view.
INP Time@view.interaction_to_next_paint_timeevent_attributeint64Timestamp offset at which the INP was measured, in nanoseconds. Applies to: view.
Cumulative Layout Shift@view.cumulative_layout_shiftevent_attributefloat64Cumulative layout shift (CLS) score, unitless. Applies to: view.
DOM Interactive@view.dom_interactiveevent_attributeint64Time to DOM interactive in nanoseconds. Applies to: view.
DOM Content Loaded@view.dom_content_loadedevent_attributeint64Time to DOM content loaded in nanoseconds. Applies to: view.
DOM Complete@view.dom_completeevent_attributeint64Time to DOM complete in nanoseconds. Applies to: view.
Load Event@view.load_eventevent_attributeint64Time to load event in nanoseconds. Applies to: view.
View Is Active@view.is_activeevent_attributeboolWhether the view was still active when the event was recorded. Applies to: view.
View Is Slow Rendered@view.is_slow_renderedevent_attributeboolWhether the view was flagged as slow rendered (mobile SDKs). Applies to: view.
View Error Count@view.error.countevent_attributeint64Number of errors in the view. Applies to: view.
View Long Task Count@view.long_task.countevent_attributeint64Number of long tasks recorded in the view. Applies to: view.
View Resource Count@view.resource.countevent_attributeint64Number of resources loaded in the view. Applies to: view.
View Action Count@view.action.countevent_attributeint64Number of actions in the view. Applies to: view.
View Frustration Count@view.frustration.countevent_attributeint64Number of frustration signals in the view. Applies to: view.
Action ID@action.idevent_attributestringUnique identifier for the user action. Applies to: action.
Action Type@action.typeevent_attributestringType of action (click, tap, scroll, custom). Applies to: action.
Action Name@action.nameevent_attributestringUser-friendly name for the action. Applies to: action.
Action Target Name@action.target.nameevent_attributestringName of the target element. Applies to: action.
Action Loading Time@action.loading_timeevent_attributeint64Time to complete the action in nanoseconds. Applies to: action.
Frustration Type@action.frustration.typeevent_attributestringType of frustration signal (dead_click, rage_click, error_click). Applies to: action.
Action Error Count@action.error.countevent_attributeint64Number of errors associated with the action. Applies to: action.
Action Long Task Count@action.long_task.countevent_attributeint64Number of long tasks associated with the action. Applies to: action.
Action Resource Count@action.resource.countevent_attributeint64Number of resources loaded as part of the action. Applies to: action.
Error ID@error.idevent_attributestringUnique identifier for the error event. Applies to: error.
Error Source@error.sourceevent_attributestringSource of the error (source, network, agent, console, logger, report, custom). Applies to: error.
Error Source Type@error.source_typeevent_attributestringUnderlying source-language classification of the error (e.g., javascript, ios, android). Applies to: error.
Error Type@error.typeevent_attributestringType or class of the error. Applies to: error.
Error Category@error.categoryevent_attributestringHigh-level error category (e.g., ANR, App Hang, Exception). Applies to: error.
Error Message@error.messageevent_attributestringError message text. Applies to: error.
Error Stack@error.stackevent_attributestringStack trace for the error. Applies to: error.
Error Handling@error.handlingevent_attributestringWhether the error was handled or unhandled. Applies to: error.
Error Handling Stack@error.handling_stackevent_attributestringStack trace captured at the error handler, distinct from the origin stack. Applies to: error.
Error Fingerprint@error.fingerprintevent_attributestringStable fingerprint used to group similar errors together. Applies to: error.
Error Is Crash@error.is_crashevent_attributeboolWhether the error caused an application crash. Applies to: error.
Error Resource Method@error.resource.methodevent_attributestringHTTP method of the resource request that produced a network error. Applies to: error.
Error Resource Status Code@error.resource.status_codeevent_attributeint64HTTP status code of the resource request that produced a network error. Applies to: error.
Error Resource URL@error.resource.urlevent_attributestringURL of the resource request that produced a network error. Applies to: error.
Resource ID@resource.idevent_attributestringUnique identifier for the resource event. Applies to: resource.
Resource Type@resource.typeevent_attributestringType of resource (xhr, fetch, css, js, image, font, document, media, beacon, other). Applies to: resource.
Resource Method@resource.methodevent_attributestringHTTP method for the resource request. Applies to: resource.
Resource Status Code@resource.status_codeevent_attributeint64HTTP status code of the resource response. Applies to: resource.
Resource URL@resource.urlevent_attributestringFull URL of the resource. Applies to: resource.
Resource URL Scheme@resource.url_schemeevent_attributestringScheme portion of the resource URL (e.g., https). Applies to: resource.
Resource URL Host@resource.url_hostevent_attributestringHost portion of the resource URL. Applies to: resource.
Resource URL Path@resource.url_pathevent_attributestringPath portion of the resource URL. Applies to: resource.
Resource URL Path Group@resource.url_path_groupevent_attributestringParameterized path group of the resource URL. Applies to: resource.
Resource Duration@resource.durationevent_attributeint64Total time to load the resource in nanoseconds. Applies to: resource.
Resource Size@resource.sizeevent_attributeint64Size of the resource in bytes. Applies to: resource.
Resource Encoded Body Size@resource.encoded_body_sizeevent_attributeint64Encoded body size of the resource in bytes (compressed). Applies to: resource.
Resource Decoded Body Size@resource.decoded_body_sizeevent_attributeint64Decoded body size of the resource in bytes (uncompressed). Applies to: resource.
Resource Transfer Size@resource.transfer_sizeevent_attributeint64Total bytes transferred for the resource, including headers. Applies to: resource.
Resource Protocol@resource.protocolevent_attributestringNetwork protocol used to fetch the resource (e.g., http/1.1, h2, h3). Applies to: resource.
Resource Delivery Type@resource.delivery_typeevent_attributestringDelivery type of the resource (cache, navigational-prefetch, other). Applies to: resource.
Resource Render Blocking Status@resource.render_blocking_statusevent_attributestringWhether the resource was render-blocking (blocking, non-blocking). Applies to: resource.
Resource Cache Status@resource.cache_statusevent_attributestringCache hit/miss status for the resource. Applies to: resource.
Resource Cache Reason@resource.cache_reasonevent_attributestringReason describing the resource cache outcome. Applies to: resource.
Resource Redirect Time@resource.redirect_timeevent_attributeint64Redirect phase duration in nanoseconds. Applies to: resource.
Resource DNS Time@resource.dns_timeevent_attributeint64DNS lookup duration in nanoseconds. Applies to: resource.
Resource Connect Time@resource.connect_timeevent_attributeint64TCP connect duration in nanoseconds. Applies to: resource.
Resource SSL Time@resource.ssl_timeevent_attributeint64TLS handshake duration in nanoseconds. Applies to: resource.
Resource First Byte Time@resource.first_byte_timeevent_attributeint64Time-to-first-byte (TTFB) for the resource in nanoseconds. Applies to: resource.
Resource Download Time@resource.download_timeevent_attributeint64Download phase duration in nanoseconds. Applies to: resource.
Resource Worker Time@resource.worker_timeevent_attributeint64Service worker processing time in nanoseconds. Applies to: resource.
Resource Provider Name@resource.provider.nameevent_attributestringName of the third-party provider serving the resource. Applies to: resource.
Resource Provider Domain@resource.provider.domainevent_attributestringDomain of the third-party provider serving the resource. Applies to: resource.
Resource Provider Type@resource.provider.typeevent_attributestringType of the third-party provider (e.g., cdn, analytics, advertising). Applies to: resource.
Long Task ID@long_task.idevent_attributestringUnique identifier for the long task event. Applies to: long_task.
Long Task Duration@long_task.durationevent_attributeint64Duration of the long task in nanoseconds. Applies to: long_task.
Long Task Blocking Duration@long_task.blocking_durationevent_attributeint64Portion of the long task that blocked the main thread, in nanoseconds. Applies to: long_task.
Long Task Entry Type@long_task.entry_typeevent_attributestringPerformance 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_frameevent_attributeboolWhether the long task is classified as a frozen frame (mobile). Applies to: long_task.
Long Task Start Time@long_task.start_timeevent_attributeint64Start time offset of the long task in nanoseconds. Applies to: long_task.
Long Task Render Start@long_task.render_startevent_attributeint64Render start offset of the long task in nanoseconds. Applies to: long_task.
Long Task Style and Layout Start@long_task.style_and_layout_startevent_attributeint64Style-and-layout phase start offset of the long task in nanoseconds. Applies to: long_task.
Vital ID@vital.idevent_attributestringUnique identifier for the vital event. Applies to: vital.
Vital Name@vital.nameevent_attributestringName of the custom vital. Applies to: vital.
Vital Type@vital.typeevent_attributestringType of the vital (e.g., duration). Applies to: vital.
Vital Value@vital.valueevent_attributefloat64Numeric value of the vital measurement. Applies to: vital.
Vital Duration@vital.durationevent_attributeint64Duration of the vital measurement in nanoseconds. Applies to: vital.
Vital Description@vital.descriptionevent_attributestringFree-form description associated with the custom vital. Applies to: vital.
Device Type@device.typeevent_attributestringType of device (desktop, mobile, tablet). Applies to: all.
Device Brand@device.brandevent_attributestringBrand of the device (e.g., Apple, Samsung). Applies to: all.
Device Model@device.modelevent_attributestringModel of the device (e.g., iPhone 14). Applies to: all.
Device Name@device.nameevent_attributestringDevice name as reported by the user agent. Applies to: all.
OS Name@os.nameevent_attributestringOperating system name (e.g., iOS, Android, Windows). Applies to: all.
OS Version@os.versionevent_attributestringOperating system version. Applies to: all.
OS Major Version@os.version_majorevent_attributestringMajor version of the operating system. Applies to: all.
Browser Name@browser.nameevent_attributestringBrowser name (e.g., Chrome, Safari, Firefox). Applies to: all.
Browser Version@browser.versionevent_attributestringBrowser version. Applies to: all.
Browser Major Version@browser.version_majorevent_attributestringMajor version of the browser. Applies to: all.
Country@geo.countryevent_attributestringCountry name from geo IP lookup. Applies to: all.
Country ISO Code@geo.country_iso_codeevent_attributestringISO country code from geo IP lookup. Applies to: all.
City@geo.cityevent_attributestringCity name from geo IP lookup. Applies to: all.
Continent@geo.continentevent_attributestringContinent name from geo IP lookup. Applies to: all.
User ID@usr.idevent_attributestringUnique identifier for the user. Applies to: all.
User Email@usr.emailevent_attributestringEmail address of the user. Applies to: all.
User Name@usr.nameevent_attributestringDisplay name of the user. Applies to: all.
Event IDidcorestringA unique identifier for the event.
Discovery Timestampdiscovery_timestampcoreint64The time when Datadog first received the event (milliseconds since Unix epoch). May differ from timestamp if there was an ingestion delay.
Tiebreakertiebreakercoreint64A value used to establish deterministic ordering among events that share the same timestamp.
Ingest Sizeingest_size_in_bytescoreint64The size of the event payload in bytes at the time of ingestion, before any processing.
Random Drawrandom_drawcorefloat64A random value between 0.0 and 1.0 assigned at ingestion, useful for consistent sampling across queries.