راهنمای عملیاتی پردازشگر ارسال اعلان

هدف و محدوده

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

پردازشگر اعلان یک محیط اجرا سمت سرور است. نصب، ثبت سرویس ویندوز، تنظیم رشته اتصال، اطلاعات محرمانه سرویس‌دهنده و استقرار محیط عملیاتی در سطح مشتری انجام نمی‌شود و در این راهنما دستور شروع/توقف یا تغییر تنظیمات سرور منتشر نشده است.

پیش‌نیاز دسترسی

  • دسترسی مجاز به «داشبورد اطلاع‌رسانی»؛
  • امکان مشاهده «صندوق ارسال» و جزئیات پیام در محدوده مجاز؛
  • برای بررسی سرویس‌دهنده، دسترسی متناسب به صفحه سرویس‌دهنده‌ها یا «تست سامانه‌ها»؛
  • زمان تقریبی رخداد و کانال مورد استفاده، مانند پیامک، ایمیل یا اعلان داخلی.

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

بررسی وضعیت و سلامت

در «داشبورد اطلاع‌رسانی» ابتدا این موارد را ببینید:

  1. آخرین ارتباط ثبت شده است؟ اگر هیچ آخرین ارتباط ثبت نشده باشد، در حال اجرا بودن سرویس سرور به‌تنهایی سلامت پردازش صف را ثابت نمی‌کند.
  2. پردازشگر سالم است؟ داشبورد آخرین ارتباط تازه و نتیجه آخر را مبنا قرار می‌دهد.
  3. در صف: تعداد گیرنده‌هایی که هنوز به مرحله نهایی نرسیده‌اند.
  4. آماده پردازش: تعداد مواردی که زمان پردازششان رسیده است.
  5. در انتظار تلاش مجدد: ارسال‌هایی که پس از خطای موقت برای تلاش مجدد زمان‌بندی شده‌اند.
  6. متوقف پس از چند خطا (خطای نهایی صف): مواردی که تلاش مجدد خودکار برای آن‌ها پایان یافته و نیازمند بررسی‌اند.
  7. سن قدیمی‌ترین صف: اگر این مقدار پیوسته زیاد می‌شود، مسیر پردازش یا سرویس‌دهنده را بررسی کنید.

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

شروع و توقف امن

این پردازشگر سمت سرور است و کنترل شروع/توقف آن جزو عملیات عادی مشتری نیست.

اگر داشبورد نشان می‌دهد آخرین ارتباط پردازشگر ندارد یا ناسالم است:

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

برای مشکل یک ارائه‌دهنده یا یک پیام، راه‌اندازی مجدد پردازشگر اولین اقدام نیست.

بررسی گزارش‌های رخداد

برای بررسی عمومی از گزارش رخداد خام سرور استفاده نکنید. این شواهد کافی است:

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

رمز عبور، توکن امنیتی، کلید رابط برنامه‌نویسی، رشته اتصال، آدرس/شماره کامل گیرنده، شناسه داخلی، مسیر سرور یا ردیابی خطا ارسال نشود.

خطاهای رایج و رفع اولیه

آخرین ارتباط ثبت نشده است: این حالت می‌تواند به اجرا نشدن پردازشگر، غیرفعال بودن محیط اجرا یا مشکل پیکربندی سرور مربوط باشد. در سطح مشتری تنظیم سرور را تغییر ندهید و شواهد را به پشتیبانی بدهید.

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

پردازشگر سالم است ولی یک کانال ارسال نمی‌کند: وضعیت همان ارائه‌دهنده را بررسی کنید. در صورت داشتن مجوز از «تست سامانه‌ها» استفاده کنید و سپس صف خروجی را بررسی کنید.

موارد تلاش مجدد زیاد شده‌اند: علت اصلی ارائه‌دهنده/شبکه را قبل از تلاش مجدد دستی برطرف کنید. تلاش مجدد خودکار از وضعیت ثبت‌شده سامانه پیروی می‌کند.

خطای نهایی صف افزایش یافته است: مورد را به‌عنوان ارسال ناموفق قطعی بررسی کنید؛ ارسال دستی دوباره بدون بررسی علت می‌تواند تکراری ایجاد کند.

سن صف زیاد می‌شود ولی سررسید کم است: ممکن است پیام‌ها برای زمان آینده زمان‌بندی شده باشند. زمان‌بندی و وضعیت همان پیام‌ها را در صف خروجی بررسی کنید.

تعمیر و بازیابی

در سطح مشتری بازیابی به این ترتیب است:

  1. وضعیت پردازشگر و شاخص‌های صف را ثبت کنید.
  2. اگر مشکل فقط یک ارائه‌دهنده است، تنظیم/اعتبار آن ارائه‌دهنده را از محیط کاربری مجاز بررسی کنید؛ اطلاعات محرمانه قبلی را استخراج یا نمایش ندهید.
  3. یک پیام نمونه را در صف خروجی بررسی کنید تا وضعیت گیرنده و خطای قابل مشاهده مشخص شود.
  4. پس از رفع علت، اجازه دهید تلاش مجدد خودکار مسیر طبیعی را طی کند.
  5. تلاش مجدد دستی فقط وقتی انجام شود که علت خطا شناخته و برطرف شده باشد.

تغییر مستقیم پایگاه داده، حذف صف، تغییر وضعیت رکورد، بازنشانی شمارنده تلاش مجدد یا ارسال پیاپی برای «امتحان» مجاز نیست.

به‌روزرسانی

پردازشگر اعلان همراه نسخه رسمی سمت سرور به‌روزرسانی می‌شود و برنامه کاربر بروزرسانی مستقل ندارد. مشتری نباید دودویی یا سرویس ویندوز را دستی جایگزین کند.

بعد از نسخه رسمی، کنترل مجاز مشتری شامل داشبورد سلامت، آخرین ارتباط، شاخص‌های صف و یک آزمون کنترل‌شده ارائه‌دهنده در صورت نیاز است.

بازگشت امن

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

برای بازیابی هرگز صف/آخرین ارتباط جدول را پاک یا داده محیط عملیاتی را حذف/ایجاد مجدد نکنید.

زمان ارجاع به پشتیبانی سطح بالاتر

در این موارد ارجاع کنید:

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

سؤالات متداول

آیا در حال اجرا بودن سرویس ویندوز یعنی پردازشگر سالم است؟

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

آیا برای پیام تلاش مجدد شده باید دوباره «ارسال» بزنم؟

معمولاً خیر. ابتدا علت تلاش مجدد را بررسی کنید. ارسال جدید ممکن است پیام تکراری بسازد.

آیا پردازشگر برای هر شعبه جدا نصب می‌شود؟

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

راهنماهای مرتبط

«داشبورد اعلان»، «پردازش صف ارسال»، «پیام ارسال نمی‌شود»، «صندوق ارسال» و «سرویس‌دهنده‌ها» مکمل این راهنمای عملیاتی هستند.