Python cron job या scheduled script fail होने पर alert पाएँ
एक Python script हर रात cron या Windows Task Scheduler से चलती है। जब वह exception raise करती है, तो traceback किसी log या ऐसे mailbox में जाता है जिसे कोई नहीं पढ़ता, और आपको तब पता चलता है जब data गायब होता है। Script में कुछ lines वह traceback इसकी जगह आपको भेज देती हैं, और एक schedule उन runs को पकड़ता है जो अटक जाते हैं या शुरू ही नहीं होते।
Python failure report करता है; scheduler उसे अपने तक रखता है
न पकड़ा गया exception Python को status 1 के साथ exit करवाता है (sys.exit और interpreter के main loop का Python documentation यह बताता है: 0 सफलता है, बाकी कुछ भी असामान्य समाप्ति)। तो scheduler को पता होता है। वह उसके साथ क्या करता है:
- cron exit status को देखता ही नहीं। वह job का output crontab के owner या
MAILTOको mail करता है, अगर machine पर काम करने वाला mail program हो; न हो तो cronie output को syslog में लिखता है। जो script file में redirect किए गए output के साथ fail होती है, वह कहीं कुछ नहीं भेजती। - Task Scheduler Last Run Result column में
0x1दिखाता है, और बस। "How to fix (0x1) error in task scheduler that runs a python script" (Microsoft Q&A, 2023) जैसे forum threads इसी से शुरू होते हैं कि किसी ने कई दिन बाद ध्यान दिया।
कुछ failures exceptions होती ही नहीं: ऐसा try/except जो log करके आगे बढ़ जाता है, ख़ाली list लौटाने वाली API, कोई नई row न पाने वाली query। Python 0 के साथ exit करता है और scheduler संतुष्ट रहता है। और जो run कभी शुरू नहीं हुआ (machine बंद, cron daemon बंद, crontab में ग़लत path), वह किसी तरह का status नहीं छोड़ता।
Script से report कीजिए
नीचे का code सिर्फ़ standard library (urllib) इस्तेमाल करता है, इसलिए यह किसी भी Python 3 और किसी भी virtual environment में काम करता है। यह शुरुआत में TaskBeacon को ping करता है; exception होने पर error और traceback की आख़िरी 20 lines के साथ /fail भेजता है, फिर exception को दोबारा raise करता है ताकि exit status 1 बना रहे; अंत में row count भेजता है।
# --- TaskBeacon: top of the script (standard library only) ---
import json, traceback, urllib.request
TB = "https://taskbeacon.io/ping/your-job-id"
def tb_ping(path="", data=None):
body = json.dumps(data).encode() if data else None
req = urllib.request.Request(TB + path, data=body, headers={"Content-Type": "application/json"})
try:
urllib.request.urlopen(req, timeout=10)
except Exception as e:
print("TaskBeacon ping failed:", e)
tb_ping("/start")
try:
# --- your code here ---
df = [1, 2, 3] # example data: replace with your own (e.g. pandas.read_csv)
except Exception as e:
# the error and the last 20 lines of the traceback go with the failure
tb_ping("/fail", {"error": f"{type(e).__name__}: {e}"[:200],
"log": "\n".join(traceback.format_exc().splitlines()[-20:])[-4000:]})
raise
# --- TaskBeacon: end of the script ---
tb_ping("", {"rows": len(df)})App में, आपके job का Code tab आपको यही code देता है, your-job-id की जगह job के अपने address के साथ, और जिन हिस्सों की ज़रूरत नहीं उनका tick आप हटा सकते हैं।
उदाहरण वाली line की जगह अपना code लिखिए और नतीजा df में रखिए (pandas DataFrame या rows की list), या कोई और संख्या भेजिए। Fail हुआ ping एक message print करता है और script आगे चलती रहती है: monitoring कभी job को नहीं तोड़ती।
Cron job के लिए crontab line जैसी है वैसी रहती है:
0 6 * * * /home/me/jobs/venv/bin/python /home/me/jobs/sales.py >> /home/me/jobs/sales.log 2>&1
अगर आप script को छूना नहीं चाहते, तो cron line इसकी जगह exit code report करती है (traceback या row count के बिना)।
आपको क्या मिलता है
- Failed (विफल) exception और traceback के अंत के साथ, उदाहरण के लिए
KeyError: 'amount', आपके email, Slack या Teams में। - Missed (छूटा) जब तय समय और grace तक कोई ping नहीं आया: machine बंद, cron नहीं चल रहा, crontab में typo।
- Late (देर से) जब script शुरू हुई और सामान्य से बहुत ज़्यादा समय ले रही है, जैसे बिना timeout की कोई request हमेशा इंतज़ार करती रहे।
- Odd data (असामान्य डेटा) जब rows 40% से ज़्यादा गिर जाएँ या 0 हों।
TaskBeacon के बिना
Linux पर एक mail program install और configure कीजिए, MAILTO set कीजिए, और script को सिर्फ़ errors पर print करने दीजिए, ताकि cron ठीक तभी आपको mail करे। Windows पर top level पर एक try/except जोड़िए जो दोबारा raise करने से पहले smtplib से email भेजे। दोनों exceptions को cover करते हैं। कोई भी उस run को cover नहीं करता जो कभी शुरू नहीं हुआ; उसके लिए आपको कुछ ऐसा चाहिए जो job से signal की उम्मीद करे — एक heartbeat check, या एक दूसरा job जो हर सुबह पहले वाले का output जाँचे।
क्या आपने Claude या ChatGPT को TaskBeacon से जोड़ा है? उससे पूछिए "कल रात क्या fail हुआ, और क्यों?" और वह आपके jobs के आधार पर जवाब देगा। यह कैसे काम करता है।
संबंधित
डॉक्स में: Python · Linux cron · Statuses।
- Scheduled scripts के लिए heartbeat monitoring (dead man's switch)Job हर run पर check in करता है; चुप्पी ही alert है।
- जानें कि scheduled R script कब fail होती हैtaskscheduleR और cron log लिखते हैं; कुछ गलत होने तक कोई उसे नहीं पढ़ता।
- कोई job 0 rows या आम से बहुत कम rows load करे तो alert पाएँExit code 0 यह नहीं बताता कि कितनी rows आईं।
TaskBeacon से शुरुआत मुफ़्त है; अभी हर feature सबके लिए खुला है और credit card की ज़रूरत नहीं। एक job बनाइए, code paste कीजिए, और पहला ping job के page पर दिख जाएगा।
मुफ़्त शुरू करें लाइव demo देखेंस्रोत
- Python docs: Py_RunMain returns 1 for an unhandled exception (Python 3.15 docs, बिना तारीख; 9 नवंबर 2026 को जाँचा गया)
- Python docs: sys.exit (zero सफलता है, non-zero असामान्य समाप्ति) (Python 3.15 docs, बिना तारीख; 9 नवंबर 2026 को जाँचा गया)
- man7.org: crontab(5), cronie (MAILTO) (page 2012 का, upstream cronie 2026 से मेल खाता है)
- man7.org: cron(8), cronie (output mail किया जाता है; sendmail के बिना यह syslog में जाता है) (page 2013 का, upstream cronie 2026 से मेल खाता है)
- Microsoft Q&A: Python script चलाने वाले Task Scheduler में (0x1) error कैसे ठीक करें (28 अगस्त 2023, पुराना: माँग का संकेत)
इस page को इसके स्रोतों से 9 नवंबर 2026 को मिलाकर जाँचा गया। दूसरे products के menu और limits बदलते रहते हैं; अगर यहाँ कुछ अब मेल नहीं खाता, तो support@taskbeacon.io पर लिखें।