Skip to content

docs(crons): Add arq setup for Python - #20056

Draft
wedamija wants to merge 2 commits into
masterfrom
danf/python-arq-crons-docs
Draft

wedamija wants to merge 2 commits into
masterfrom
danf/python-arq-crons-docs

Conversation

@wedamija

@wedamija wedamija commented Oct 17, 2026 •

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Adds an arq section to the Python Crons setup page: turning on monitor_cron_jobs, how the slug is picked, and which cron jobs are monitored.

SDK PR: getsentry/sentry-python#8051

Merge after the SDK release that includes it.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

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

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

vercel Bot commented Oct 17, 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 20, 2026 10:30pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 20, 2026 10:30pm UTC

Request Review

@wedamija wedamija mentioned this pull request Oct 17, 2026
1 of 3 tasks
@github-actions github-actions Bot added the Priority: Needs Triage The PR description is missing valid priority information label Oct 17, 2026
wedamija added a commit to getsentry/sentry-python that referenced this pull request Oct 20, 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.

This adds `monitor_cron_jobs` to `ArqIntegration`, matching Celery's
`monitor_beat_tasks`. When it's on, each `cron(...)` job sends check-ins
with its schedule in the worker's timezone, so Sentry creates the
monitor on the first run. The slug is the job name without arq's `cron:`
prefix. It's off by default.

```python
sentry_sdk.init(
    integrations=[ArqIntegration(monitor_cron_jobs=True, exclude_cron_jobs=["cleanup"])],
)
```

Jobs check in without a config when Crons can't express the schedule: a
`second` other than 0, both `day` and `weekday` set, or a UTC offset
that isn't a whole number of hours. Before arq 0.25, the config is only
sent when the system timezone is UTC.

Docs: getsentry/sentry-docs#20056
Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions github-actions Bot added Priority: Normal Docs review has no urgent deadline and removed Priority: Needs Triage The PR description is missing valid priority information labels Oct 20, 2026

<Alert>

Crons monitoring for arq ships in the next release of `sentry-sdk`.

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.

Suggested change
Crons monitoring for arq ships in the next release of `sentry-sdk`.
Crons monitoring for arq ships in version `2.73.0` of `sentry-sdk`.

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — b27ffea6 Deployed Oct 20, 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