ساعت سه و ده دقیقه بامداد فروشگاه خطای 502 می‌دهد. هشدار داون شدن سایت، چون فقط به ایمیل رفته، تا نه صبح نخوانده می‌ماند. ناظر خرابی را همان اول دیده بود. پیامک و ربات بله این فاصله را کوتاه می‌کنند. شرطش این است که چند شکست پیاپی پیش از هر پیام تأیید شود تا لرزش‌های شبکه کسی را بیدار نکنند.

دقیقهاتفاقچه کسی خبردار می‌شوداگر این تنظیم نبود
یک ساعت قبللرزش ده‌ثانیه‌ای شبکههیچ‌کس؛ مانیتور فقط Pending شدبا Retries صفر، دو پیام در هر کانال
دقیقه ۰سایت از دسترس می‌رودهنوز هیچ‌کسبا بازه پنج‌دقیقه‌ای، کشف تا پنج دقیقه دیرتر
تا دقیقه ۲مانیتور بله پس از دو تلاش مجدد Down می‌شودگروه بله تیمفقط ایمیلی که صبح باز می‌شود
تا دقیقه ۶مانیتور پیامک پس از پنج تلاش Down می‌شودنفر کشیک، با پیامکپیامک حتی برای قطعی سه‌دقیقه‌ای
دقیقه ۴۰سایت برمی‌گرددهر دو کانال، با پیام Upتنظیمی ندارد؛ بازگشت همیشه اعلام می‌شود
ساعت چهارری‌استارت طولانی داخل بازه Maintenanceهیچ‌کسدو پیام برای کار خودتان

💡 کانال هر نفر و زمان رسیدن پیام

هشدار شبانه پیامی است که چند دقیقه بعد از خرابی، یک آدم مشخص را بیدار کند.
✅ بله برای گروه تیم، پیامک برای نفر کشیک و چند دقیقه دیرتر.
✅ پیش از هر کانال تازه، Retries را از صفر بالاتر ببرید.

هر هشدار قولی است که اگر سایت افتاد، کسی بیدار شود. در آن شب، هر دقیقه به یک تنظیم بسته بود. سرور بدون Uptime Kuma هم با اسکریپتی چندخطی به همین قول می‌رسد.

هشدار داون شدن سایت

ایمیل برای هشدار شبانه کافی نیست

ساعت سه بامداد کسی صندوق ایمیل را باز نمی‌کند. ایمیل برای گزارش صبح خوب است. هشدار داون شدن سایت اما کانال دیگری لازم دارد، کانالی که صاحب گوشی برایش صدا گذاشته است. پیامک برای یک نفر، پیام بله برای گروه.

سروری که خودش افتاده، از خاموشی خودش پیامک نمی‌فرستد. پس پیش از هر کانال، جای ناظر را با جانمایی و نصب uptime kuma بیرون از سرور اصلی تعیین کنید.

پیامک برای نفر کشیک، بله برای گروه

پیامک روی شبکه تلفن همراه می‌آید و اینترنت گوشی نمی‌خواهد، ولی از اعتبار پنل کم می‌کند. پیام‌رسان بله اینترنت می‌خواهد و در عوض چند نفر پیام را می‌بینند. ایمیل برای سابقه بماند.

⚠️ هر کانال تازه، یک رمز تازه در ناظر

فرم Uptime Kuma توکن بله را پنهان نشان می‌دهد، اما کلید پنل پیامک در «Additional Headers» کانال Webhook آشکار است. هر دو به‌صورت JSON در دیتابیس ناظر می‌مانند. رمز ورود Uptime Kuma را محکم نگه دارید و نسخه پشتیبان دیتابیس را مثل فایل رمز نگه‌داری کنید.

💡 پیامک دیرتر از بله، با مانیتور دوم

هر مانیتور در Uptime Kuma همه کانال‌هایش را هم‌زمان خبر می‌کند و پله‌بندی داخلی ندارد. راهش دو مانیتور روی یک نشانی است. مانیتور بله: بازه و فاصله تلاش مجدد ۳۰ ثانیه و Retries برابر ۲. مانیتور پیامک: بازه و فاصله ۶۰ ثانیه و Retries برابر ۵. فقط قطعی طولانی نفر کشیک را بیدار می‌کند.

وب‌هوک Uptime Kuma را به وب‌سرویس پیامک وصل کنید

نسخه 2.5.9 برای دو درگاه ایرانی، SMS.IR و Amoot SMS، کانال آماده دارد. برای پنل‌های دیگر، کانال Webhook درخواست POST مستندات پنل را لحظه خرابی می‌فرستد. پنل قالبی، مثل SMS.IR در این کانال، اول قالب تأییدشده می‌خواهد.

فیلدهای کانال Webhook، مطابق کد این کانال در مخزن Uptime Kuma:

  • فیلد Post URL: نشانی ارسال پیامک پنل.
  • فیلد HTTP Method: روش GET فقط پارامترهای نام‌ثابت مثل msg را در نشانی می‌گذارد؛ پس POST لازم است.
  • فیلد Request Body: حالت آماده JSON کلیدهای ثابتی دارد؛ Custom Body بدنه را از قالب شما می‌سازد.
  • کلید Additional Headers: پس از روشن کردنش، هدرها را به‌شکل JSON می‌گیرد.

موتور قالب Liquid بدنه سفارشی را می‌سازد و کلیدهای هشدار داون شدن سایت را به نام‌هایی می‌نویسد که پنل انتظار دارد.

🔸 بدنه سفارشی برای یک پنل پیامک فرضی

قالب زیر در Custom Body و هدرها در Additional Headers می‌نشینند. نام کلیدها فرضی است و از مستندات پنل JSON‌پذیر شما می‌آید. هدر Content-Type اجباری است؛ بدون آن، متن به‌صورت فرم urlencoded می‌رود. متغیر status ایموجی دارد که ممکن است پیامک را خراب یا رد کند؛ شرط Liquid وضعیت را متن ساده می‌کند. گیومه انگلیسی در نام مانیتور، JSON را می‌شکند.

Custom Body:
{"to": "PHONE_NUMBER", "text": "{{ name }} {% if heartbeatJSON['status'] == 0 %}DOWN{% else %}UP{% endif %} {{ heartbeatJSON['localDateTime'] }}"}

Additional Headers:
{"Content-Type": "application/json", "X-API-Key": "SMS_API_KEY"}

دکمه Test پیامی با مقدارهای ساختگی می‌فرستد. گاهی Test روی ناظر خطا می‌دهد و همان درخواست از لپ‌تاپ جواب می‌گیرد. یک علت ممکن، IP ناظر است که هنوز در وایت‌لیست IP پنل پیامک ثبت نشده.

وب‌هوک Uptime Kuma را به وب‌سرویس پیامک وصل کنید

پیام هشدار در بله با API ربات

بله برای ربات‌ها API دارد و هشدار داون شدن سایت با یک فراخوان متد sendMessage روی tapi.bale.ai به گروه می‌رسد. Uptime Kuma از نسخه 2.1.0 کانال آماده Bale دارد. برای هشدار ربات جدا بسازید؛ اگر برنامه‌ای مدام getUpdates ربات را بخواند، Auto Get پیامی پیدا نمی‌کند.

کانال Bale داخل Uptime Kuma

  1. توکن را از BotFather بله بگیرید؛ فرم، نشانی ble.ir/BotFather را کنار Bot Token نشان می‌دهد.
  2. به ربات پیام بدهید؛ در گروه کشیک، پیامی بفرستید که ربات را صدا بزند.
  3. دکمه Auto Get که پس از وارد کردن توکن ظاهر می‌شود، شناسه چت را از getUpdates می‌خواند؛ شناسه گفت‌وگوی مستقیم، گروه یا کانال پذیرفته است.
  4. با Test امتحان کنید؛ ربات فقط فرستنده است و کدی روی سرور اجرا نمی‌کند.

اسکریپت چندخطی برای سروری که Uptime Kuma ندارد

برای یک یا دو سایت، cron و curl کافی‌اند، روی سروری غیر از سرور سایت. توکن و شناسه چت در فایلی جدا با دسترسی 600 می‌مانند، نه در خود اسکریپت:

sudo install -m 600 -o root -g root /dev/null /etc/site-check.env
# BALE_TOKEN="..." و CHAT_ID="..." را با ویرایشگر در این فایل بنویسید

برای شناسه چت، به ربات پیام بدهید و این را اجرا کنید؛ عدد id داخل بخش chat همان CHAT_ID است:

sudo sh -c '. /etc/site-check.env; printf "url = \"https://tapi.bale.ai/bot%s/getUpdates\"\n" "$BALE_TOKEN" | curl -sS -K -'
#!/bin/sh
. /etc/site-check.env
URL="https://example.com/"
F=/var/tmp/site-check.fails
N=$(cat "$F" 2>/dev/null || echo 0)

send() {
  printf 'url = "https://tapi.bale.ai/bot%s/sendMessage"\n' "$BALE_TOKEN" |
    curl -fsS -m 10 -K - --data-urlencode "chat_id=$CHAT_ID" --data-urlencode "text=$1" |
    grep -q '"ok": *true' || echo "$(date) send failed: $1" | tee -a /var/log/site-check.log >&2
}

[ "$1" = test ] && { send "پیام آزمایشی هشدار"; exit; }

if curl -fsL -o /dev/null -m 10 "$URL"; then
  [ "$N" -ge 3 ] && send "سایت برگشت: $URL"
  echo 0 > "$F"
else
  N=$((N + 1))
  echo "$N" > "$F"
  [ "$N" -eq 3 ] && send "سایت پس از سه بررسی پیاپی پاسخ نمی‌دهد: $URL"
fi

اسکریپت را با مالک root و دسترسی 700 نصب کنید و یک بار پیام آزمایشی بفرستید. بعد با sudo crontab -e خط آخر را به crontab کاربر root بدهید:

sudo install -m 700 -o root -g root site-check.sh /usr/local/bin/site-check.sh
sudo /usr/local/bin/site-check.sh test
* * * * * /usr/local/bin/site-check.sh

فرمان test بی‌خروجی، با رسیدن پیام در بله، یعنی مسیر سالم است. توکن یا شناسه اشتباه، خطا را در /var/log/site-check.log می‌نویسد. طبق راهنمای curl، -K - تنظیم‌ها را از ورودی استاندارد می‌خواند و توکن در فهرست پردازه‌ها نمی‌آید. -f کد 400 به بالا را خطا می‌گیرد و -L تغییر مسیر 3xx را دنبال می‌کند. مستندات API بله نتیجه را در فیلد ok برمی‌گرداند. اجرا با گیرنده ساختگی، پیام شکست سوم و خطای توکن را درست نشان داد؛ سرور واقعی بله آزموده نشد.

چند شکست پشت سر هم یعنی خرابی واقعی؟

چند شکست پشت سر هم یعنی خرابی واقعی؟

در Uptime Kuma جواب را عدد Retries می‌دهد. با Retries برابر ۲، سومین بررسی ناموفق پیاپی خرابی را قطعی می‌کند و تازه آن وقت پیام می‌رود. شکست‌های قبلی مانیتور را فقط به حالت Pending می‌برند و Pending پیامی نمی‌فرستد.

حالت Pending؛ شکستی که هنوز خبر نمی‌شود

بنابر فایل monitor.js مخزن Uptime Kuma، گذار Up به Pending و Pending به Up بی‌صداست. Pending یا Up به Down پیام خرابی می‌فرستد و Down به Up پیام بازگشت. لرزشی که پیش از پایان تلاش‌های مجدد برطرف شود، ردی نمی‌گذارد. فاصله تلاش مجدد هم فقط در Pending به کار می‌رود.

پیش‌فرض Retries در فرم مانیتور تازه نسخه 2.5.9 صفر است. با پیش‌فرض صفر، لرزش ده‌ثانیه‌ای ساعت سه بامداد هم هشدار داون شدن سایت می‌سازد. چند شب بعد، پیامک سوم واقعی است. نفر کشیک آن را بی‌جواب می‌گذارد و قصه چوپان دروغگو با گرگ واقعی تمام می‌شود.

💡 بازه Maintenance برای ری‌استارت‌های برنامه‌ریزی‌شده

با «Schedule Maintenance» برای به‌روزرسانی شبانه بازه بسازید. داخل بازه پیامی نمی‌رود و گذار Maintenance به Up هم بی‌صداست؛ اما سایتی که بعد از بازه هنوز پایین است، پیام خرابی می‌دهد. یادآور تکرار خرابی را هم فقط روی مانیتور بله بگذارید.

«دیشب چهار پیامک برای دو لرزش ده‌ثانیه‌ای گرفتم. صبح دیدم سایت اصلاً نیفتاده بود.» کسی که این را می‌گوید، به پیامک پنجم اعتماد نمی‌کند. تنظیم‌هایش باید پیش از شب بعد عوض شود.

آیا Uptime Kuma کانال آماده بله دارد؟

بله، از نسخه 2.1.0، با توکن ربات و شناسه چت. در نسخه‌های قدیمی‌تر، Webhook یا اسکریپت curl جایگزین است.

نه. SMS.IR و Amoot SMS کانال آماده دارند. پنل دیگر با Webhook کار می‌کند اگر پیامک را با یک درخواست POST بفرستد. پنلی که اول توکن جدا می‌گیرد یا GET با پارامترهای خودش می‌خواهد، جور نیست.

به ربات در گروه پیامی بدهید که صدایش بزند، بعد Auto Get فرم Uptime Kuma را بزنید یا خروجی getUpdates را بخوانید.

نه؛ گذار Down به Up همیشه اعلام می‌شود. برای کار برنامه‌ریزی‌شده، بازه Maintenance پیام‌ها را حذف می‌کند.

پنل قالبی فقط متن قالب تأییدشده را می‌فرستد. قالب را در پنل تأیید کنید و از Uptime Kuma فقط مقدار متغیرها را بفرستید.

به‌صورت JSON در دیتابیس Uptime Kuma. هر کس وارد ناظر شود آن را می‌بیند و نسخه پشتیبان دیتابیس هم آن را دارد.

اسکریپت برای یک یا دو سایت کافی است ولی تاریخچه و صفحه وضعیت ندارد؛ برای چند سرویس، Uptime Kuma ساده‌تر است.

جمع‌بندی؛ هشدار داون شدن سایت و کسی که ساعت سه بیدار می‌شود شب خرابی با ناظری شروع می‌شود که با سرور اصلی خاموش نشود. بعد نوبت کانال‌هایی است که صدا دارند. بله با کانال آماده به گروه تیم خبر می‌دهد. پیامک، از کانال آماده یا Webhook و چند دقیقه دیرتر، فقط نفر کشیک را بیدار می‌کند. تأیید پیش از اعلان هم به همان اندازه مهم است: Retries بالاتر از صفر و بازه Maintenance برای ری‌استارت‌های خودتان. بدون این تأیید، کانال‌ها بعد از چند شب بی‌اثر می‌شوند، چون کسی دیگر پیامشان را نمی‌خواند. مسیر را هم یک بار با پیام آزمایشی امتحان کنید. هشداری که هرگز آزموده نشده، شب خرابی هم ممکن است نرسد.

🚀 نصب داکری و ورود دومرحله‌ای ناظر

توکن بله و کلید پیامک هر دو در همین ناظر می‌مانند. کانتینرش را با داکر بالا بیاورید و حساب مدیرش را با رمز دوم قفل کنید.

تنظیم فعلی شما از لحظه خرابی تا بیدار شدن نفر کشیک چند دقیقه طول می‌کشد؟

منابع

وب داده
وب داده

جدید ترین مطالب آموزشی و کاربردی را در اینجا بخوانید !
ما با بهره‌گیری از دانش روز و تجربه متخصصان حوزه فناوری، مجموعه‌ای از آموزش‌های کاربردی و مقالات تخصصی را گردآوری کرده‌ایم که هر یک، پاسخی دقیق به پرسش‌های شماست. ؛ از مفاهیم پایه تا پیچیده‌ترین تکنیک‌های حرفه‌ای. اینجا، دانش با زبانی ساده اما عمیق در اختیار شما قرار می‌گیرد.

مقاله‌ها: 314
پاسخی بگذارید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *