diff --git a/docs/platforms/android/configuration/releases.mdx b/docs/platforms/android/configuration/releases.mdx index dec66de035fe20..d1a53bb4d20e7a 100644 --- a/docs/platforms/android/configuration/releases.mdx +++ b/docs/platforms/android/configuration/releases.mdx @@ -29,7 +29,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/apple/common/configuration/releases.mdx b/docs/platforms/apple/common/configuration/releases.mdx index 8d102d13f33e7d..28ad9195869ad0 100644 --- a/docs/platforms/apple/common/configuration/releases.mdx +++ b/docs/platforms/apple/common/configuration/releases.mdx @@ -27,7 +27,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. diff --git a/docs/platforms/dart/guides/flutter/configuration/releases.mdx b/docs/platforms/dart/guides/flutter/configuration/releases.mdx index 8c49e8dfdd77f2..152472c02f50f4 100644 --- a/docs/platforms/dart/guides/flutter/configuration/releases.mdx +++ b/docs/platforms/dart/guides/flutter/configuration/releases.mdx @@ -27,7 +27,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/dotnet/common/configuration/releases.mdx b/docs/platforms/dotnet/common/configuration/releases.mdx index 4b08068dd7871d..e9026e4713c8b3 100644 --- a/docs/platforms/dotnet/common/configuration/releases.mdx +++ b/docs/platforms/dotnet/common/configuration/releases.mdx @@ -27,7 +27,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/godot/configuration/releases.mdx b/docs/platforms/godot/configuration/releases.mdx index 58dd8a809fa2c5..3c9d38de400ba7 100644 --- a/docs/platforms/godot/configuration/releases.mdx +++ b/docs/platforms/godot/configuration/releases.mdx @@ -33,7 +33,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/java/common/configuration/releases.mdx b/docs/platforms/java/common/configuration/releases.mdx index 6aa0c962ad9381..42a0ab56cc6da6 100644 --- a/docs/platforms/java/common/configuration/releases.mdx +++ b/docs/platforms/java/common/configuration/releases.mdx @@ -29,7 +29,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/javascript/common/configuration/releases.mdx b/docs/platforms/javascript/common/configuration/releases.mdx index 9492c36b7262ca..3327032df02223 100644 --- a/docs/platforms/javascript/common/configuration/releases.mdx +++ b/docs/platforms/javascript/common/configuration/releases.mdx @@ -29,7 +29,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/native/common/configuration/releases.mdx b/docs/platforms/native/common/configuration/releases.mdx index 8c49e8dfdd77f2..152472c02f50f4 100644 --- a/docs/platforms/native/common/configuration/releases.mdx +++ b/docs/platforms/native/common/configuration/releases.mdx @@ -27,7 +27,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/powershell/configuration/releases.mdx b/docs/platforms/powershell/configuration/releases.mdx index 8c49e8dfdd77f2..152472c02f50f4 100644 --- a/docs/platforms/powershell/configuration/releases.mdx +++ b/docs/platforms/powershell/configuration/releases.mdx @@ -27,7 +27,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/python/configuration/releases.mdx b/docs/platforms/python/configuration/releases.mdx index 98c0bc7d5a4832..24ba0afa3f72fc 100644 --- a/docs/platforms/python/configuration/releases.mdx +++ b/docs/platforms/python/configuration/releases.mdx @@ -46,6 +46,6 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends sessions. diff --git a/docs/platforms/python/configuration/sessions.mdx b/docs/platforms/python/configuration/sessions.mdx index bab570ccc4e03e..2f71806a21a1a3 100644 --- a/docs/platforms/python/configuration/sessions.mdx +++ b/docs/platforms/python/configuration/sessions.mdx @@ -10,6 +10,6 @@ A session represents the interaction between the user and the application. Sessi ## Tracking Release Health With Sessions -Sessions are used to monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Sessions are used to monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, you need to set a release. diff --git a/docs/platforms/react-native/common/configuration/releases.mdx b/docs/platforms/react-native/common/configuration/releases.mdx index dec66de035fe20..d1a53bb4d20e7a 100644 --- a/docs/platforms/react-native/common/configuration/releases.mdx +++ b/docs/platforms/react-native/common/configuration/releases.mdx @@ -29,7 +29,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/ruby/common/configuration/releases.mdx b/docs/platforms/ruby/common/configuration/releases.mdx index 605ea901df9259..abb9722eaab81d 100644 --- a/docs/platforms/ruby/common/configuration/releases.mdx +++ b/docs/platforms/ruby/common/configuration/releases.mdx @@ -28,7 +28,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/rust/common/configuration/releases.mdx b/docs/platforms/rust/common/configuration/releases.mdx index 516e713bea9878..206d631530656d 100644 --- a/docs/platforms/rust/common/configuration/releases.mdx +++ b/docs/platforms/rust/common/configuration/releases.mdx @@ -51,7 +51,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/unity/configuration/releases.mdx b/docs/platforms/unity/configuration/releases.mdx index 58dd8a809fa2c5..3c9d38de400ba7 100644 --- a/docs/platforms/unity/configuration/releases.mdx +++ b/docs/platforms/unity/configuration/releases.mdx @@ -33,7 +33,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/platforms/unreal/configuration/releases.mdx b/docs/platforms/unreal/configuration/releases.mdx index bb645d88baf66c..760dc0986e51aa 100644 --- a/docs/platforms/unreal/configuration/releases.mdx +++ b/docs/platforms/unreal/configuration/releases.mdx @@ -33,7 +33,7 @@ After configuring your SDK, you can install a repository integration or manually ## Release Health -Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as they relate to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. +Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crashes--unhandled), and [session data](/product/releases/health/#sessions). Release health will provide insight into the impact of crashes and bugs as they relate to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters. In order to monitor release health, the SDK sends session data. diff --git a/docs/product/releases/health/index.mdx b/docs/product/releases/health/index.mdx index 4d30cd0e9e05aa..e193f381e1692f 100644 --- a/docs/product/releases/health/index.mdx +++ b/docs/product/releases/health/index.mdx @@ -13,7 +13,7 @@ Note, that Sessions (as described below) are not the same as a [Session Replay]( -You can monitor the health of releases by observing user adoption, usage of your application, percentage of [crashes](#crashes), and [session data](#sessions). Release health data provides insight into the impact of crashes and bugs related to user experience and reveals trends with each new issue through the release details, graphs, and filters. This data is primarily displayed on the [Releases](/product/releases/) and [Release Details](/product/releases/release-details) pages, but is also reflected in other parts of [sentry.io](https://sentry.io). +You can monitor the health of releases by observing user adoption, usage of your application, percentage of [crashes](#crashes--unhandled), and [session data](#sessions). Release health data provides insight into the impact of crashes and bugs related to user experience and reveals trends with each new issue through the release details, graphs, and filters. This data is primarily displayed on the [Releases](/product/releases/) and [Release Details](/product/releases/release-details) pages, but is also reflected in other parts of [sentry.io](https://sentry.io). > Many SDKs automatically manage the start and end of [sessions](#sessions) when the SDK is initialized, but release health configuration is key to ensuring you're receiving useful data, so check out our information on [which SDKs support release health](/product/releases/setup/#release-health) for links to configuring the SDK, as needed. @@ -68,9 +68,11 @@ Depending on your "Display" selection, the sort options for the **Releases** pag ![Sort By: Active Users dropdown](./img/release_active_users.png) -## Crashes +## Crashes & Unhandled -A _crash_ is when the application had an explicit unhandled error or hard crash. You'll typically be able to view the corresponding issue that captures this event in [sentry.io](https://sentry.io), and errors that did not cause the end of the application should not be included. To search for crash events in **Discover** or on the **Issues** page, filter by `error.unhandled:true`. +A _crash_ is when the application had a hard crash, while _unhandled_ is when an error wasn't explicitly handled by the application. You'll typically be able to view the corresponding issue that captured the crashed event in [sentry.io](https://sentry.io); errors that did not cause the end of the application should not be included. To search for crash events in **Discover** or on the **Issues** page, filter by `error.unhandled:true`. + +Starting with v25.9.0, Sentry differentiates between crashes and unhandled errors, and both are counted separately. Check your SDK release notes and update to the latest version to support the _unhandled_ session status. ### Crash Free Sessions/Users @@ -96,6 +98,14 @@ Please note that the number of crashes is not expected to match the number of cr The number of users that experienced a crash in the specified time range. +## Sessions vs. Issues + +One common misconception is that session data is derived from issues, and that the numbers can be cross referenced. This is not the case. + +Session data is unconditionally sent from SDKs when the integration is enabled (it is enabled by default in most SDKs). This dataset tracks every session start and end, and includes only basic tags related to release and environment. In contrast, issues are derived from error events, which are subject to [inbound filters](/concepts/data-management/filtering/), [sampling](/platform-redirect/?next=/configuration/sampling/), and [quota](/pricing/quotas/) limits. + +These two systems work in parallel to provide different views of your application's health. Session data enables the Release Adoption and Release Health charts and views, which show you the health of your application at a high level, with no sampling or filtering applied. Issues data enables you to drill down into specific issues and have all the context you need to fix them. + ## Release Adoption Depending on the selected display option, we show either: @@ -159,7 +169,7 @@ There is usually no corresponding Sentry issue, as this is a passive action rath ### Crashed -The application had an explicit unhandled error or hard [crash](#crashes). +The application had a hard [crash](#crashes--unhandled). ### Errored @@ -169,4 +179,8 @@ The application shut down normally, but the session experienced handled errors. The session ends normally and no errors occurred during its lifetime. +### Unhandled + +The application had an [unhandled](#crashes--unhandled) error, but the language or framework prevented the process from terminating. Starting with v25.9.0, this status is tracked separately from [crashed](#crashed). + Session status can be defined slightly differently by platform, and not all platforms use all of the statuses above. Check out the docs for your [specific platform](/platform-redirect/?next=/configuration/releases/%23sessions) for more information. diff --git a/docs/product/releases/release-details.mdx b/docs/product/releases/release-details.mdx index 74a1ccdda90740..17c1c999a2e2f6 100644 --- a/docs/product/releases/release-details.mdx +++ b/docs/product/releases/release-details.mdx @@ -14,7 +14,7 @@ The **Release Details** page focuses on an individual release. Elements of the r The graph at the top of the page provides insights into the health of your release by allowing you to choose which metric it displays. Select the time range that you want to review (the default range is the entire release period) and choose from these metrics in the table below the graph: - [Crash Free Session Rate](/product/releases/health/#crash-free-sessionsusers) -- [Healthy](/product/releases/health/#healthy), [Abnormal](/product/releases/health/#abnormal), [Errored](/product/releases/health/#errored) session rate +- [Healthy](/product/releases/health/#healthy), [Abnormal](/product/releases/health/#abnormal), [Errored](/product/releases/health/#errored), [Unhandled](/product/releases/health/#unhandled) session rate - [Crash Free User Rate](/product/releases/health/#crash-free-sessionsusers) - Crashed Session Rate - [Crashed User Rate](/product/releases/health/#crashed-users) @@ -25,7 +25,7 @@ The graph at the top of the page provides insights into the health of your relea In the table below the graph, percentage-based metrics of this release are compared to the average of all releases, so you can spot any differences in trend. -[Errored](/product/releases/health/#errored) sessions are likely to result in handled issues, and [crashed](/product/releases/health/#crashes) sessions in unhandled issues. Click on the issues links to see them in the [Issues](/product/issues/) page. +[Errored](/product/releases/health/#errored) sessions are likely to result in handled issues, and [crashed](/product/releases/health/#crashes--unhandled) sessions in unhandled issues. Click on the issues links to see them in the [Issues](/product/issues/) page. Click on any option in the graph legend to hide it. For example, in a "Session Count" graph, you might hide "Healthy" sessions to see "Crashed" ones in better scale. In the image below, the healthy sessions are displayed, but there are so many healthy sessions compared to all other session types that the crashed ones become invisible in the graph: