SuperAPI AI 工具集

sentry-ruby-setup

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:在 Ruby 项目中安装并配置 Sentry,实现错误监控、日志与追踪。适用于用户要求为 Ruby 应用添加 Sentry、安装 sentry-ruby gem,或为 Rails 等框架配置错误监控的场景。

主要能力:支持 sentry-ruby 基础 SDK,以及 sentry-rails、sentry-sidekiq、sentry-delayed_job、sentry-resque 等框架集成;可配置 DSN、PII 发送、面包屑日志、追踪采样率、性能剖析采样率与日志上报。

使用方式:在 Gemfile 添加 gem "sentry-ruby",如需性能剖析再添加 stackprof(SDK 5.9.0+,兼容所有 Ruby 版本)或 vernier(SDK 5.21.0+,需 Ruby 3.2.1+,多线程服务器更佳,并需设置 config.profiler_class = Sentry::Vernier::Profiler),随后运行 bundle install。尽早调用 Sentry.init 并设置 config.dsn。Rails 项目将初始化放入 config/initializers/sentry.rb,并按需引入 sentry-rails 等 gem。

适用场景:Ruby 应用、Rails 应用及使用 Sidekiq、Delayed Job、Resque 的项目。

限制:要求 Ruby 2.4+ 或较新 JRuby;未设置 DSN 时 SDK 不生效;追踪与剖析需显式设置采样率;资料提示配置项与代码示例可能过时,实施前应核对 docs.sentry.io。验证可用 Sentry.capture_message 或触发错误;若错误未出现需确认初始化时机与 DSN,Rails 错误缺失应改用 sentry-rails。