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

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

ลักษณะปัญหา

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

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

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

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

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

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

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

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

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

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

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

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

  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. หากมี ให้ดูว่าเปิดใช้เป็น "จริง" หรือไม่ แต่หากไม่ได้ใช้ ให้เรียกใช้ Update a notifications condition and action 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 และระบุข้อมูลการวินิจฉัยดังต่อไปนี้

ผู้ใช้สาธารณะและ Private Cloud ควรระบุข้อมูลด้านล่าง

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

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

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

    วันที่ /opt/apigee/var/log/edge-management-server/logs/system.log