مخاطبان، پیامک، ارجاع و سقف پیامک

قانون‌ها تعیین می‌کنند چه چیزی هشدار است؛ این برگه توضیح می‌دهد هشدار به چه کسی، کی و از چه راهی برسد. ServerMug دو کانال دارد: پیامک (از طریق کاوه‌نگار) و webhook (یک درخواست JSON به هر نشانی که بدهید). اعلان با ایمیل، تلگرام، بله یا تماس صوتی فعلاً وجود ندارد؛ اگر لازم دارید، webhook را به سامانهٔ خودتان وصل کنید.

تعریف مخاطب

1. به «اطلاع‌رسانی» بروید و «+ مخاطب جدید» را بزنید.
2. فیلدها را پر کنید:
   • نام: مثلاً «مسئول شبکه» یا «کشیک شب».
   • کانال: «پیامک» یا «Webhook».
   • شمارهٔ موبایل (مثل 09121234567) یا آدرس webhook (با http:// یا https://).
   • حداقل شدت: «هشدار و بحرانی» یا «فقط بحرانی».
   • سطح ارجاع: «سطح ۱ — فوری» یا «سطح ۲ — اگر تأیید نشد».
   • گروه سرورها: «همهٔ سرورها» یا یک گروه خاص.
   • شروع و پایان ساعت سکوت: اختیاری.
3. «ذخیره» را بزنید، سپس در ردیف مخاطب «ارسال آزمایشی» را بزنید. نتیجه بالای صفحه و در «گزارش ارسال‌ها» نمایش داده می‌شود.

با کلید «فعال» در هر ردیف، مخاطب را موقتاً خاموش می‌کنید بدون اینکه حذفش کنید؛ مثلاً وقتی همکاری مرخصی است.

ساعت سکوت

ساعت سکوت به وقت تهران است، مثلاً ۲۳:۰۰ تا ۰۷:۳۰. در این بازه هشدارهای عادی برای آن مخاطب پیامک نمی‌شوند، ولی هشدار بحرانی همیشه ارسال می‌شود. پس پر شدن ۹۰ درصدی دیسک تا صبح صبر می‌کند، ولی قطعی سرور یا دست خوردن فایل طعمه شما را بیدار می‌کند. برای غیرفعال کردن ساعت سکوت هر دو فیلد را خالی کنید.

ارجاع به سطح ۲

مخاطبان سطح ۱ همان لحظه خبر می‌گیرند. اگر یک هشدار بحرانی تا مدت تعیین‌شده (پیش‌فرض ۱۵ دقیقه) باز بماند و کسی آن را «تأیید» نکند، یک بار به مخاطبان سطح ۲ (مثلاً مدیر فنی) پیامک می‌شود. پیامک ارجاع با عبارت «ارجاع · بحرانی · هنوز تأیید نشده» شروع می‌شود. هشدارهای غیربحرانی ارجاع نمی‌شوند.

چیدمان رایج در یک تیم کوچک:

مدت ارجاع در «تنظیمات» ← «سازمان» با فیلد «ارجاع به سطح ۲ پس از (دقیقه)» عوض می‌شود.

متن پیامک

پیامک کوتاه و قابل اقدام است: شدت، نام سرور، عنوان هشدار، توضیح، زمان شمسی و لینک صفحهٔ سرور. نمونه:

ServerMug · بحرانی
SRV-FS-01: پر بودن دیسک D: 97٪
آستانهٔ بحرانی: بیشتر از 95
07/17، 02:14
https://app.servermug.ir/#/s/42

خط تاریخ، ماه و روز شمسی و ساعت تهران است. در هشدار حملهٔ حدس رمز، عنوان تعداد ورود ناموفق و آی‌پی مبدأ را دارد؛ مثلاً «۳۸ ورود ناموفق از 222.218.17.124».

وقتی مشکل برطرف شود، به مخاطبان سطح ۱ که دربارهٔ آن هشدار پیامک گرفته بودند یک پیامک «برطرف شد» می‌رود. اگر این را نمی‌خواهید، در «تنظیمات» ← «سازمان» گزینهٔ «وقتی هشدار برطرف شد هم خبر بده» را خاموش کنید.

سقف پیامک

یک طوفان هشدار (مثلاً قطعی شبکه‌ای که ۴۰ سرور را هم‌زمان آفلاین نشان می‌دهد) نباید صدها پیامک بفرستد. برای همین هر سازمان یک سقف پیامک ۲۴ ساعتهٔ لغزان دارد؛ لغزان یعنی همیشه ۲۴ ساعت گذشته شمرده می‌شود، نه روز تقویمی.

• سقف پیامک در ۲۴ ساعت: حداکثر پیامک؛ می‌توانید آن را از سقف پلن پایین‌تر بیاورید، ولی بالاتر نه.
• رزرو برای هشدار بحرانی: چند پیامک آخر سقف فقط برای هشدار بحرانی نگه داشته می‌شود تا هشدارهای عادی جای پیامک «سرور از دسترس خارج شد» را نگیرند.
• وقتی سقف پر شود، یک پیامک «سقف پیامک ۲۴ ساعته پر شد» ارسال می‌شود تا سکوت بعدی با «همه‌چیز خوب است» اشتباه گرفته نشود. پیامک‌های بعدی ارسال نمی‌شوند و در گزارش با وضعیت «نگه داشته شد» ثبت می‌شوند؛ هشدارها همچنان در داشبورد ساخته می‌شوند.

کارت «سقف پیامک ۲۴ ساعت اخیر» در صفحهٔ «اطلاع‌رسانی» مصرف فعلی و سهم رزرو را نشان می‌دهد. webhook مشمول سقف پیامک نیست.

Webhook

برای هر اطلاع‌رسانی یک درخواست POST با Content-Type: application/json به نشانی مخاطب فرستاده می‌شود. اگر پاسخ در ۱۰ ثانیه نرسد یا کد ۲xx نباشد، در گزارش «ناموفق» ثبت می‌شود. بدنه این شکل را دارد:

{
  "event": "alert",
  "alert": {
    "id": "1834",
    "severity": "critical",
    "title": "پر بودن دیسک D: 97٪",
    "detail": "...",
    "status": "open",
    "opened_at": "2026-10-09T02:14:05.000Z"
  },
  "server": { "id": "42", "name": "SRV-FS-01" },
  "text": "متن کامل پیامک"
}

مقدار event یکی از alert، escalation یا resolved است. ساده‌ترین استفاده این است که فیلد text را به ربات پیام‌رسان یا سامانهٔ تیکت خودتان بدهید.

چه وقت پیامک نمی‌رود

اگر انتظار پیامک داشتید و نیامد، اول «گزارش ارسال‌ها» را نگاه کنید: وضعیت «ارسال شد»، «ناموفق» (با متن خطا)، «نگه داشته شد» یا «آزمایشی (ارسال نشد)». اگر ردیفی نیست، علت در قانون یا مخاطب است؛ قانون‌های هشدار را ببینید.