From 5dc267b0ce66ea4b71d1f1ff0bc919bd2f4930b8 Mon Sep 17 00:00:00 2001 From: Dan Fuller Date: Fri, 16 Oct 2026 18:28:15 -0700 Subject: [PATCH 1/3] docs(js): Document graphileWorkerIntegration for Crons Co-Authored-By: Claude --- ...-crons-automatic-crons-instrumentation.mdx | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/includes/javascript-crons-automatic-crons-instrumentation.mdx b/includes/javascript-crons-automatic-crons-instrumentation.mdx index dfd6e29931c98..f8e09f95a896b 100644 --- a/includes/javascript-crons-automatic-crons-instrumentation.mdx +++ b/includes/javascript-crons-automatic-crons-instrumentation.mdx @@ -160,3 +160,25 @@ schedule.scheduleJob( The monitor slug is the job name. Jobs without a name, and jobs that run once at a `Date`, aren't monitored. `excludeJobs` skips jobs whose name matches a string exactly or a regular expression. For cron strings, each check-in sends the schedule and time zone (your server's time zone if `tz` isn't set). Recurrence rules, and schedules that can't be expressed in the Crons schedule format (for example, a job that runs every 10 seconds), check in without a monitor config, so create those monitors in Sentry first. + +### Graphile Worker + +Requires SDK version `11.5.0` or higher and `graphile-worker` version `0.16.0` or higher. + +Use `Sentry.graphileWorkerIntegration` to monitor the jobs that the [`graphile-worker`](https://www.npmjs.com/package/graphile-worker) crontab schedules: + +```JavaScript +Sentry.init({ + dsn: "___PUBLIC_DSN___", + integrations: [ + Sentry.graphileWorkerIntegration({ + monitorCronJobs: true, + excludeCronJobs: ["cleanup", /^dev_/], // Optional. + }), + ], +}); +``` + +The monitor slug is the crontab item's identifier: its `id` option, or the task name if there's no `id`. `excludeCronJobs` skips items whose identifier matches a string exactly or a regular expression. Jobs are monitored by a process that runs the crontab, which `run()` does by default. + +Check-ins are sent without a schedule, so create the monitors in Sentry first. From 3a1730239ab2f9019511cd24fbb42947a8468873 Mon Sep 17 00:00:00 2001 From: Dan Fuller Date: Tue, 20 Oct 2026 10:48:05 -0700 Subject: [PATCH 2/3] docs(js): Fix the graphile-worker version range and mention error reporting Co-Authored-By: Claude --- includes/javascript-crons-automatic-crons-instrumentation.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/includes/javascript-crons-automatic-crons-instrumentation.mdx b/includes/javascript-crons-automatic-crons-instrumentation.mdx index e8e13014f599d..02ba889d28d87 100644 --- a/includes/javascript-crons-automatic-crons-instrumentation.mdx +++ b/includes/javascript-crons-automatic-crons-instrumentation.mdx @@ -175,7 +175,7 @@ scheduleWithCheckIn.scheduleJob( ### Graphile Worker -Requires SDK version `11.5.0` or higher and `graphile-worker` version `0.16.0` or higher. +Requires SDK version `11.5.0` or higher and `graphile-worker` version `0.16` to `0.18`. Use `Sentry.graphileWorkerIntegration` to monitor the jobs that the [`graphile-worker`](https://www.npmjs.com/package/graphile-worker) crontab schedules: @@ -191,6 +191,6 @@ Sentry.init({ }); ``` -The monitor slug is the crontab item's identifier: its `id` option, or the task name if there's no `id`. `excludeCronJobs` skips items whose identifier matches a string exactly or a regular expression. Jobs are monitored by a process that runs the crontab, which `run()` does by default. +The monitor slug is the crontab item's identifier: its `id` option, or the task name if there's no `id`. `excludeCronJobs` skips items whose identifier matches a string exactly or a regular expression. Jobs are monitored by a process that runs the crontab, which `run()` does by default. Failed runs send an `error` check-in and report the error to Sentry. Check-ins are sent without a schedule, so create the monitors in Sentry first. From 1c84fb1056f3b02d6434e6d1669b616f4dfd8f00 Mon Sep 17 00:00:00 2001 From: Dan Fuller Date: Tue, 20 Oct 2026 11:28:48 -0700 Subject: [PATCH 3/3] docs(js): Use 11.9.0 as the graphile-worker SDK version Co-Authored-By: Claude --- includes/javascript-crons-automatic-crons-instrumentation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/javascript-crons-automatic-crons-instrumentation.mdx b/includes/javascript-crons-automatic-crons-instrumentation.mdx index 7c336499d6203..e3caefc7f7627 100644 --- a/includes/javascript-crons-automatic-crons-instrumentation.mdx +++ b/includes/javascript-crons-automatic-crons-instrumentation.mdx @@ -175,7 +175,7 @@ scheduleWithCheckIn.scheduleJob( ### Graphile Worker -Requires SDK version `11.5.0` or higher and `graphile-worker` version `0.16` to `0.18`. +Requires SDK version `11.9.0` or higher and `graphile-worker` version `0.16` to `0.18`. Use `Sentry.graphileWorkerIntegration` to monitor the jobs that the [`graphile-worker`](https://www.npmjs.com/package/graphile-worker) crontab schedules: