התראות המונטיזציה לא פועלות

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

תיאור הבעיה

התראות על מונטיזציה לא פועלות ולכן לא נשלחים אימיילים למשתמשים שנרשמו לקבלת התראות.

הודעת השגיאה

לא יישלחו אימיילים עם התראות על מונטיזציה לאנשים שנרשמו לערוץ. לא יופיעו הודעות שגיאה.

מידע על התראות על אירועים שקשורים למונטיזציה

במונטיזציה יש תמיכה בהתראות על אירועים, שמאפשרות לכם:

1. הודעה לכל המפתחים על אירועים כמו מוצרים חדשים, גרסאות חדשות של התנאים וההגבלות או תוכניות תמחור חדשות.
2. התראה למפתחים ספציפיים על אירועים כמו פרסום מסמך חיוב או הגעה לאחוז מסוים ממספר העסקאות שהוגדר כיעד (אם הם רכשו תוכנית עם שיעור התראות שניתן להתאמה).
3. הודעה לספק API על אירועים שקשורים למפתחים, למשל כשמפתח נרשם לחשבון או כשמפתח נרשם לתוכנית תמחור.
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 נכונות, מריצים את קריאת ה-API View notifications sent כדי לראות את הסטטוס של ההתראה שנשלחה.
   1. ה-API הזה מחזיר 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, רואים שהסטטוס של ההתראה הספציפית 'עדכון למפתחים' שצוינה למעלה הוא'נכשל'.

6. יכול להיות שהבעיה נובעת מכך שאי אפשר להגיע לשרת SMTP ולפורט משרת הניהול. משתמשים בפקודה telnet כדי לבדוק אם אפשר להתחבר לשרת ה-SMTP שצוין ביציאה שצוינה.

   telnet <SMTP-server-IP-address> <SMTP-Port#>

   אם מקבלים את השגיאה 'הסתיים פרק הזמן שהוקצב להתחברות' או 'החיבור נדחה' בפלט של telnet, צריך להמשיך לפתרון.

רזולוציה

1. צריך לעבוד עם מנהל הרשת ולוודא ששרת ה-SMTP יכול לקבל חיבורים ממכונות אחרות, ושהיציאה הספציפית פתוחה לתקשורת עם העולם החיצוני.
2. אם הבעיה נמשכת, צריך להמשיך אל Must Gather Diagnostic Information עם

סיבה 2: לוח הזמנים של משימת ההתראה

המשימה של ההתראה לא התחילה.

אבחון

1. מריצים את הקריאה הבאה ל-API כדי לראות את כל משימות המונטיזציה שמתוזמנות כרגע.

   /monetize/apis/get/triggers

2. בודקים אם תנאי ההתראה קיים ומופעל עבור ההתראה שלא פועלת. אם הוא לא מופיע, עוברים לשלב 3 כדי ליצור את תנאי ההתראה ומדלגים על שאר השלבים.
   1. אם הוא קיים, צריך לבדוק אם הערך שלו הוא true. אם לא, מריצים את ה-API לעדכון תנאי פעולה והתראה כדי לעדכן את תנאי ההתראה.

      או

   2. כדי לעדכן את תנאי ההתראה באמצעות ממשק המשתמש, פועלים לפי התהליך שמתואר במסמך הבא:

      ממשק המשתמש של אירועים

   3. מריצים את הקריאה ל-API Create a notification condition and action API כדי ליצור את תנאי ההתראה המתאים ואת הפעולה התואמת.
      1. אחרי שיוצרים את תנאי ההתראה, מריצים את קריאת ה-API של List notification conditions and actions כדי לוודא שתנאי ההתראה נוצר.
      2. אפשר גם לעבד מחדש את ההתראה באמצעות Reprocess a notification API.
   4. השלב הזה רלוונטי רק למשתמשי ענן פרטי. אם תנאי ההתראה מופיע משלב 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. אם התנאי להצגת ההתראה מופעל ואתם עדיין לא מקבלים את ההתראות, צריך להמשיך אל איסוף מידע לצורך אבחון ולצרף את המידע והפלט מהשלבים שלמעלה.

פתרון

1. לעבד מחדש את ההתראה באמצעות Reprocess a notification API

איסוף פרטי אבחון

אם הבעיה נמשכת גם אחרי שמבצעים את ההוראות שלמעלה, צריך לפנות לתמיכה של Apigee Edge ולספק את פרטי האבחון הבאים.

משתמשים בענן ציבורי ופרטי צריכים לספק את הפרטים הבאים:

1. שם הארגון
2. שם הסביבה
3. תנאי ההתראה על מונטיזציה שלא פעל
4. פרטים על החלקים בחוברת ההדרכה הזו שניסית, ותובנות אחרות שיעזרו לנו לפתור את הבעיה במהירות.

בנוסף למידע שלמעלה, משתמשי Private Cloud צריכים לספק גם את הפרטים הבאים:

• יומן של שרת הניהול
  
  /opt/apigee/var/log/edge-management-server/logs/system.log