用途:为 Ruby 项目提供 Sentry SDK 的完整接入向导,适合在 Rails、Sinatra、Rack 或纯 Ruby 应用中启用错误监控、追踪、日志、指标、性能分析与 Crons,也支持从 AppSignal、Honeybadger、Bugsnag、Rollbar、Airbrake 迁移。
主要能力:先扫描 Gemfile 与代码,识别框架、Web 服务器、后台任务、指标库、定时任务、OpenTelemetry 与竞品监控工具,再按结果给出功能推荐与接入路径。功能覆盖错误监控、OTLP 集成、Tracing、Logging、Metrics、Profiling(Beta,需 stackprof 或 vernier)与 Crons。
使用方式:Rails 安装 sentry-ruby、sentry-rails(如用 Sidekiq 再加 sentry-sidekiq 等),在 config/initializers/sentry.rb 中 Sentry.init;Rack/Sinatra 仅装 sentry-ruby,在 config.ru 中使用 Sentry::Rack::CaptureExceptions 中间件。执行 bundle install。DSN、环境、发布版本可通过 SENTRY_DSN、SENTRY_ENVIRONMENT、SENTRY_RELEASE 配置,且 Sentry.init 中的选项优先于环境变量。本地开发可开启 spotlight,无需 DSN。
限制:示例 API 对应 sentry-ruby v6.6.2,实施前应核对官方文档。Profiling 为 Beta,且与 OTLP 不兼容;使用 otlp.enabled 时不应再设 traces_sample_rate。使用 OTLP 时不要同时设置 traces_sample_rate。强制退出前需调用 Sentry.flush,否则事件可能丢失;Puma/Unicorn 分叉后需在 on_worker_boot 或 after_fork 重新初始化。其他未提供的收费、价格或平台信息暂未提供。