Sentry Ruby Setup Skill

Sentry Ruby Setup

Install and configure Sentry in Ruby projects.

Invoke This Skill When

User asks to "add Sentry to Ruby" or "install Sentry" in a Ruby app
User wants error monitoring, logging, or tracing in Ruby
User mentions "sentry-ruby" gem or Ruby on Rails

Requirements

Ruby 2.4+ or recent JRuby versions

Install

Add to Gemfile:

gem "sentry-ruby"

# For profiling, also add:
gem "stackprof"

Then run:

bundle install

Configure

Initialize as early as possible:

require "sentry-ruby"

Sentry.init do |config|
  config.dsn = "YOUR_SENTRY_DSN"
  config.send_default_pii = true
  
  # Breadcrumbs from logs
  config.breadcrumbs_logger = [:sentry_logger, :http_logger]
  
  # Tracing
  config.traces_sample_rate = 1.0
  
  # Profiling (requires stackprof gem)
  config.profiles_sample_rate = 1.0
  
  # Logs
  config.enable_logs = true
end

Rails Integration

For Rails, add to config/initializers/sentry.rb:

Sentry.init do |config|
  config.dsn = ENV["SENTRY_DSN"]
  config.send_default_pii = true
  config.breadcrumbs_logger = [:active_support_logger, :http_logger]
  config.traces_sample_rate = 1.0
  config.profiles_sample_rate = 1.0
  config.enable_logs = true
end

Rails-specific Gems

# Gemfile
gem "sentry-ruby"
gem "sentry-rails"  # Rails integration
gem "sentry-sidekiq"  # If using Sidekiq
gem "sentry-delayed_job"  # If using Delayed Job
gem "sentry-resque"  # If using Resque

Configuration Options

| Option | Description | Default | |--------|-------------|---------| | dsn | Sentry DSN | Required | | send_default_pii | Include user data | false | | traces_sample_rate | % of transactions traced | 0 | | profiles_sample_rate | % of traces profiled | 0 | | enable_logs | Send logs to Sentry | false | | environment | Environment name | Auto-detected | | release | Release version | Auto-detected |

Breadcrumb Loggers

| Logger | Description | |--------|-------------| | :sentry_logger | Sentry's own logger | | :http_logger | HTTP request breadcrumbs | | :active_support_logger | Rails ActiveSupport (Rails only) |

Environment Variables

SENTRY_DSN=https://xxx@o123.ingest.sentry.io/456
SENTRY_AUTH_TOKEN=sntrys_xxx
SENTRY_ORG=my-org
SENTRY_PROJECT=my-project

Verification

# Capture test message
Sentry.capture_message("Test message from Ruby")

# Or trigger intentional error
1 / 0

Troubleshooting

| Issue | Solution | |-------|----------| | Errors not appearing | Ensure Sentry.init called early, check DSN | | No traces | Set traces_sample_rate > 0 | | No profiles | Add stackprof gem, set profiles_sample_rate | | Rails errors missing | Use sentry-rails gem instead of sentry-ruby |

Agent Skills: Sentry Ruby Setup

Install this agent skill to your local

Skill Files