Releases & Health

A release is a version of your code that is deployed to an environment. When you give Sentry information about your releases, you can:

  • Determine issues and regressions introduced in a new release
  • Predict which commit caused an issue and who is likely responsible
  • Resolve issues by including the issue number in your commit message
  • Receive email notifications when your code gets deployed

Bind the Version

Include a release ID (often called a "version") when you configure your client SDK. This ID is commonly a git SHA or a custom version number.

The release name cannot:

  • contain newlines, tabulator characters, forward slashes(/) or back slashes(\)
  • be (in their entirety) period (.), double period (..), or space ( )
  • exceed 200 characters
Copied
using Sentry;

SentryXamarin.Init(o => o.Release = "my-project-name@2.3.12");

The SDK attempts to locate the release to add to events sent to Sentry.

If that returns null, it'll look at the default {PackageName}@{VersionString} where the value varies according to the platform, for instance, on Android this value is going to be the join of the package in the manifest and android:versionName in the application, for iOS, the release value is CFBundleIdentifier for PackageName and CFBundleShortVersionString for Version. Lastly, for UWP, the Name on the Identity node is PackageName while VersionString comes from Version on the Identity node.

How you make the version available to your code is up to you. For example, you could use an environment variable that is set during the build process.

This tags each event with the release value. We recommend that you tell Sentry about a new release before deploying it, as this will unlock a few more features as discussed in our documentation about releases. But if you don’t, Sentry will automatically create a release entity in the system the first time it sees an event with that release ID.

After configuring your SDK, you can install a repository integration or manually supply Sentry with your own commit metadata. Read our documentation about setting up releases for further information about integrations, associating commits, and telling Sentry when deploying releases.

You can edit this page on GitHub.