Metrics API Supported Metrics
Standard Metrics
The following metrics are supported as Standard Metrics. Metrics with the suffix "_total" are counters.
To query your desired unit, simply prefix the metric name with the unit, eg: daily_crashes_total
or five_minute_sessions_total.
| Metric | Description | Filters | Time granularity |
|---|---|---|---|
| crashes_total | Number of crashes | app_version, os_version, device_model | five_minute, hourly, daily |
| sessions_total | Number of sessions | app_version, os_version, device_model | five_minute, hourly, daily |
Deprecated metrics after 2023-10-17:
We have deprecated the following metrics in favor of the new metrics mentioned above. All the information provided by these metrics can now be obtained using the new metrics (refer to the Sample Queries section below). These deprecated metrics will remain available for retrieving historical data prior to October 30, 2023. However, we strongly recommend transitioning to the new metrics to ensure a consistent experience.
| Metric | Description | Filters | Time granularity |
|---|---|---|---|
| crash_free_session_by_device_rate_deprecated | Percentage of crash free sessions grouped by device model | app_version, device_model, os_version | hourly, daily |
| crash_session_pct_deprecated | Percentage of crash sessions | app_version, os_version | hourly, daily |
| crash_free_session_rate_deprecated | Percentage of crash free sessions | app_version, os_version | hourly, daily |
| crashed_users_deprecated | Number of unique users with crashes | app_version, os_version | hourly, daily |
| crashes_total_deprecated | Number of crashes | app_version, os_version | five_minute, hourly, daily |
| sessions_by_device_total_deprecated | Number of sessions grouped by device model | app_version, device_model, os_version | hourly, daily |
| sessions_total_deprecated | Number of sessions | app_version, os_version | five_minute, hourly, daily |
| users_deprecated | Number of unique users | app_version, os_version | hourly, daily |
Dimension reduction - "Other"
To reduce storage costs with various observability platforms (eg Datadog), Embrace Metrics examine high cardinality dimensions for consolidation.
Device Models
There are over 40,000 unique device models on the Android operating system. The bottom 39,000 models account for ~30% of data typically. Aside from being expensive to store this many unique values, it is also unwieldy to visualize or review!
Currently, we roll together these long-tail device models into an "other" value.
Sample Queries
Sessions Grouped by App Version
sum(daily_sessions_total{app_id="<app ID>"}) by (app_version)
Sessions Grouped by Devices
sum(daily_sessions_total{app_id="<app ID>"}) by (device_model)
Sessions Grouped by Devices for a Given App Version
sum(daily_sessions_total{app_id="<app ID>", app_version="1.2.3"}) by (device_model)
Percentage of crash free sessions
(1 - (sum(hourly_crashes_total{app_id="$app_id"}) / sum(hourly_sessions_total{app_id="$app_id"}) )) * 100
Percentage of crash free sessions by Devices
1 - sum(hourly_crashes_total{app_id="$app_id"}) by (device_model) / sum(hourly_sessions_total{app_id="$app_id"}) by (device_model) * 100
Percentage of crash sessions by Devices
sum(hourly_crashes_total{app_id="$app_id"}) by (device_model) / sum(hourly_sessions_total{app_id="$app_id"}) by (device_model) * 100
Custom Metrics
Users may request Custom Metrics via their Customer Success Manager. These will be available via the Metrics API and can also be forwarded to your organization's observability platform of choice.
Sample Queries
You can pull data for one, multiple, or all of your organization's apps in a single query.
- To pull for a single app, include the
app_idin the PromQL filter,
sum(hourly_anr_free_sessions{app_id="a1b2C3"})
- To pull for multiple apps, include a pipe-delimited array in the filter,
sum(hourly_crashes_by_tag{app_id=~"a1b2C3|Z9Y8x7"}) by (tag_value)
- To pull for all apps, do not include any app ID in the filter,
sum(five_minute_network_requests_fails_by_domain{}) by (domain)