Skip to content

feat(node): Add nodeScheduleIntegration to monitor node-schedule jobs - #25474

Merged
wedamija merged 39 commits into
developfrom
danf/node-schedule-monitor-jobs
Oct 30, 2026
Merged

wedamija merged 39 commits into
developfrom
danf/node-schedule-monitor-jobs

Conversation

@wedamija

@wedamija wedamija commented Oct 17, 2026 •

Copy link
Copy Markdown
Member

Part of a series adding automatic Crons monitoring for the most-used job schedulers in each SDK. Check-ins for a monitor that doesn't exist yet are dropped, so today each monitor has to be created by hand with its schedule copied from the code. Sending the job's schedule as the monitor config lets Sentry create the monitor and keep it in sync.

Adds nodeScheduleIntegration, which sends check-ins for every named scheduleJob job (node-schedule 1.3+ and 2.x) with its cron string and tz as the monitor config. It replaces wrapping the module in Sentry.cron.instrumentNodeSchedule. Adding the integration is the opt-in. Jobs without a name and one-off Date jobs aren't monitored.

Sentry.init({
  dsn: '...',
  integrations: [Sentry.nodeScheduleIntegration({ excludeJobs: ['cleanup', /^debug-/] })],
});

schedule.scheduleJob('daily-report', { rule: '30 9 * * 1-5', tz: 'Europe/Vienna' }, sendReport);

Recurrence rules, rules with a start or end, and schedules Crons can't express, like every 10 seconds, aren't monitored. Jobs already wrapped by instrumentNodeSchedule are skipped.

Stacked on #25473.

@github-actions

github-actions Bot commented Oct 17, 2026 •

Copy link
Copy Markdown
Contributor

size-limit report 📦

Compared: 636d8a1 (PR test merge using develop at a3dae70)

Against: a3dae70 (develop) · base run #64482

✅ Baseline matches: this diff contains only this PR's changes.

Path Size % Change Change
@sentry/browser 30.39 kB - -
@sentry/browser - with treeshaking flags 28.54 kB - -
@sentry/browser - with treeshaking flags tracing without tracing 28.42 kB - -
@sentry/browser (incl. Tracing) 52.71 kB - -
@sentry/browser (incl. Tracing + Span Streaming) 52.72 kB - -
@sentry/browser (incl. Tracing, Profiling) 55.69 kB - -
@sentry/browser (incl. Tracing, Replay) 93.01 kB - -
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags 81.61 kB - -
@sentry/browser (incl. Tracing, Replay with Canvas) 97.76 kB - -
@sentry/browser (incl. Tracing, Replay, Feedback) 110.75 kB - -
@sentry/browser (incl. Feedback) 47.98 kB - -
@sentry/browser (incl. sendFeedback) 35.5 kB - -
@sentry/browser (incl. FeedbackAsync) 40.6 kB - -
@sentry/browser (incl. Metrics) 31.43 kB - -
@sentry/browser (incl. Logs) 31.72 kB - -
@sentry/browser (incl. Metrics & Logs) 32.44 kB - -
@sentry/react 32.28 kB - -
@sentry/react (incl. Tracing) 55.08 kB - -
@sentry/vue 38.66 kB - -
@sentry/vue (incl. Tracing) 55.73 kB - -
@sentry/svelte 30.42 kB - -
@sentry/remix (Remix 3 client bundle) 57.79 kB - -
CDN Bundle 32.18 kB - -
CDN Bundle (incl. Tracing) 53.23 kB - -
CDN Bundle (incl. Logs, Metrics) 34.46 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) 55.17 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) 75.87 kB - -
CDN Bundle (incl. Tracing, Replay) 91.45 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) 93.38 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) 97.55 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) 99.55 kB - -
CDN Bundle - uncompressed 94.64 kB - -
CDN Bundle (incl. Tracing) - uncompressed 157.6 kB - -
CDN Bundle (incl. Logs, Metrics) - uncompressed 101.11 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed 163.34 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed 232.68 kB - -
CDN Bundle (incl. Tracing, Replay) - uncompressed 279.29 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed 285.01 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed 293 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed 298.71 kB - -
@sentry/nextjs (client) 58.03 kB - -
@sentry/sveltekit (client) 53.23 kB - -
@sentry/core/server 44.24 kB - -
@sentry/core/browser 13.93 kB - -
@sentry/node 155.5 kB +0.09% +132 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection) 82.16 kB +0.1% +82 B 🔺
@sentry/node - without tracing 96.79 kB +0.13% +123 B 🔺
@sentry/node - without channel injection 135.86 kB +0.1% +128 B 🔺
@sentry/aws-serverless 104.99 kB +0.14% +141 B 🔺
@sentry/cloudflare (withSentry) - minified 197.94 kB - -
@sentry/cloudflare (withSentry) 491.97 kB - -
@sentry/nextjs/cloudflare (withSentry) - minified 218.48 kB - -

View base workflow run

wedamija and others added 7 commits October 19, 2026 17:48
Sends check-ins for every named node-cron task through the orchestrion
createTask channel, with the task's schedule and time zone as monitor
config when Sentry reads it the same way. Tasks without a name, and
tasks wrapped by Sentry.cron.instrumentNodeCron, are skipped.

Co-Authored-By: Claude <noreply@anthropic.com>
Prepares for other scheduler integrations; the helper also handles
schedulers that run on either day field (cron-parser, cron).

Co-Authored-By: Claude <noreply@anthropic.com>
The error event and the error check-in can arrive in either order.

Co-Authored-By: Claude <noreply@anthropic.com>
…-in modules

`bun run` can't inject channels into libraries. nodeCronIntegration is
opt-in, so it has no lazy channel-integration definition.

Co-Authored-By: Claude <noreply@anthropic.com>
Sends check-ins for every named job created with scheduleJob through the
orchestrion channel injection. Cron strings (with their tz) are sent as
the monitor config when Sentry reads them the same way; recurrence rules
check in without a config. Unnamed and one-off jobs are skipped.

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Claude <noreply@anthropic.com>
@wedamija
wedamija force-pushed the danf/node-cron-monitor-jobs branch from 2c2c600 to 905ed6b Compare October 20, 2026 00:51
@wedamija
wedamija force-pushed the danf/node-schedule-monitor-jobs branch from b9c729a to 231f7bc Compare October 20, 2026 00:51
wedamija and others added 8 commits October 20, 2026 10:45
…reads differently

node-cron 4.0 to 4.2 ship `dist/cjs` and `dist/esm` builds, which weren't instrumented. node-cron 3 keeps the values of a stepped field that are multiples of the step (`*/2` days run on 2, 4, ...), so those tasks now check in without a monitor config.

Also moves the channel subscription and job filtering into shared helpers for the other scheduler integrations.

Co-Authored-By: Claude <noreply@anthropic.com>
…t or end

A rule limited by `start` or `end` doesn't run outside that window, so sending its schedule would report missed check-ins. Also uses the shared job-creation helpers.

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Optional E2E tests

Some optional checks were not successful. They do not block the merge. 2 not successful, 50 successful. See the run.

Check Status
❌ CI: Optional E2E Tests / E2E gen-ai-libraries (latest) Test (optional) Failing after 31s Details
❌ CI: Optional E2E Tests / E2E nuxt-5 Test (optional) Failing after 2m Details
Successful checks
Check Status
✅ CI: Optional E2E Tests / E2E cloudflare-flue-send-to-sentry Test (optional) Successful in 2m Details
✅ CI: Optional E2E Tests / E2E nestjs-12 (latest) Test (optional) Successful in 42s Details
✅ CI: Optional E2E Tests / E2E debug-id-sourcemaps Test (optional) Successful in 33s Details
✅ CI: Optional E2E Tests / E2E cloudflare-pi-durable Test (optional) Successful in 33s Details
✅ CI: Optional E2E Tests / E2E astro-7 Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E gen-ai-libraries (cloudflare) Test (optional) Successful in 29s Details
✅ CI: Optional E2E Tests / E2E cloudflare-think Test (optional) Successful in 46s Details
✅ CI: Optional E2E Tests / E2E gen-ai-libraries Test (optional) Successful in 43s Details
✅ CI: Optional E2E Tests / E2E cloudflare-workers-send-to-sentry Test (optional) Successful in 2m Details
✅ CI: Optional E2E Tests / E2E nuxt-5-sourcemaps (client source maps kept) Test (optional) Successful in 23s Details
✅ CI: Optional E2E Tests / E2E deno (latest) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E nextjs-16 (vinext) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E cloudflare-pi-durable (latest) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E cloudflare-agent Test (optional) Successful in 23s Details
✅ CI: Optional E2E Tests / E2E node-openai-decisions Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E node-express-send-to-sentry Test (optional) Successful in 2m Details
✅ CI: Optional E2E Tests / E2E cloudflare-think (ai v6) Test (optional) Successful in 55s Details
✅ CI: Optional E2E Tests / E2E nextjs-orpc Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E node-eve Test (optional) Successful in 54s Details
✅ CI: Optional E2E Tests / E2E nextjs-15 (latest) Test (optional) Successful in 2m Details
✅ CI: Optional E2E Tests / E2E nextjs-15 (turbo) Test (optional) Successful in 2m Details
✅ CI: Optional E2E Tests / E2E node-fastify-6 Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E cloudflare-mastra Test (optional) Successful in 52s Details
✅ CI: Optional E2E Tests / E2E nextjs-16 (deno) Test (optional) Successful in 2m Details
✅ CI: Optional E2E Tests / E2E astro-7-static Test (optional) Successful in 48s Details
✅ CI: Optional E2E Tests / E2E node-express-send-to-sentry-static Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E nextjs-16 (cloudflare, latest) Test (optional) Successful in 2m Details
✅ CI: Optional E2E Tests / E2E node-eve (orchestrion) Test (optional) Successful in 52s Details
✅ CI: Optional E2E Tests / E2E node-express-mcp-v1 Test (optional) Successful in 22s Details
✅ CI: Optional E2E Tests / E2E nextjs-14 (latest) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E node-express-mcp-v2 Test (optional) Successful in 19s Details
✅ CI: Optional E2E Tests / E2E nextjs-16 (vinext, bun) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E nextjs-16-tunnel (cloudflare) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E node-mastra Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E node-pi-durable (latest) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E node-eve (latest) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E node-openai-decisions (latest) Test (optional) Successful in 17s Details
✅ CI: Optional E2E Tests / E2E node-fastify-6 (tracer provider) Test (optional) Successful in 23s Details
✅ CI: Optional E2E Tests / E2E node-pi-durable Test (optional) Successful in 30s Details
✅ CI: Optional E2E Tests / E2E node-mastra (latest) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E node-flue (latest) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E solidstart-2 Test (optional) Successful in 41s Details
✅ CI: Optional E2E Tests / E2E nuxt-5-sourcemaps Test (optional) Successful in 23s Details
✅ CI: Optional E2E Tests / E2E react-router-7-framework-instrumentation Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E node-flue Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E nuxt-5-sourcemaps (static / nuxt generate) Test (optional) Successful in 40s Details
✅ CI: Optional E2E Tests / E2E tanstackstart-react (latest) Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E tanstackstart-react-cloudflare Test (optional) Successful in 21s Details
✅ CI: Optional E2E Tests / E2E supabase-nextjs Test (optional) Successful in 1m Details
✅ CI: Optional E2E Tests / E2E tanstackstart-react-sourcemaps Test (optional) Successful in 21s Details

@wedamija
wedamija marked this pull request as ready for review October 22, 2026 00:24
@wedamija
wedamija requested review from a team as code owners October 22, 2026 00:24
@wedamija
wedamija requested review from JPeer264, isaacs, nicohrubec and s1gr1d and removed request for a team October 22, 2026 00:24
@linear-code

linear-code Bot commented Oct 25, 2026

Copy link
Copy Markdown

JS-187

…o wt-nodeschedule-fix

# Conflicts:
#	packages/server-utils/test/orchestrion/moduleInjectedTransform.test.ts
…uled

nodeScheduleIntegration kept sending the config from scheduleJob after
rescheduleJob or job.reschedule, so Sentry reverted the monitor and
reported false misses. Update the job's config when a reschedule succeeds.
…nds as 7

Each run of a monitored job gets its own trace, so runs no longer share one.

A weekday range ending on Sunday (`sat-sun`, `5-0`) is sent as `6-7`, which Sentry
accepts. Other reversed ranges get no monitor config, and node-cron 3 gets none for
ranges ending on Sunday since it reads them differently.

@JPeer264 JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. I have one comment which might be worth fixing.

Comment thread packages/node/src/cron/node-schedule.ts Resolved
…o wt-cron-review-ns

# Conflicts:
#	packages/server-utils/src/utils/cronMonitoring.ts
… before node-cron 4.6

node-cron 4.0-4.5 swaps reversed ranges, so `sat-sun` runs every day there. Only 4.6+ wraps it around to the weekend.
Hook Job#schedule instead of scheduleJob and reschedule, since both call it. Also test that instrumentNodeSchedule marks its callback as monitored.
…nitor-jobs

# Conflicts:
#	packages/server-utils/src/utils/cronMonitoring.ts
Base automatically changed from danf/node-cron-monitor-jobs to develop October 29, 2026 20:45
@wedamija
wedamija merged commit 9ea3abf into develop Oct 30, 2026
316 of 318 checks passed
@wedamija
wedamija deleted the danf/node-schedule-monitor-jobs branch October 30, 2026 16:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants