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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

תיאור הבעיה

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

הודעת שגיאה

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

מידע על התראות לגבי אירועי מונטיזציה

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

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

דרישות מוקדמות

צריך לוודא שהחשבון עומד בדרישות המוקדמות הבאות:

  1. אישור תוכנית התעריפים

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

    1. תוכנית מחירים חדשה
    2. תוכנית תעריפים מתוקנת
    3. תוכנית תעריפים שפג תוקפה
    4. תוכנית תעריפים מתחדשת
    5. חרגת מהגבלת הקצב של יצירת בקשות
    6. תוכנית התעריפים של Freemium שאזלה

      אם המפתח לא אישר את תוכנית התמחור והתשלומים, ההתראות האלה לא יופעלו לגבי המפתח הספציפי הזה.

  2. צריך להפעיל את מתזמן המשימות עבור ההתראה הספציפית

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

    1. תוכלו להשתמש בהוראות שבמסמך הבא כדי לבדוק אם המשימה המתוזמנת לגבי התראה ספציפית הופעלה:

      תזמון משימות מונטיזציה

      הערה: תמיד אפשר לשנות את לוח הזמנים בהתאם לתרחיש לדוגמה שלכם.

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

סיבות אפשריות

אלה כמה מהסיבות האפשריות לבעיה הזו:

סיבה התיאור הוראות לפתרון בעיות הרלוונטיות
תצורת SMTP שגויה תצורת ה-SMTP שסופקה אינה נכונה. משתמשי ענן פרטי של Edge

לוח זמנים של משימות להתראות

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

סיבה 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 הצגת התראות שנשלחו כדי לבדוק את הסטטוס של ההודעה שנשלחה.
    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. אם הבעיה נמשכת, עוברים אל הדף 'חובה לאסוף פרטי אבחון' עם

סיבה 2: תזמון של משימת התראה

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

אבחון

  1. כדי להציג את כל משימות המונטיזציה המתוזמנות הנוכחיות, צריך להריץ את הקריאה הבאה ל-API.

    /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. אפשר לעבד מחדש את ההתראה גם באמצעות עיבוד מחדש של ממשק 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. עיבוד מחדש של ההתראה באמצעות עיבוד מחדש של ה-API להתראות

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

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

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

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

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

  • יומן של שרת הניהול

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