获取更多动态,关注公众号:黑客下午茶

Releases & Health

一个 release 是部署到环境中的代码版本。当您向 Sentry 提供有关 release 的信息时,您可以:

  • 确定新版本中引入的问题和回归
  • 预测哪个提交引起了问题,谁可能负责
  • 通过在提交消息中包含问题编号来解决问题
  • 在部署代码时接收电子邮件通知

Bind the Version

在配置客户端 SDK 时包含一个 release ID(通常称为 “version” )。这个 ID 通常是一个 git SHA 或自定义版本号。

release 名称不能:

  • 包含换行符或空格
  • 使用正斜杠(/),反斜杠(\),句点(.),或双句点(..)
  • 超过 200 个字符
Copied
import Sentry

SentrySDK.start { options in
    options.releaseName = "1.0.0"
}

If no release name is set the SDK creates a default combined of CFBundleIdentifier, CFBundleShortVersionString and CFBundleVersion, for example my.project.name@2.3.12+1234.

如何使版本对代码可用由您决定。例如,您可以使用在构建过程中设置的环境变量。

这会用 release 值标记每个事件。我们建议您在部署新版本之前先告诉 Sentry,因为这将释放一些新功能,如关于 releases 的文档中所述。但是,如果您不这样做,Sentry 会在第一次看到具有该 release ID 的事件时自动在系统中创建一个 release 实体。

配置完 SDK 后,您可以安装 repository integration(存储库集成)或手动为 Sentry 提供自己的提交元数据。阅读有关设置发行版的文档,以获取有关集成,关联提交以及在部署发行版时告知 Sentry 的更多信息。

Release Health

通过观察用户采用率,应用程序使用率,crashes 百分比和 session data 来监视 health of releases。Release health 将提供与用户体验相关的崩溃和错误影响的见解,并通过 release 详细信息,图表和过滤器揭示每个新问题的趋势。

初始化 SDK 后,SDK 将自动管理会话的开始和结束。

By default, the session is terminated once the application is in the background for more than 30 seconds. You can change the time out with the option named sessionTrackingIntervalMillis. It takes the amount in milliseconds. For example, to configure it to be 60 seconds:

Copied
import Sentry

SentrySDK.start { options in
    options.dsn = "https://examplePublicKey@o0.ingest.sentry.io/0"
    options.sessionTrackingIntervalMillis = 60000
}

If you'd like to opt-out of this feature, you can do it via options.

Copied
import Sentry

SentrySDK.start { options in
    options.dsn = "https://examplePublicKey@o0.ingest.sentry.io/0"
    // If you prefer NOT to track release health.
    options.enableAutoSessionTracking = false
}
You can edit this page on GitHub.