Skip to content

docs(nestjs): Document SentryCron monitor config from @Cron - #19782

Draft
wedamija wants to merge 8 commits into
masterfrom
danf/nestjs-cron-config
Draft

wedamija wants to merge 8 commits into
masterfrom
danf/nestjs-cron-config

Conversation

@wedamija

@wedamija wedamija commented Oct 2, 2026 •

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Documents that @SentryCron now sends the schedule and time zone of @Cron on the same method, so check-ins create the monitor. Covers the server time zone default, which schedules send no config, and the fromCronDecorator: false opt-out.

SDK change: getsentry/sentry-javascript#25013. Merge after it ships; the page marks it as available since 11.5.0, which assumes it lands in the next minor.

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Oct 29, 2026 12:36am UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 29, 2026 12:36am UTC

Request Review

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude <noreply@anthropic.com>
@wedamija
wedamija requested a review from a team October 2, 2026 22:29
@wedamija
wedamija marked this pull request as ready for review October 2, 2026 22:29
@cursor

cursor Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks errors on the changed guide pages, loads of those pages, and site error volume. An issue escalates when those page errors appear or site errors rise.

Services: sentry-docs.

Mention @change-monitor in a comment to update the plan.

Plan

What changed

The NestJS Cron decorator docs now describe auto monitor config from @Cron. Readers who omit a schedule see that check-ins send the Cron schedule and time zone. The sentry-docs service must deploy before this section is live. The text is marked available since 11.5.0.

Risk

Wrong MDX can fail both pages that share this include. A broken code block can fail the shared code tab on those pages. Readers can then miss how to create a monitor from @Cron.

Intended effect

This change is a docs edit. No queryable signal shows the new section is live. absent is the normal telemetry state. Do not treat a zero counter as failure.

Regression watch

This include ships on the NestJS Cron decorator page and the NestJS crons setup page. A render fault would show as errors or a drop in NestJS guide loads.

Signal Baseline Window Rule Source
NestJS guide page errors 0 events. Error rate 0% against 123 guide loads 2026-10-01T22:30:00Z to 2026-10-02T22:30:00Z Hold at 0 Sentry project docs. Production errors whose transaction or url contains nestjs
Docs production errors 0-22 events per hour. 154 events in 24h 2026-10-01T22:30:00Z to 2026-10-02T22:30:00Z Hold in the 0-22 per hour band Sentry project docs. environment:production error count
NestJS guide pageload and navigation 123 spans. p95 24.6s 2026-10-01T22:30:00Z to 2026-10-02T22:30:00Z Volume should stay near 123 per 24h. p95 should stay near 24.6s Sentry project docs. pageload or navigation spans whose url contains javascript/guides/nestjs

The 24h p95 may include slow navigations. Escalate when NestJS guide errors leave zero or site errors leave the hourly band.

Not observable

Whether the new heading is visible on the published pages. Traffic on the sentry-cron-decorator page alone had no traces in this window. Whether the JavaScript SDK ships the 11.5.0 Cron behavior.

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

@coolguyzone coolguyzone left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM! Please address or resolve the review bot comment before merging.

@wedamija
wedamija marked this pull request as draft October 23, 2026 21:12
@linear-code

linear-code Bot commented Oct 25, 2026

Copy link
Copy Markdown

JS-3999

isaacs added a commit to getsentry/sentry-javascript that referenced this pull request Oct 29, 2026
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.

`@SentryCron` now sends the schedule and time zone of the method's
`@Cron()` decorator with its check-ins, so Sentry creates the monitor on
the first run. It's on by default; pass `fromCronDecorator: false` to
send no config. A config with its own `schedule` is used as is. Monitors
created this way are billed, and their schedule and time zone are
overwritten from `@Cron()` on each check-in.

```ts
@Cron('0 30 9 * * 1-5', { timeZone: 'Europe/Vienna' })
@SentryCron('daily-report', { checkinMargin: 2 })
async dailyReport() {}
```

Without a `timeZone`, the server's local time zone is sent. Schedules
Sentry would read differently from `@nestjs/schedule` (sub-minute,
numeric months, some day-field combinations, fixed UTC offsets) check in
without a config.

Docs: getsentry/sentry-docs#19782

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: isaacs <i@izs.me>

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — e6bcfa4f Deployed Oct 29, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants