Quartz Integration for Spring Boot

Learn how to send check-ins for your Quartz jobs.

Sentry's Quartz integration is provided through SentryJobListener which you have to add to your scheduler instance.

The Quartz integration will be configured automatically if you're using spring-boot-starter-quartz with either the sentry-spring-boot-starter or the sentry-spring-boot-jakarta-starter integration. However, you still have to specify the monitor slug as shown below.

Check-ins may also be sent manually or if you're using Sentry's Spring Boot integration you can send send check-ins for your @Scheduled tasks by using our @SentryCheckIn annotation.

To install use:

Copied
plugins {
  id "io.sentry.jvm.gradle" version "6.27.0"
}

For other dependency managers, check out the central Maven repository.

You have to provide the monitor slug either

  • when building a Quartz JobDetail instance
  • or when building a Quartz Trigger instance

To do so, you have to add an entry to the jobs data map:

Copied
import io.sentry.quartz.SentryJobListener;

// you can set the monitor slug on the job detail
JobDetailFactoryBean jobDetailFactory = new JobDetailFactoryBean();
jobDetailFactory.setJobDataAsMap(Collections.singletonMap(SentryJobListener.SENTRY_SLUG_KEY, "<monitor-slug>"));

// you can also set the monitor slug on the trigger
SimpleTriggerFactoryBean trigger = new SimpleTriggerFactoryBean();
trigger.setJobDataAsMap(Collections.singletonMap(SENTRY_SLUG_KEY, "monitor_slug_simple_trigger"));

From Sentry Java SDK version 8.64.0, SentryJobListener can send a monitor config derived from the job's trigger with each check-in, so Sentry creates the monitor (or updates its schedule) from your code.

To turn it on for a job, set SentryJobListener.SENTRY_UPSERT_MONITOR_CONFIG_KEY to the string "true" in the job data map, next to the monitor slug. Like the slug, it also works in the trigger's job data map:

Copied
Map<String, Object> jobData = new HashMap<>();
jobData.put(SentryJobListener.SENTRY_SLUG_KEY, "<monitor-slug>");
jobData.put(SentryJobListener.SENTRY_UPSERT_MONITOR_CONFIG_KEY, "true");

JobDetailFactoryBean jobDetailFactory = new JobDetailFactoryBean();
jobDetailFactory.setJobDataAsMap(jobData);

The config is derived like this:

  • CronTrigger: the cron expression and the trigger's time zone. The seconds field must be a fixed number, and the year field, if set, must be *. If the seconds field isn't 0, a check-in margin of 2 minutes is sent too, since the job checks in up to 59 seconds after the minute Sentry expects. This replaces a margin set in Sentry; set a larger options.cron default check-in margin to keep it.
  • SimpleTrigger that repeats forever: the repeat interval, if it's a whole number of minutes.

No monitor config is sent for:

  • Other trigger types
  • Triggers with a Calendar
  • Jobs with more than one trigger
  • Cron expressions with syntax Sentry doesn't support, such as 15W, L-3, or wrap-around ranges like FRI-MON
  • Cron expressions with a step after a day or month name, such as MON/2 (which Quartz runs every Monday)
  • Time zones that aren't IANA time zone IDs, except whole-hour offsets such as GMT+2, which are sent as Etc/GMT-2

For these, create the monitor in Sentry first.

Was this helpful?
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").