sentry-ruby：实践指南

作者：袖梨 2026-09-12

在项目中评估sentry-ruby，可以先看清用途边界：适用于 Ruby 的 Sentry SDK。团队若要把它用于日常自动化，应先处理输入边界、依赖和失败处理如果不清楚就很难稳定复用，否则试用结果很容易失真。落地前可以用一项范围明确的真实任务完成最小试跑，用配置时间、输出质量、异常信息和维护痕迹判断它是否真的省事。对愿意先做小范围验证并复查原始文档的团队来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。

</picture>

糟糕的软件无处不在，我们已经厌倦了。 Sentry 的使命是帮助开发人员更快地编写更好的软件，以便我们能够重新享受技术带来的乐趣。如果您想加入我们 查看我们的持仓

红宝石哨兵 SDK

当前版本	构建	覆盖范围	API 文档

从哨兵乌鸦迁移

旧的 sentry-raven 客户端已进入维护模式，并已移至这里。

如果您使用的是 sentry-raven，我们建议您迁移到这个新的 SDK。您可以在我们的迁移指南中找到迁移的好处以及如何进行迁移。

要求

我们在最新的 patchlevel/teeny 版本上从 Ruby 2.4 到 Ruby 4.0 进行测试。我们还支持JRuby 9.0。

如果您使用自托管的Sentry，还请确保其版本高于20.6.0。

开始使用

安装

gem "sentry-ruby"

并且取决于您想要的集成，您可能还想安装这些：

gem "sentry-rails"
gem "sentry-sidekiq"
gem "sentry-delayed_job"
gem "sentry-resque"
gem "sentry-opentelemetry"
gem "sentry-yabeda"

配置

您需要使用 Sentry.init 来初始化和配置您的 SDK：

require "sentry-ruby"

Sentry.init do |config|
  config.dsn = "MY_DSN"
end

要了解有关可用配置选项的更多信息，请访问官方文档。

性能监控

您可以通过启用跟踪采样来激活性能监控：

Sentry.init do |config|
  # set a uniform sample rate between 0.0 and 1.0
  config.traces_sample_rate = 0.2
  # you can also use traces_sampler for more fine-grained sampling
  # please click the link below to learn more
end

了解更多关于采样交易的信息，请访问官方文档。

迁移指南

集成