إشعارات تحقيق الربح لا تعمل

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

المشكلة

لا تعمل إشعارات تحقيق الربح، وبالتالي لا يتم إرسال رسائل إلكترونية إلى المستخدمين المشتركين.

رسالة الخطأ

لن يتم إرسال الرسائل الإلكترونية المتعلقة بالإشعار بشأن تحقيق الربح إلى المستخدمين المشتركين. لن تظهر أي رسائل خطأ.

لمحة عن إشعارات أحداث تحقيق الربح

يتيح لك تحقيق الربح استخدام إشعارات الأحداث التي تتيح لك ما يلي:

  1. إرسال إشعارات إلى جميع المطوّرين بشأن أحداث مثل المنتجات الجديدة أو الإصدارات الجديدة من البنود والشروط أو خطط الأسعار الجديدة
  2. إرسال إشعارات إلى مطوّرين محدّدين بشأن أحداث معيّنة، مثل نشر مستند فوترة أو بلوغ نسبة مئوية من عدد المعاملات المستهدَف (في حال شراء خطة معدّل إشعارات قابل للتعديل)
  3. إرسال إشعار إلى موفّر واجهة برمجة التطبيقات بشأن الأحداث المتعلّقة بالمطوّرين، مثل عندما يسجّل مطوّر للحصول على حساب أو عندما يشترك مطوّر في خطة أسعار
  4. يمكنك الاطّلاع على مزيد من التفاصيل حول أنواع الإشعارات وكيفية إعدادها هنا.

المتطلبات الأساسية

يُرجى التأكّد من استيفاء المتطلبات الأساسية التالية:

  1. قبول خطة الأسعار

    بالنسبة إلى إشعارات تحقيق الربح التالية، تحقَّق مما إذا كان المطوّرون قد وافقوا على خطة الأسعار المقابلة :

    1. خطة أسعار جديدة
    2. خطة الأسعار المعدَّلة
    3. خطة الأسعار المنتهية الصلاحية
    4. خطة الأسعار المجدَّدة
    5. تم تجاوز الحد المخصص لمعدل الإرسال
    6. خطة الأسعار المجانية بميزات محدودة المستنفدة

      إذا لم يقبل المطوّر خطة الأسعار، لن يتم إرسال هذه الإشعارات إلى هذا المطوّر تحديدًا.

  2. يجب تشغيل Job Scheduler للإشعار المحدّد

    توفّر ميزة تحقيق الربح نظام جدولة مهام ومجموعة من المهام التي تمّت جدولتها مسبقًا لتنفيذها في أوقات محدّدة مسبقًا. يجب تشغيل أداة جدولة المهام لإشعار معيّن. وفي حال عدم تشغيلها، لن يتم إرسال الإشعارات.

    1. اتّبِع التعليمات الواردة في المستند التالي لمعرفة ما إذا كانت المهمة المجدوَلة لإشعار معيّن قد تم تنفيذها:

      جدولة مهام تحقيق الربح

      ملاحظة: يمكنك دائمًا تغيير الجدول الزمني استنادًا إلى حالة الاستخدام.

    2. إذا تم تشغيل المهمة المجدوَلة للإشعار المحدّد ولم تتلقَّ الإشعارات بعد، انتقِل إلى قسم الأسباب المحتملة لتحديد المشكلة وحلّها.
    3. إذا لم يكن الأمر كذلك، انتظِر إلى أن يتم تشغيل المهمة المجدوَلة للإشعار المحدّد.

الأسباب المحتملة

تشمل بعض الأسباب المحتملة لهذه المشكلة ما يلي:

السبب الوصف تعليمات تحديد المشاكل وحلّها التي تنطبق على
إعدادات SMTP غير صحيحة إعدادات SMTP التي تم تقديمها غير صحيحة. مستخدمو Edge Private Cloud

جدول مهام الإشعارات

 لم تبدأ مهمة الإشعار. مستخدمو Edge Public Cloud وPrivate Cloud

السبب 1: إعدادات SMTP غير صحيحة

التشخيص

  1. راجِع ملف /opt/apigee/edge-mint-management-server/conf/apix-mint.properties وتأكَّد من ضبط خصائص SMTP التالية بشكل صحيح. 
    mint.notification.javaMail.properties={"mail.smtp.host": "smtp.gmail.com",
"mail.smtp.port": "465", "mail.smtp.starttls.enable": "true", "mail.smtp.auth": "true", "mail.smtp.username": "blah@gmail.com", "mail.smtp.password": "blah" }
  2. تأكَّد من صحة إعدادات خادم SMTP والمستخدم. إذا كانت هذه الإعدادات غير صحيحة أو لم يتم ضبطها، انتقِل إلى الخطوة 3. إذا كان هذا صحيحًا، انتقِل إلى الخطوة رقم 4.
  3. عدِّل إعدادات خادم SMTP والمستخدم بشكل صحيح باتّباع التعليمات الواردة في المستند التالي:

    /private-cloud/latest/configuring-edge-smtp-server

  4. أعِد التحقّق مرة أخرى لمعرفة ما إذا كانت إشعارات تحقيق الربح تعمل الآن. إذا لم يكن الأمر كذلك، يُرجى الانتقال إلى الخطوة 5.
  5. إذا كانت إعدادات SMTP صحيحة، نفِّذ طلب عرض الإشعارات المُرسَلة لواجهة برمجة التطبيقات للاطّلاع على حالة الإشعار المُرسَل.
    1. تعرض واجهة برمجة التطبيقات هذه ملف JSON يتضمّن جميع الإشعارات التي تم إرسالها وحالة كل منها.
    2. في ما يلي نموذج JSON : 
      {
        "hasMoreItems" : false,
        "notifications" : [ {
        "fromAlias" : "No Reply",
        "fromEmail" : "****@apigee.com",
        "id" : "4e2d0d9a-69a4-4430-957d-02fa2a3cb581",
        "notificationType" : "EMAIL",
        "orgId" : "myorg",
        "rawMessage" : "...",
        "retryCount" : 0,
        "retryStatuses" : [ {
             "responseCode" : 0,
             "responseMessage" : "{\"Headers\":null,\"Content : \":null,\"StatusCode\":\"0\"}",
             "retriedAt" : 1518605291092,
             "retryAttempt" : 0
        } ],
        "source" : "MailTo: [****@blah.com], Org: [myorg], EventType: [UPDATE_DEVELOPER]",
        "status" : "FAILED",
        "subject" : "Notification of developer changing company details",
        "templateId" : "814315c8-d8ca-4b3e-90bb-a8366600e625",
        "templateName" : "DEFAULT_UPDATE_DEVELOPER_TEMPLATE",
        "templateParametersJSON" : "{\"developer.legalName\":\"\",\"developer.name\":\"John Smith\"}",
        "toAlias" : "***@blah.com",
        "toEmail" : "***@blah.com",
        "unsubscribeURL" : "..."
}

      إذا تحقّقت من ملف JSON، ستظهر الحالة "FAILED" للإشعار المحدّد أعلاه Update Developer.

  6. قد يكون السبب في ذلك هو عدم إمكانية الوصول إلى خادم SMTP والمنفذ من "خادم الإدارة". استخدِم أمر telnet للتحقّق مما إذا كان بإمكانك الاتصال بخادم SMTP المحدّد على المنفذ المحدّد. 
    telnet <SMTP-server-IP-address> <SMTP-Port#>

    إذا ظهرت لك رسالة الخطأ "انتهت مهلة الاتصال" أو "تم رفض الاتصال" في ناتج telnet، انتقِل إلى "الحلّ".

الدقة

  1. تواصل مع مشرف الشبكة وتأكَّد من أنّ خادم SMTP يمكنه قبول الاتصالات من الأجهزة الأخرى، وأنّ المنفذ المحدّد مفتوح أيضًا للعالم الخارجي لإجراء عمليات التواصل.
  2. إذا استمرت المشكلة، انتقِل إلى "جمع معلومات التشخيص" باستخدام

السبب 2: جدول مهام الإشعارات

لم تبدأ مهمة الإشعار.

التشخيص

  1. نفِّذ طلب البيانات التالي من واجهة برمجة التطبيقات لعرض جميع مهام تحقيق الربح المجدوَلة حاليًا.

    /monetize/apis/get/triggers

  2. تحقَّق ممّا إذا كان شرط الإشعار متوفّرًا ومفعَّلاً للإشعار الذي لا يعمل. إذا لم يكن موجودًا، انتقِل إلى الخطوة رقم 3 لإنشاء شرط الإشعار وتخطَّ بقية الخطوات.
    1. إذا كان هذا الخيار متاحًا، تحقَّق مما إذا كان مفعّلاً. إذا لم يكن كذلك، شغِّل Update a notification condition and action API لتعديل شرط الإشعار.

      أو

    2. استخدِم واجهة المستخدم لتعديل شرط الإشعار باتّباع العملية الموضّحة في المستند أدناه:

      واجهة مستخدم الأحداث

    3. نفِّذ طلب Create a notification condition and action API لإنشاء شرط الإشعار المناسب والإجراء المقابل.
      1. بعد إنشاء شرط الإشعار، نفِّذ طلب List notification conditions and actions API للتحقّق من إنشاء شرط الإشعار.
      2. يمكنك أيضًا إعادة معالجة الإشعار باستخدام Reprocess a notification API.
    4. لا تنطبق هذه الخطوة إلا على مستخدمي Private Cloud. إذا كان شرط الإشعار متوفّرًا من الخطوة رقم 1 ولم تصلك رسائل الإشعارات الإلكترونية بعد، راجِع سجلّ خادم الإدارة /opt/apigee/var/log/edge-management-server/logs/system.log لمعرفة ما إذا تم تفعيل شرط الإشعار. 
      grep "Executing Mint Scheduler" /opt/apigee/var/log/edge-management-server/logs/system.log | grep  -o  "Executing Mint Scheduler : \[.*\]" | grep -v "for org : \[null\]" |sort | uniq -c
    5. إذا تم استيفاء شرط الإشعار، وكنت لا تزال لا تتلقّى الإشعارات، انتقِل إلى Must Gather Diagnostic Information مع المعلومات والنتائج التي تم تسجيلها من الخطوات أعلاه.

الحلّ

  1. إعادة معالجة الإشعار باستخدام Reprocess a notification API

يجب جمع معلومات التشخيص

إذا استمرت المشكلة حتى بعد اتّباع التعليمات الواردة أعلاه، يُرجى التواصل مع فريق دعم Apigee Edge وتقديم معلومات التشخيص التالية.

على مستخدمي السحابة العامة والخاصة تقديم المعلومات التالية:

  1. اسم المؤسسة
  2. اسم البيئة
  3. شرط الإشعار بتحقيق الربح الذي لم ينجح
  4. تفاصيل حول الأقسام التي تمّت تجربتها في "دليل التشغيل" وأي إحصاءات أخرى ستساعدنا في تسريع حلّ هذه المشكلة

بالإضافة إلى المعلومات المذكورة أعلاه، على مستخدمي Private Cloud تقديم المعلومات التالية أيضًا:

  • سجلّ خادم الإدارة

    /opt/apigee/var/log/edge-management-server/logs/system.log