Python
सिर्फ़ standard library (urllib)। किसी भी Python 3 के साथ काम करता है। Error पर यह error और traceback की आखिरी 20 lines भेजता है; Failed alert और job पेज उन्हें दिखाते हैं। उदाहरण वाली line (df = ...) paste करते ही चलती है: उसकी जगह अपना code लिखें।
Code
यह वह code है जो Code टैब बनाता है (start, errors और rows पर निशान लगाकर)। App में इसमें पहले से आपके job का अपना पता होता है।
# --- 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)})यह कैसे काम करता है
Script शुरू होने पर code /start ping करता है, ठीक से खत्म होने पर row count के साथ सादा address, और fail होने पर /fail, error और traceback की आखिरी 20 lines के साथ।
किसी हिस्से को छोड़ने के लिए Code टैब पर विकल्पों का निशान हटाएँ; कोई output न भेजकर सिर्फ़ error या exit code भेजने के लिए Send output lines (output लाइनें भेजें) का निशान हटाएँ। देखें क्या रिपोर्ट किया जा सकता है।
Python script को schedule पर चलाएँ
Windows पर Command Prompt से एक task बनाएँ। उस Python का पूरा path दें जिसमें आपने packages install किए हैं (where python उसे दिखाता है), या अपने virtual environment का:
schtasks /Create /TN "Sales report" /SC DAILY /ST 06:00 /TR "C:\jobs\venv\Scripts\python.exe C:\jobs\sales.py"
Linux या Mac पर एक crontab line (crontab -e):
0 6 * * * /home/me/jobs/venv/bin/python /home/me/jobs/sales.py
अगर आप task को हाथ से शुरू करते समय output देखना चाहते हैं, तो pythonw.exe नहीं, python.exe इस्तेमाल करें।
Exit code काफ़ी क्यों नहीं है
कोई uncaught exception होने पर Python code 1 के साथ बंद होता है, इसलिए scheduler इस तरह की failure देख लेता है। चुपचाप होने वाली failures वह नहीं देखता: खाली query result, ऐसा API जिसने बिना data के जवाब दिया, ऐसा try/except जो log लिखकर आगे बढ़ जाता है, या ऐसा run जो कभी शुरू ही नहीं हुआ क्योंकि machine बंद थी।
ऊपर का code error message और traceback की आख़िरी 20 lines के साथ /fail भेजता है और फिर exception को दोबारा raise करता है, ताकि exit code सही बना रहे; जो run कभी शुरू नहीं होता वह “Missed” (छूटा) दिखता है।
Row count भेजें
आख़िरी line len(df) भेजती है। df की जगह अपना result रखें (pandas DataFrame, rows की list, या वह संख्या जो आपके insert ने लौटाई)। और संख्याएँ उसी JSON में जाती हैं:
tb_ping("", {"rows": len(df), "total": float(df["amount"].sum())})
Code केवल standard library (urllib) इस्तेमाल करता है, इसलिए यह requests के बिना भी काम करता है।
आम समस्याएँ
- ModuleNotFoundError केवल scheduler में। Task कोई दूसरा Python चलाता है। Task को venv के
python.exeपर point करें। - Relative paths. ये task के Start in folder के हिसाब से होते हैं, script के folder के हिसाब से नहीं। Paths
pathlib.Path(__file__).parentसे बनाएँ। - SSL: CERTIFICATE_VERIFY_FAILED. HTTPS की जाँच करने वाला company proxy अपना certificate इस्तेमाल करता है; IT से वह certificate माँगें, या script को उस Python से चलाएँ जो आपकी IT team देती है।
- Network drives. जो task आपके logged out रहते चलता है, उसे mapped drive letters नहीं दिखते; UNC paths इस्तेमाल करें।
उपयोग के उदाहरण: Python cron job या scheduled script fail होने पर alert पाएँ · SPSS Statistics production job fail हो तो alert पाएँ · Scheduled AI agent या LLM job को monitor करें · AI job ख़ाली या बहुत छोटा जवाब लौटाए तो alert पाएँ · कोई job 0 rows या आम से बहुत कम rows load करे तो alert पाएँ · जाँचें कि रोज़ की table या file ताज़ा है · जाँचें कि कल रात का backup मौजूद है और ख़ाली नहीं है। और सवाल: FAQ.