การแจ้งเตือนการสร้างรายได้ไม่ทำงาน

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X ข้อมูล

ลักษณะปัญหา

การแจ้งเตือนการสร้างรายได้ไม่ทำงาน ทำให้ระบบไม่ส่งอีเมลให้กับผู้ใช้ที่สมัครรับข้อมูล

ข้อความแสดงข้อผิดพลาด

ระบบจะไม่ส่งอีเมลเกี่ยวกับการแจ้งเตือนการสร้างรายได้ไปยังผู้ที่สมัครรับข้อมูล ระบบจะไม่สังเกตข้อความแสดงข้อผิดพลาด

เกี่ยวกับการแจ้งเตือนกิจกรรมการสร้างรายได้

การสร้างรายได้สนับสนุนการแจ้งเตือนกิจกรรมที่ช่วยให้คุณทำสิ่งต่อไปนี้ได้

  1. แจ้งเตือนนักพัฒนาแอปทุกรายเกี่ยวกับกิจกรรมต่างๆ เช่น ผลิตภัณฑ์ใหม่ ข้อกำหนดและเงื่อนไขเวอร์ชันใหม่ หรือแพ็กเกจราคาใหม่
  2. แจ้งเตือนนักพัฒนาแอปบางรายเกี่ยวกับเหตุการณ์ต่างๆ เช่น มีการเผยแพร่เอกสารการเรียกเก็บเงินหรือเมื่อมีธุรกรรมถึงเปอร์เซ็นต์ที่ตั้งเป้าหมายไว้ (หากพวกเขาซื้อแพ็กเกจอัตราการแจ้งเตือนแบบปรับได้)
  3. แจ้งผู้ให้บริการ API เกี่ยวกับเหตุการณ์ที่เกี่ยวข้องกับนักพัฒนาซอฟต์แวร์ เช่น เมื่อนักพัฒนาซอฟต์แวร์ลงทะเบียนบัญชี หรือเมื่อนักพัฒนาซอฟต์แวร์ลงชื่อสมัครใช้แพ็กเกจราคา
  4. ดูรายละเอียดเพิ่มเติมเกี่ยวกับประเภทของการแจ้งเตือนในการแจ้งเตือน และวิธีตั้งค่าการแจ้งเตือนได้ที่นี่

ข้อกำหนดเบื้องต้น

ตรวจสอบว่าได้ดำเนินการตามข้อกําหนดเบื้องต้นต่อไปนี้แล้ว

  1. การยอมรับแพ็กเกจราคา

    สำหรับการแจ้งเตือนเกี่ยวกับการสร้างรายได้ต่อไปนี้ ให้ตรวจสอบว่านักพัฒนาซอฟต์แวร์ยอมรับแพ็กเกจราคาที่เกี่ยวข้องแล้วหรือไม่

    1. แพ็กเกจราคาใหม่
    2. แผนอัตราค่าบริการฉบับแก้ไข
    3. แพ็กเกจอัตราหมดอายุ
    4. แพ็กเกจราคาต่ออายุ
    5. เกินขีดจำกัดของอัตรา
    6. แพ็กเกจอัตรา Freemium ที่หมดแล้ว

      หากนักพัฒนาแอปไม่ยอมรับแพ็กเกจราคา จะไม่มีการเรียกให้แสดงการแจ้งเตือนเหล่านี้สำหรับนักพัฒนาซอฟต์แวร์รายนั้น

  2. ควรเรียกใช้เครื่องจัดตารางเวลางานสำหรับการแจ้งเตือนที่เฉพาะเจาะจง

    การสร้างรายได้มีเครื่องจัดตารางเวลางานและชุดงานที่กำหนดไว้ล่วงหน้าในเวลาที่กำหนดไว้ล่วงหน้า ต้องเรียกใช้เครื่องจัดตารางเวลางานเพื่อรับการแจ้งเตือนที่เฉพาะเจาะจง หากไม่ทำงาน การแจ้งเตือนจะไม่ถูกเรียกใช้

    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 ดูการแจ้งเตือนที่ส่งเพื่อดูสถานะของการแจ้งเตือนที่ส่ง
    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. หากมี ให้ตรวจสอบว่าเปิดใช้เป็นจริงหรือไม่ หากไม่เห็น ให้เรียกใช้อัปเดตเงื่อนไขการแจ้งเตือนและ API การดำเนินการเพื่ออัปเดตเงื่อนไขการแจ้งเตือน

      หรือ

    2. ใช้ UI เพื่ออัปเดตเงื่อนไขการแจ้งเตือนโดยใช้กระบวนการที่ระบุไว้ในเอกสารด้านล่าง

      UI เหตุการณ์

    3. เรียกใช้สร้างเงื่อนไขการแจ้งเตือนและ Action API เพื่อสร้างเงื่อนไขการแจ้งเตือนที่เหมาะสมและการดำเนินการที่เกี่ยวข้อง
      1. เมื่อสร้างเงื่อนไขการแจ้งเตือนแล้ว ให้เรียกใช้เงื่อนไขการแจ้งเตือนและรายการ API การดำเนินการ เพื่อยืนยันว่ามีการสร้างเงื่อนไขการแจ้งเตือนแล้ว
      2. นอกจากนี้ คุณยังประมวลผลการแจ้งเตือนอีกครั้งได้โดยใช้ประมวลผล 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. หากมีการทริกเกอร์เงื่อนไขการแจ้งเตือน แต่คุณยังคงไม่ได้รับการแจ้งเตือน ให้ไปยังต้องรวบรวมข้อมูลการวินิจฉัยพร้อมข้อมูลและเอาต์พุตจากขั้นตอนข้างต้นที่บันทึกไว้

ความละเอียด

  1. ประมวลผลการแจ้งเตือนอีกครั้งโดยใช้ ประมวลผล API การแจ้งเตือนอีกครั้ง

ต้องรวบรวมข้อมูลการวินิจฉัย

หากปัญหายังคงอยู่แม้ว่าจะทำตามวิธีการข้างต้นแล้ว โปรดติดต่อทีมสนับสนุนของ Apigee Edge และให้ข้อมูลการวินิจฉัยต่อไปนี้

ผู้ใช้ Public และ Private Cloud ควรระบุข้อมูลต่อไปนี้

  1. ชื่อองค์กร
  2. ชื่อสภาพแวดล้อม
  3. เงื่อนไขในการแจ้งเตือนการสร้างรายได้ที่ใช้งานไม่ได้
  4. รายละเอียดว่ามีการลองใช้ส่วนต่างๆ ใดใน Playbook นี้และข้อมูลเชิงลึกอื่นๆ ที่จะช่วยให้เราจัดการกับปัญหานี้ได้อย่างรวดเร็ว

นอกเหนือจากข้อมูลข้างต้น ผู้ใช้ Private Cloud ควรระบุข้อมูลต่อไปนี้ด้วย

  • บันทึกของเซิร์ฟเวอร์การจัดการ

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