اعمل بوت تيليجرام يبعتلك تنبيهات السيرفر بـ Python في 30 سطر

import requests
import shutil

TOKEN = "123456789:AAH...xyz"   # من BotFather
CHAT_ID = "987654321"           # من getUpdates

def send_alert(text):
    url = f"https://api.telegram.org/bot{TOKEN}/sendMessage"
    payload = {"chat_id": CHAT_ID, "text": text}
    r = requests.post(url, data=payload, timeout=10)
    r.raise_for_status()
    return r.json()

def check_disk(path="/", threshold=85):
    total, used, free = shutil.disk_usage(path)
    percent = used / total * 100
    if percent >= threshold:
        gb_free = free / (1024 ** 3)
        send_alert(
            f"تحذير: القرص على {path} وصل {percent:.0f}% "
            f"(المتبقي {gb_free:.1f} جيجا)"
        )

if __name__ == "__main__":
    check_disk()

جرّبه يدويًا الأول علشان تتأكد إنه شغّال. نزّل قيمة threshold مؤقتًا لـ 1 وشغّل السكربت، المفروض توصلك رسالة على طول. لو وصلت، رجّعها لـ 85 وانت مطمئن.

خلّيه يشتغل لوحده كل ربع ساعة

السكربت دلوقتي بيتشغّل مرة وبس. علشان يفحص باستمرار، استخدم cron على لينكس. افتح crontab -e وضيف السطر ده:

كده انت عملت أوتوميشن كامل: السكربت بيفحص، ولو في مشكلة بيبعت، ولو كله تمام بيفضل ساكت. ده بالظبط السلوك اللي عايزه — تنبيه عند الحاجة بس.

الأرقام والتكلفة

Bot API مجاني بالكامل. حد الإرسال الرسمي حوالي 30 رسالة في الثانية، و20 رسالة في الدقيقة للمجموعة الواحدة — أكتر بكتير من احتياج أي تنبيهات سيرفر عادية. زمن وصول الرسالة عمليًا أقل من ثانية. قارن ده بـ SMS عبر مزود زي Twilio بتكلفة تقريبية 0.0075 دولار للرسالة؛ لو بتبعت 200 تنبيه في الشهر، ده فرق بين صفر و18 دولار سنويًا على حاجة واحدة صغيرة. في فريق صغير على VPS واحد، التنبيه الفوري ده بيقلّل وقت اكتشاف العطل من ساعتين لأقل من دقيقة.

trade-offs لازم تنتبه لها

• الاعتماد على تيليجرام: لو تيليجرام محجوب في بلدك أو عند سيرفرك، التنبيه مش هيوصل. بتكسب البساطة والمجانية، بتخسر ضمان الوصول في كل الشبكات.
• أمان الـ token: أي حد يوصل للـ token يقدر يبعت باسم البوت. متحطهوش في الكود مباشرة في مشروع حقيقي؛ حطّه في متغير بيئة os.environ["TG_TOKEN"].
• مفيش تصعيد: الرسالة بتوصل وخلاص. لو انت نايم، محدّش هيصحّيك. ده تنبيه، مش نظام on-call.

متى لا تستخدم هذه الطريقة

لو عندك نظام إنتاجي حرج بيتطلب ضمان وصول التنبيه وتصعيد تلقائي لو محدش رد (acknowledgement)، الطريقة دي مش كافية. وقتها روح لأدوات زي PagerDuty أو Opsgenie اللي بتعمل اتصال صوتي وتدوير على المناوبين. كمان لو عندك مئات الخدمات، استخدم Prometheus مع Alertmanager بدل سكربتات متفرقة. الفرضية هنا إن عندك سيرفر أو اتنين وفريق صغير، والهدف تنبيه سريع رخيص مش SLA رسمي.

الخطوة التالية

افتح BotFather دلوقتي واعمل بوت، وشغّل سكربت الـ check_disk بـ threshold=1 علشان تتأكد إن الرسالة بتوصل. أول ما توصلك، ضيف فحص تاني بسيط: استخدام الـ RAM عبر قراءة /proc/meminfo، وابعت لنفسك تنبيه لو عدّى 90%. كل فحص جديد مجرد دالة بتنادي send_alert.

المصادر

• توثيق Telegram Bot API الرسمي: https://core.telegram.org/bots/api — تفاصيل sendMessage وgetUpdates وحدود الإرسال.
• دليل BotFather الرسمي: https://core.telegram.org/bots#how-do-i-create-a-bot — خطوات إنشاء البوت والحصول على الـ token.
• توثيق Python shutil.disk_usage: https://docs.python.org/3/library/shutil.html#shutil.disk_usage.
• توثيق مكتبة requests: https://requests.readthedocs.io.
• توثيق crontab على لينكس: https://man7.org/linux/man-pages/man5/crontab.5.html.