A release is a version of your code deployed to an environment. When you notify Sentry about a release, you can easily identify new issues and regressions, whether an issue is resolved in the next release, and apply source maps.

Releases also offer significant additional features when you fully configure your SDK:

Releases Index

The Releases page provides a high-level view of:

  • Each release version
  • The associated project
  • The adoption stage of each release
  • The authors of each commit
  • The percentage of crash-free users
  • The percentage of crash-free sessions

Each release links to one project. If a release has multiple projects, Sentry will duplicate the release data in relation to each project.

The page presents adoption of the release from the past 24 hours.

View of the release index page showing each version of projects related to the release and the project details.

Track Release Health

Release health provides insight into the impact of crashes and bugs as it relates to your user's experience and reveals trends with each new issue. Monitor release health by observing user adoption, usage of the application, percentage of crashes, and session data.

You can view release health data either from the Issue Details page by selecting the commit ID listed under Last Seen, or from the Releases page.

Apply Source Maps

Releases are required to apply source maps for our JavaScript SDK, which lets you view source code context obtained from stack traces in their original untransformed form. This is particularly useful for debugging minified code (for example, UglifyJS), or transpiled code from a higher-level language (such as TypeScript and ES6).

Enable Suspect Commits

Suspect commits predict which commit caused an issue and who is likely responsible. Sentry uses commit metadata from your source code repositories to identify the suspect commit.

You can resolve issues quickly using the Issue Details page to view suspect commits as well as the list of authors of those commits. In addition, we can automatically assign or alert the issue owner, based on your organization's ownership rules.

Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) to suggesting an update ("yeah, this would be better").