You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/errors-inbox/browser-tab.mdx
+22-1Lines changed: 22 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,14 +13,35 @@ redirects:
13
13
freshnessValidatedDate: 2024-01-02
14
14
---
15
15
16
-
With <DNT>**Group errors**</DNT> tab you can dynamically filter and group errors for deeper analysis. Group errors shows you where your JavaScript errors are happening, and provides tools to help you figure out the root cause. You can also query and create dashboards of JS error data in the [query builder](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder), or use the browser API to monitor handled errors.
16
+
With <DNT>**Group errors**</DNT> tab you can dynamically filter and group errors for deeper analysis. Group errors shows you where your JavaScript errors are happening, and provides tools to help you figure out the root cause. You can also track the scope of errors through **Sessions impacted**, which automatically shows how many browser sessions are affected by each error group. Additionally, you can query and create dashboards of JS error data in the [query builder](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder), or use the browser API to monitor handled errors.
17
17
18
18
<img
19
19
title="browser group errors tab "
20
20
alt="a screenshot depiciting the browser group errors tab"
For browser applications, New Relic automatically tracks **Sessions impacted** as a key metric in the Errors inbox. This metric shows the number of unique browser sessions affected by JavaScript errors and helps you understand the scope of issues across your user base.
27
+
28
+
**Key benefits of session impact tracking:**
29
+
30
+
-**Automatic collection**: No additional configuration required - the metric is collected automatically for all browser entities
31
+
-**Fallback metric**: When user impact data isn't available, New Relic displays sessions impacted to ensure visibility into error scope
32
+
-**Prioritization**: Helps you prioritize error fixes by showing which errors affect the most browser sessions
33
+
-**Alerting**: You can create alerts based on sessions impacted thresholds
WHERE metricName='newrelic.error.group.sessionImpact'
41
+
```
42
+
43
+
For more details on impact metrics and alerting, see [Error scope: Users, sessions, and devices impacted](/docs/errors-inbox/error-scope-users-sessions-devices-impacted/).
44
+
24
45
To examine JavaScript errors:
25
46
26
47
1. Go to <DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Errors**</DNT>.
metaDescription: "Triage more effectively by viewing how many users are impacted by an error group."
2
+
title: 'Error scope: Users, sessions, and devices impacted'
3
+
metaDescription: "Triage more effectively by viewing how many users, sessions, or devices are impacted by an error group."
4
4
redirects:
5
5
- /docs/errors-inbox/users-impacted
6
+
- /docs/errors-inbox/error-users-impacted
6
7
freshnessValidatedDate: never
7
8
---
8
9
9
-
New Relic agents automatically capture data about user impact. When you organize by error group, you can see how many users are affected by errors. This helps you prioritize where to focus your debugging efforts by showing you the errors with the highest numbers of users affected.
10
+
New Relic agents automatically capture data about the scope of errors affecting your applications. When you organize by error group, you can see the impact through three key metrics:
11
+
12
+
-**Users impacted**: The number of unique users affected by errors
13
+
-**Sessions impacted**: The number of unique browser sessions affected (fallback for browser entities)
14
+
-**Devices impacted**: The number of unique mobile devices affected (fallback for mobile entities)
15
+
16
+
When users impacted data isn't available, New Relic automatically displays the appropriate fallback metric based on your entity type. This helps you prioritize where to focus your debugging efforts by showing you the errors with the highest scope of impact.
10
17
11
18
<img
12
-
title="An image showing how to navigate users impacted"
13
-
alt="This is an image of the main errors inbox users impacted"
19
+
title="An image showing how to navigate impact metrics in errors inbox"
20
+
alt="This is an image of the main errors inbox showing users, sessions, and devices impacted"
Go to **[one.newrelic.com](https://one.newrelic.com) > APM & Services > Errors (errors inbox) > Triage**: You can find users impacted in the second column of the **Error groups** table, located beneath the **Error count** and **Error rate** time series.
24
+
Go to **[one.newrelic.com](https://one.newrelic.com) > APM & Services > Errors (errors inbox) > Triage**: You can find impact metrics in the second column of the **Error groups** table, located beneath the **Error count** and **Error rate** time series.
18
25
</figcaption>
19
26
27
+
## Fallback impact metrics [#fallback-metrics]
28
+
29
+
New Relic prioritizes showing the most relevant impact data for your specific application type. When **Users impacted** data isn't available, the system automatically falls back to entity-specific metrics:
30
+
31
+
-**Browser entities**: Displays **Sessions impacted** - the number of unique browser sessions affected by errors
32
+
-**Mobile entities**: Displays **Devices impacted** - the number of unique mobile devices affected by errors
33
+
34
+
These fallback metrics are automatically collected without requiring additional configuration, unlike Users impacted which may need custom attributes. This ensures you always have visibility into the scope of errors affecting your applications, regardless of your setup.
35
+
20
36
## Custom attributes to track users impacted [#custom-attributes]
21
37
22
38
In some cases, an error event may not have attributes that identify the end user affected by that error event. You can manually add custom attributes so our agents capture user-identifying metadata at the time of ingest.
@@ -30,26 +46,85 @@ For example, [OpenTelemetry standards](https://opentelemetry.io/docs/reference/s
30
46
31
47
You can review how New Relic processes custom attributes by reading our doc about [collecting custom events](/docs/data-apis/custom-data/custom-events/collect-custom-attributes/#enabling-custom).
32
48
33
-
## Query for users impacted[#query]
49
+
## Query for impact metrics[#query]
34
50
35
-
The number of users impacted on an error group is recorded as a [Metric data type](/docs/data-apis/understand-data/metric-data/metric-data-type/) with the name `newrelic.error.group.userImpact`. You can use this metric with the following NRQL string:
51
+
Impact metrics for error groups are recorded as [Metric data types](/docs/data-apis/understand-data/metric-data/metric-data-type/) with specific metric names:
52
+
53
+
<CollapserGroup>
54
+
<Collapser
55
+
className="freq-link"
56
+
id="users"
57
+
title="Users impacted"
58
+
>
59
+
60
+
You can query the number of users impacted using `newrelic.error.group.userImpact` as metric name in NRQL queries:
WHERE metricName='newrelic.error.group.userImpact'
41
66
```
42
67
43
-
The metric captures the approximate number of unique users in the time period selected. Additional attributes provided by the `userImpact` metric which can be used in a `FACET` clause are `error.group.guid`, `entity.guid`.
68
+
This NRQL query metric captures the approximate number of unique users in the time period selected. Additional attributes provided by the `userImpact` metric which can be used in a `FACET` clause are `error.group.guid`, `entity.guid`.
69
+
70
+
</Collapser>
71
+
72
+
<Collapser
73
+
className="freq-link"
74
+
id="sessions"
75
+
title="Sessions impacted"
76
+
>
77
+
78
+
You can query the number of sessions impacted using `newrelic.error.group.sessionImpact` as metric name in NRQL queries:
WHERE metricName='newrelic.error.group.deviceUuidImpact'
100
+
```
101
+
102
+
</Collapser>
103
+
104
+
</CollapserGroup>
44
105
45
-
## Alert on users impacted [#alert]
46
106
47
-
By creating an [NRQL alert condition](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-alert-conditions/), developers can trigger <InlinePopovertype="alerts"/> when the amount of users impacted by errors exceeds a threshold.
107
+
108
+
## Alert on impact metrics [#alert]
109
+
110
+
By creating an [NRQL alert condition](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-alert-conditions/), developers can trigger <InlinePopovertype="alerts"/> when the scope of errors exceeds a threshold. You can create alerts for any of the impact metrics:
111
+
112
+
-**Users impacted**: Alert when user impact exceeds your threshold
113
+
-**Sessions impacted**: Alert when browser session impact exceeds your threshold
114
+
-**Devices impacted**: Alert when mobile device impact exceeds your threshold
48
115
49
116
Creating this alert requires determining the [NRQL query](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) which measures the amount of users impacted in a way which best captures your use case.
50
117
51
118
As an example, the following NRQL query measures the amount of unique users which have been impacted by an [error group](/docs/errors-inbox/errors-inbox/#groups) coming from a specific entity:
Once you have decided on a NRQL query, it can be used to create a [NRQL alert condition](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions/#create).
71
186
72
187
To improve the signal to noise ratio of your triggered alerts see [alert creation tips](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions/#condition-tips), [how alert thresholds are evaluated](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions/#advanced-signal), and [alert condition examples](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions/#examples).
73
188
74
189
## Set users impacted with setUser method [#set-users]
75
190
76
-
You can use an agent method to identify an end user. See implementation details for each agent below:
191
+
You can use an agent method to identify an end user for the **Users impacted** metric. Sessions and devices impacted are automatically collected without additional configuration. See implementation details for each agent below:
Copy file name to clipboardExpand all lines: src/content/docs/errors-inbox/mobile-tab.mdx
+23-1Lines changed: 23 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,8 @@ With the **Group crashes** page you can:
20
20
21
21
***Assess overall crash trends**: Review the **Crash rate percentage** and **Crash-free users **percentage charts to quickly identify any anomalies or patterns in crash occurrences.
22
22
***Filter for deeper analysis**: Utilize groups and filters to focus on specific crash attributes, such as device type, location, or custom data points.
23
-
***Identify patterns**: Examine the **Crash location** table for trends related to location, exception type, date, frequency, app version, and the number of affected users.
23
+
***Identify patterns**: Examine the **Crash location** table for trends related to location, exception type, date, frequency, app version, and the number of affected users or devices.
24
+
***Monitor device impact**: Track how many unique devices are affected by crashes through the **Devices impacted** metric, which is automatically collected for mobile applications.
24
25
***Investigate individual crashes**: Select a crash report to view its interaction trail, event trail, thread details, attributes, and other relevant information. You can also resymbolicate or export the details to Xcode for debugging.
25
26
***Update crash status**: Mark the crash as `Resolved` or choose from other status options, such as `Resolved in specific version`.
26
27
@@ -34,6 +35,27 @@ With the **Group crashes** page you can:
34
35
<DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Mobile > Crashes (errors inbox)**</DNT>: With our **Group crashes** tab you can analyze crash rate and crash free users at a glance or dive deeper into specific crash locations.
35
36
</figcaption>
36
37
38
+
## Device impact tracking [#device-impact]
39
+
40
+
For mobile applications, New Relic automatically tracks **Devices impacted** as a key metric in the Errors inbox. This metric shows the number of unique mobile devices affected by crashes and helps you understand the scope of issues across your user base.
41
+
42
+
**Key benefits of device impact tracking:**
43
+
44
+
-**Automatic collection**: No additional configuration required - the metric is collected automatically for all mobile entities
45
+
-**Fallback metric**: When user impact data isn't available, New Relic displays devices impacted to ensure visibility into error scope
46
+
-**Prioritization**: Helps you prioritize crash fixes by showing which errors affect the most devices
47
+
-**Alerting**: You can create alerts based on devices impacted thresholds
WHERE metricName='newrelic.error.group.deviceImpact'
55
+
```
56
+
57
+
For more details on impact metrics and alerting, see [Error scope: Users, sessions, and devices impacted](/docs/errors-inbox/error-scope-users-sessions-devices-impacted/).
58
+
37
59
## Suggested workflow [#workflow]
38
60
39
61
These steps outline our recommended approach to crash investigation, enabling you to gain a complete understanding of the incident, identify contributing factors, and implement effective debugging strategies.
0 commit comments