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

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

Child Span Attribute Filters

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	—
Symbol symbol	Symbol associated with the crash.	String	—
Tag Name tag_name	Name of the tag.	String	—
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 Type device_type	Type of device (e.g., mobile, tablet).	Choice (String)	Choices: desktop, mobile, tablet
Device Type model_type	Type/Category of the device model.	String	—
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	—

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	—

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	—
Message log_raw_msg	Message content of the log.	String	—
Message raw_msg	Message content of the log.	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	—

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	—

Root Span Attribute Filters

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

Session Filters

Filter	Description	Type	Constraints
Active Interval Count active_interval_count	Number of active intervals in the session.	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 Cold Start is_cold	True if this session is a cold start of the app.	Boolean	—
Has Crash has_crash	True if the session had a crash.	Boolean	—
Has Low Memory Warning has_low_memory	Whether the session had a low memory warning.	Boolean	—
Has OOM has_oom	True if the session had an out-of-memory event.	Boolean	—
Inactive Interval Count inactive_interval_count	Number of inactive intervals in the session.	int	—
Is First is_first	True if this is the user's first session.	Boolean	—
Network Connectivity network_connectivity	Type of network connection the device is using.	Choice (String)	Choices: mixed, none, wan, wifi
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 was terminated by the user.	Boolean	—

Span Filters

Filter	Description	Type	Constraints
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 (Milliseconds) span_duration	Duration of the span in milliseconds.	int	—
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

Span Attribute Filters

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 Name surface_name	Name of the surface.	String	—

User Filters

Filter	Description	Type	Constraints
Embrace ID device_id	Unique identifier for the device (Embrace ID).	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
User Flow 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

User Flow Attribute Filters

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

Web Resource Filters

Filter	Description	Type	Constraints
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
Web Vital Name name	Name of the web vital.	String	—
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