Filters

Filter Definitions

Filters allow you to query and segment your data in the Embrace dashboard. Use filters to narrow down sessions, crashes, and other telemetry data based on specific criteria.

Understanding Filter Table Columns

Each filter table in this page uses the same columns:

Filter - Human-readable name of the filter, with the key used in APIs or programmatic queries shown below it in monospace (for example, app_version).
Description - Plain-language explanation of what the filter represents and how it is typically used.
Type - Describes the data shape, such as String, Choice (String), int, float, Boolean, Date/DateTime, property (key-value pair), or intrange (integer range).
Constraints - Describes any documented limits on valid values for the filter, such as enumerated choices. If no constraints are listed, the filter accepts any value that matches its type.

ANR Filters

Filter	Description	Type	Constraints
Completion `completion`	State of the ANR at the time of session exit.	Choice (String)	Choices: `all`, `completed`, `exit`
Duration Bucket (Milliseconds) `duration`	Duration of the ANR, bucketed by milliseconds.	intrange	—
Google Capture Supported `support_google_capture`	Whether Google Capture is supported.	Boolean	—
Method `method`	Grouped method for the ANR.	String	—
Sample Type `sample_type`	Type of sample (e.g., first, best).	Choice (String)	Choices: `first`, `best`, `ad`

App Filters

Filter	Description	Type	Constraints
App Version `app_version`	Semantic version number of the app.	String	—
Build `build`	Build identifier of the app.	String	—
Environment `environment`	Deployment environment of the app.	String	—
Environment Detail `environment_detail`	Detailed environment information.	String	—
Hosted SDK Version `host_sdk_version`	Embrace hosted SDK semantic version (Unity, React Native, Flutter). Empty for native apps.	String	—
Last View `last_view`	Last view screen visited in the session.	String	—
SDK Version `sdk_version`	Embrace SDK semantic version.	String	—

Browser Filters

Filter	Description	Type	Constraints
Bot `bot`	Whether the session was generated by a bot.	Boolean	—
Browser Major Version `browser_major_version`	Major version of the web browser.	int	—
Browser Name `browser_name`	Name of the web browser.	String	—
Browser Version `browser_version`	Full version of the web browser.	String	—
Viewport Resolution `viewport_resolution`	Browser viewport size in pixels, as width x height.	String	—
Webdriver `webdriver`	Whether the browser was controlled by automation (navigator.webdriver).	Boolean	—

Child Span Filters

Filter	Description	Type	Constraints
Child Span Attribute Key `child_attribute_key`	Key of a child span attribute.	String	—
Child Span Duration (Milliseconds) `child_duration`	Duration of the child span in milliseconds.	int	—
Child Span Event Name `child_event_name`	Name of the event associated with the child span.	String	—
Child Span Name `child_name`	Name of the child span.	String	—
Child Span Outcome `child_outcome`	Outcome of the child span.	Choice (String)	Choices: `successful`, `failure`, `user_abandon`, `unknown`

Filter	Description	Type	Constraints
Child Span Attribute Key/Value `child_attribute`	Key/Value pair of a child span attribute.	property	—

Crash Filters

Filter	Description	Type	Constraints
Crash ID `crash_group_id`	Unique identifier for the crash.	String	—
File Name `file`	File name associated with the event.	String	—
Framework `framework`	Framework used by the app (e.g., Native, React Native, Flutter).	Choice (String)	Choices: `native`, `react_native`, `unity`
Message `msg`	Message describing the crash.	String	—
Process State `process_state`	Process state at the time of termination.	String	—
Process Visibility `process_visibility`	Process visibility at the time of termination.	String	—
Signal `signal`	Signal associated with the termination.	String	—
Symbol `symbol`	Symbol associated with the crash.	String	—
Termination Code `termination_code`	MetricKit termination reason code.	String	—
Watchdog Event `watchdog_event`	Watchdog event associated with the termination.	String	—
Watchdog Trigger `watchdog_trigger`	The condition that triggered the watchdog termination (e.g., wall clock time, CPU time, graceful termination timeout, deadlock).	String	—

Crash Tag Filters

Filter	Description	Type	Constraints
Tag Name/Value `tag`	Key/Value pair of the tag.	property	—

Device Filters

Filter	Description	Type	Constraints
Country ISO `country`	Device's country as a two-letter ISO country code.	String	—
Device Memory (GB) `device_memory_gb`	Approximate device memory in GiB (navigator.deviceMemory).	float	—
Device Type `device_type`	Type of device (e.g., mobile, tablet).	Choice (String)	Choices: `desktop`, `mobile`, `tablet`, `unknown`
Device Type `model_type`	Type/Category of the device model.	String	—
Effective Connection Type `effective_connection_type`	Effective network connection type (navigator.connection).	Choice (String)	Choices: `slow-2g`, `2g`, `3g`, `4g`
Jailbroken `jailbroken`	Whether or not the device running an app is jailbroken.	Boolean	—
Js Patch `js_patch`	JavaScript patch version.	String	—
Manufacturer `manufacturer`	Name of the device hardware manufacturer.	String	—
Model Factory Name `model`	Device hardware model identifier.	String	—
Model Name `model_market_name`	Market name of the device model.	String	—
Region `region`	Geographic region within a country, such as a state or province.	String	—
Screen Resolution `screen_resolution`	Screen resolution in pixels, as width x height.	String	—

Document Filters

Filter	Description	Type	Constraints
DOM Traversal Limit Reached `dom_state_traversal_limit_reached`	Whether the DOM tree walk bailed out after exceeding the traversal element ceiling.	Boolean	—

Element Timing Filters

Filter	Description	Type	Constraints
Element Load Time (Milliseconds) `load_time`	Milliseconds from zero time to when the element resource was loaded; 0 for text elements.	float	—
Element Render Time (Milliseconds) `render_time`	Milliseconds from zero time to when the element was painted; 0 for cross-origin elements.	float	—
Element Start Time (Milliseconds) `element_start_time`	Render time when non-zero, else load time. Milliseconds from zero time.	float	—
Element Timing Identifier `identifier`	Value of the elementtiming HTML attribute that identifies the observed element.	String	—
Element Type `element`	HTML tag name of the timed element, e.g. IMG or P.	String	—

Exception Filters

Filter	Description	Type	Constraints
Group ID `group_id`	Group identifier for the exception.	String	—
Is Handled `is_handled`	Whether the exception was handled by the app.	Boolean	—
Severity Score `severity_score`	Severity score of the exception.	float	—

Experiments & Flags Filters

Filter	Description	Type	Constraints
Experiment `experiment`	Id/Variant pair of an experiment the session was exposed to.	property	—
Feature Flag `feature_flag`	Id/Variant pair of a feature flag the session was exposed to.	property	—
Has Experiment `has_experiment`	True if the session was exposed to at least one experiment.	Boolean	—
Has Feature Flag `has_feature_flag`	True if the session was exposed to at least one feature flag.	Boolean	—

Issue Filters

Filter	Description	Type	Constraints
Issue Type `issue_type`	Type of issue detected.	String	—

LoAF Script Filters

Filter	Description	Type	Constraints
Script Domain `script_domain`	Domain of the script contributing to long animation frames.	String	—
Script Path `script_path`	Path of the script contributing to long animation frames.	String	—
Script URL `script_url`	Full URL of the script contributing to long animation frames.	String	—
Was From INP `was_from_inp`	Whether the script execution contributed to long animation frames during INP.	Boolean	—

Log Filters

Filter	Description	Type	Constraints
Aggregated Message `log_msg`	An aggregated form of the log message, with common patterns or high cardinality parts replaced.	String	—
File Attachment Error `attachment_error`	Error encountered when attempting to attach a file.	Choice (String)	Choices: `ATTACHMENT_TOO_LARGE`, `OVER_MAX_ATTACHMENTS`, `UNKNOWN`
Group ID `log_group_id`	Group identifier for the log.	String	—
Has File Attachment `has_attachment`	Whether the log has a file attachment.	Boolean	—
Has Logs `has_log`	Whether the session contains logs.	Choice (String)	Choices: `true`
Log Property Key `log_property_key`	Key of a log property.	String	—
Type `log_type`	Type of the log or event.	Choice (String)	Choices: `info`, `warning`, `error`, `system`
Type `type`	Type of the log or event.	Choice (String)	Choices: `info`, `warning`, `error`, `system`

Log Property Filters

Filter	Description	Type	Constraints
Log Property Key/Value `log_property`	Key/Value pair of a log property.	property	—

Network Filters

Filter	Description	Type	Constraints
Connection Error `connection_error`	Type of connection error encountered.	Boolean	—
Domain `domain`	Domain of the HTTP network request.	String	—
Duration Bucket (Milliseconds) `duration_bucket`	Bucket for network request duration.	int	—
First Party `is_first_party`	Whether the network request was to a first-party domain.	Boolean	—
Has Connection Error `has_connection_error`	Whether the network request contains a network connection error.	Boolean	—
Path `path`	Path element of the URL for an HTTP network request.	String	—
Status Code Range `status_code`	Filter by a range of HTTP response status codes.	intrange	—
Status Code Single `status_code_single`	Filter by a specific HTTP response status code.	int	—

OS Filters

Filter	Description	Type	Constraints
OS Major Version `os_major_version`	The major version of the OS.	int	—
OS Name `os_name`	Device operating system name.	String	—
OS Version `os_version`	Full operation system version.	String	—

OTel Log Filters

Filter	Description	Type	Constraints
Event Name `event_name`	Name of the OTel log event (e.g. rage_click, first_interaction).	String	—

Root Span Filters

Filter	Description	Type	Constraints
Root Span Duration (Milliseconds) `root_span_duration`	Duration of the root span in milliseconds.	int	—
Root Span Duration Bucket (Milliseconds) `root_span_duration_bucket`	Bucket for root span duration.	int	—
Root Span Event Name `root_span_event_name`	Event name associated with the root span.	String	—
Root Span Name `root_span_name`	Name of the root span in a performance trace.	String	—
Root Span Outcome `root_span_outcome`	Outcome of the root span.	Choice (String)	Choices: `successful`, `failure`, `user_abandon`, `unknown`
Slow Root Span `root_span_type_slow`	Whether the root span is considered slow.	Boolean	—

Filter	Description	Type	Constraints
Root Span Attribute Key/Value `root_span_attribute`	Key/Value pair of a root span attribute.	property	—

Server Timing Filters

Filter	Description	Type	Constraints
Server Timing Description `description`	Description of the server timing entry.	String	—
Server Timing Name `name`	Name of the server timing entry.	String	—

Session Part Filters

Filter	Description	Type	Constraints
Active Interval Count `active_interval_count`	Number of active intervals in the session part.	int	—
Breadcrumb Message `breadcrumb_message`	Message content of a breadcrumb.	String	—
Has ANR Exit `has_anr`	True if the app exited while an ANR was occurring.	Boolean	—
Has ANR Exit `has_anr_exit`	True if the app exited while an ANR was occurring.	Boolean	—
Has ANR Intervals `has_anr_interval`	Whether the session part had any ANR interval, regardless of whether it caused the app to exit. Unlike Has ANR Exit, which only captures ANRs that terminated the app, this includes all ANR occurrences.	Boolean	—
Has Cold Start `is_cold`	True if this session part is a cold start of the app.	Boolean	—
Has Crash `has_crash`	True if the session part had a crash.	Boolean	—
Has Error Logs `has_error_log`	Whether the session part contains error logs.	Boolean	—
Has Exception `has_exception`	Whether the session part contains unhandled exceptions.	Boolean	—
Has Hang `has_hang`	Whether the session had any hang.	Boolean	—
Has Low Memory Warning `has_low_memory`	Whether the session part had a low memory warning.	Boolean	—
Has OOM `has_oom`	True if the session part had an out-of-memory event.	Boolean	—
Inactive Interval Count `inactive_interval_count`	Number of inactive intervals in the session part.	int	—
Is First `is_first`	True if this is the user's first session part.	Boolean	—
Is Unhealthy `is_unhealthy`	True if the session part had error logs or a crash.	Boolean	—
Network Connectivity `network_connectivity`	Type of network connection the device is using.	Choice (String)	Choices: `mixed`, `none`, `wan`, `wifi`
Page Load Abandoned `page_load_abandoned`	True if this session part was a cold start abandoned before page load completed.	Boolean	—
Session Part End Reason `session_part_end_reason`	Reason why the session part ended.	Choice (String)	Choices: `background`, `web_foreground_inactivity`, `web_soft_navigation`, `user_session_ended`, `unknown`
Session Part Start Reason `session_part_start_reason`	Reason why the session part started.	Choice (String)	Choices: `init`, `foreground`, `web_activity`, `web_soft_navigation`, `user_session_rollover`, `unknown`
State `state`	Whether the app was in the foreground or background.	Choice (String)	Choices: `foreground`, `background`
Was User Terminated `has_user_terminated`	Whether the session part was terminated by the user.	Boolean	—

Span Filters

Filter	Description	Type	Constraints
Duration (Milliseconds) `span_duration`	Duration of the span in milliseconds.	int	—
Has Slow Root Span `span_type_slow`	Whether the span is considered slow.	Boolean	—
Span Attribute Key `span_attribute_key`	Key of a span attribute.	String	—
Span Duration Bucket (Milliseconds) `span_duration_bucket`	Bucket for span duration.	int	—
Span Event Name `span_event_name`	Event name associated with the span.	String	—
Span Is Child `is_child_span`	Whether the span is a child span.	Boolean	—
Span Name `span_name`	Name of the span.	String	—
Span Outcome `span_outcome`	Outcome of the span.	Choice (String)	Choices: `successful`, `failure`, `user_abandon`, `unknown`

Filter	Description	Type	Constraints
Span Attribute Key/Value `span_attribute`	Key/Value pair of a span attribute.	property	—

Surface Filters

Filter	Description	Type	Constraints
Surface Label `surface_label`	Label of the surface.	String	—
Surface Name `surface_name`	Name of the surface.	String	—

Synthetic Filters

Filter	Description	Type	Constraints
Browser `test_profile_name`	Browser/device profile used for testing.	Choice (String)	Choices: `Desktop Fast`, `Desktop Slow`, `Mobile Fast`, `Mobile Medium`, `Mobile Slow`
Page Label `label`	Label assigned to the tested URL.	String	—
Site `site_name`	Customer-facing site name.	String	—

User Filters

Filter	Description	Type	Constraints
Embrace ID `device_id`	Unique identifier for the device.	String	—
Persona `persona`	User persona segment.	String	—
User Email `user_email`	App user's email address.	String	—
User ID `user_id`	User identifier.	String	—
Username `user_name`	App user's username.	String	—

User Flow Filters

Filter	Description	Type	Constraints
Duration (Milliseconds) `user_flow_duration`	Duration of the user flow in milliseconds.	int	—
User Flow End Event Type `user_flow_end_event_type`	Type of event that ended the user flow.	Choice (String)	Choices: `breadcrumb`, `crash`, `custom_view`, `log`, `network`, `session`, `span`, `user_tap`, `view`, `web_view`
User Flow End Reason `user_flow_outcome_reason`	Reason for the user flow outcome.	Choice (String)	Choices: `app_exit`, `timeout`, `new_user_flow_started`, `crash`
User Flow Has Issue `user_flow_has_issue`	Whether the user flow has an issue.	Choice (String)	Choices: `anr`, `crash`, `error_log`, `network_error`
User Flow Name `user_flow_name`	Name of the user flow.	String	—
User Flow Name `crash_user_flow_name`	Name of the user flow.	String	—
User Flow Outcome `user_flow_outcome`	Outcome of the user flow.	Choice (String)	Choices: `abandon`, `complete`, `error`
User Flow Start Event Type `user_flow_start_event_type`	Type of event that started the user flow.	Choice (String)	Choices: `breadcrumb`, `custom_view`, `log`, `network`, `session`, `span`, `user_tap`, `view`, `web_view`

Filter	Description	Type	Constraints
User Flow Attribute Key/Value `user_flow_attribute`	Key/Value pair of a user flow attribute.	property	—

User Timing Filters

Filter	Description	Type	Constraints
Entry Type `entry_type`	Performance API entry type — "mark" or "measure".	Choice (String)	Choices: `mark`, `measure`
Start Time (Milliseconds) `start_time`	Milliseconds from zero time when the entry was recorded.	float	—

User Timing Detail Filters

Filter	Description	Type	Constraints
Detail Attribute Key/Value `detail`	Key/value pair from the user timing detail object.	property	—

Web Behavioral Signals Filters

Filter	Description	Type	Constraints
Did Scroll `max_scroll_depth_did_scroll`	Whether the user scrolled.	Boolean	—
Element Selector `first_interaction_element_selector`	CSS selector of the element that was interacted with.	String	—
Element Selector `rage_click_element_selector`	CSS selector of the element that was rage clicked.	String	—
Element Type `first_interaction_element_type`	HTML element type that was interacted with.	String	—
Element Type `rage_click_element_type`	HTML element type that was rage clicked.	String	—
Interaction Type `first_interaction_interaction_type`	Type of the first interaction (click, tap, keypress, scroll).	String	—
Interaction Type `rage_click_interaction_type`	Type of interaction that triggered the rage click.	String	—

Web Resource Filters

Filter	Description	Type	Constraints
Delivery Type `delivery_type`	—	String	—
Render Blocking Status `render_blocking_status`	Render blocking status of the resource.	Choice (String)	Choices: `blocking`, `non-blocking`
Resource Type `resource_type`	Type of web resource.	Choice (String)	Choices: `script`, `stylesheet`, `image`, `font`, `video`, `audio`, `document`, `other`

Web Vital Filters

Filter	Description	Type	Constraints
BFCache Not Restored Reason `bfcache_not_restored_reason`	Reason the page could not be restored from the back/forward cache.	String	—
INP Element Type `inp_element_type`	Type of the element associated with the INP report.	String	—
Interaction Target `interaction_target`	CSS selector of the interaction target.	String	—
LCP Element Type `lcp_element_type`	Type of the element associated with the LCP report.	String	—
LCP Target `lcp_target`	CSS selector of the LCP element.	String	—
Largest Shift Target `largest_shift_target`	CSS selector of the largest shift target.	String	—
Navigation Type `navigation_type`	Type of navigation that triggered the web vital report.	Choice (String)	Choices: `navigate`, `reload`, `back-forward`, `back-forward-cache`, `prerender`, `restore`, `soft-navigation`
Value `value`	Value of the web vital.	float	—
Web Vital Rating `rating`	Rating of the web vital (e.g., good, poor).	Choice (String)	Choices: `poor`, `needs_improvement`, `good`

Common Filter Combinations

Here are some examples of commonly used filter combinations:

Debug a Specific Version

App Version equals 2.1.0
Combine with other filters to narrow down issues

Find Users in a Specific Country

Country ISO equals US (or any two-letter country code)
Use with App Version to see regional adoption

Analyze Latest Version Performance

App Version Set equals latest
Compare metrics against previous versions

Filter Definitions​

Understanding Filter Table Columns​

ANR Filters​

App Filters​

Browser Filters​

Child Span Filters​

Child Span Attribute Filters​

Crash Filters​

Crash Tag Filters​

Device Filters​

Document Filters​

Element Timing Filters​

Exception Filters​

Experiments & Flags Filters​

Issue Filters​

LoAF Script Filters​

Log Filters​

Log Property Filters​

Network Filters​

OS Filters​

OTel Log Filters​

Root Span Filters​

Root Span Attribute Filters​

Server Timing Filters​

Session Part Filters​

Span Filters​

Span Attribute Filters​

Surface Filters​

Synthetic Filters​

User Filters​

User Flow Filters​

User Flow Attribute Filters​

User Timing Filters​

User Timing Detail Filters​

Web Behavioral Signals Filters​

Web Resource Filters​

Web Vital Filters​

Common Filter Combinations​

Debug a Specific Version​

Find Users in a Specific Country​

Analyze Latest Version Performance​