Skip to content
Closed
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
0121f81
docs(crons): Add rufus-scheduler setup for Ruby
wedamija Oct 3, 2026
16f505d
docs(crons): Update rufus-scheduler slug and time zone notes
wedamija Oct 5, 2026
65f4e57
docs(crons): Clarify rufus-scheduler time zone note
wedamija Oct 5, 2026
6c2693d
docs(crons): Add Solid Queue setup for Ruby
wedamija Oct 16, 2026
8ece47e
docs(crons): Document excluding Solid Queue recurring tasks
wedamija Oct 16, 2026
f07ff33
docs(crons): Use a sub-minute example for unsupported rufus schedules
wedamija Oct 16, 2026
a90c2ff
docs(crons): Use += for the Solid Queue enabled_patches examples
wedamija Oct 16, 2026
16312f4
docs(crons): Add resque-scheduler setup for Ruby
wedamija Oct 19, 2026
e8ad911
docs(crons): Add GoodJob setup for Ruby
wedamija Oct 19, 2026
f3fd934
Merge remote-tracking branch 'origin/danf/ruby-rufus-crons-docs' into…
wedamija Oct 20, 2026
077dfc7
Merge commit 'f3fd9347f585b8bffaae1104d84fce2ee854a047' into tmp-ruby…
wedamija Oct 20, 2026
829e804
Merge commit '077dfc70559e22dcb9d0b6ff1c44294e379845d3' into tmp-ruby…
wedamija Oct 20, 2026
09f8ce4
docs(ruby): Unsupported GoodJob cron schedules aren't monitored
wedamija Oct 29, 2026
2076dfa
docs(crons): Remove resque-scheduler setup from GoodJob PR
wedamija Nov 3, 2026
2cdd137
Merge remote-tracking branch 'origin/master' into danf/ruby-good-job-…
wedamija Nov 11, 2026
d4a28c3
docs(crons): Update GoodJob notes for slug collisions and manual runs
wedamija Nov 11, 2026
cf216b4
docs(crons): Clarify GoodJob time zones and minimum version
wedamija Nov 11, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 46 additions & 1 deletion platform-includes/crons/setup/ruby.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ production:
nightly_report:
class: ReportJob
args: [nightly]
schedule: "0 2 * * * America/New_York"
schedule: "0 4 * * * America/New_York"
weekly_report:
class: ReportJob
args: [weekly]
Expand All @@ -125,6 +125,51 @@ Sentry.init do |config|
end
```

### GoodJob

<Alert>

The GoodJob integration ships in the next `sentry-rails` release after `7.2.0`.

</Alert>

If you're using GoodJob cron (GoodJob 3.14 or later), enable the `:good_job_cron` patch to capture check-ins for every entry in `config.good_job.cron`:

```rb
Sentry.init do |config|
config.enabled_patches += [:good_job_cron]
end
```

```rb {filename:config/application.rb}
config.good_job.enable_cron = true
config.good_job.cron = {
nightly_report: {
cron: "0 4 * * * America/New_York",
class: "ReportJob",
args: ["nightly"],
},
weekly_report: {
cron: "every monday at 9am",
class: "ReportJob",
args: ["weekly"],
},
}
```

The monitor slug is the cron key, so this example creates two monitors: `nightly_report` and `weekly_report`. Each entry gets its own monitor, even when entries share a job class. If two keys turn into the same slug, such as keys longer than 50 characters that start the same way, neither is monitored and the SDK logs a warning.

Sentry creates and updates each monitor from the entry's schedule and time zone. Schedules without a time zone use your app's `Time.zone`. Schedules that can't be expressed in the Crons schedule format, such as a job that runs every 10 seconds, and entries whose `cron` is a proc aren't monitored. Neither are schedules whose time zone is an offset that isn't a whole number of hours, like `+05:30`; whole-hour offsets like `+05:00` are sent as `Etc/GMT-5`. Jobs that already call `sentry_monitor_check_ins` are left as they are. Retries and runs started with **Enqueue now** in the GoodJob dashboard send check-ins too.

To skip entries, list their keys in `config.rails.good_job_exclude_cron_jobs`. Strings and symbols match a cron key exactly, and regular expressions are matched against it:

```rb
Sentry.init do |config|
config.enabled_patches += [:good_job_cron]
config.rails.good_job_exclude_cron_jobs = [:clear_cache, /^tmp_/]
end
```

## Manual Setup

If you're using `Clockwork` or `Whenever`, you'll need to instrument your jobs
Expand Down
Loading