คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่
เอกสารประกอบเกี่ยวกับ Apigee X. ข้อมูล
ลักษณะปัญหา
การแจ้งเตือนการสร้างรายได้ไม่ทำงาน ระบบจึงไม่ส่งอีเมลให้ผู้ใช้ที่สมัครใช้บริการ
ข้อความแสดงข้อผิดพลาด
จะไม่มีการส่งอีเมลเกี่ยวกับการแจ้งเตือนการสร้างรายได้ไปยังผู้ที่สมัครรับข้อมูล และจะไม่สังเกตข้อความแสดงข้อผิดพลาดใดๆ
เกี่ยวกับการแจ้งเตือนกิจกรรมการสร้างรายได้
การสร้างรายได้รองรับการแจ้งเตือนกิจกรรมที่ช่วยให้คุณทำสิ่งต่อไปนี้ได้
- แจ้งนักพัฒนาแอปทุกคนเกี่ยวกับกิจกรรมต่างๆ เช่น ผลิตภัณฑ์ใหม่ ข้อกำหนดและเงื่อนไขเวอร์ชันใหม่ หรือแพ็กเกจราคาใหม่
- แจ้งให้นักพัฒนาแอปบางรายทราบเกี่ยวกับเหตุการณ์ต่างๆ เช่น การเผยแพร่เอกสารการเรียกเก็บเงิน หรือเมื่อถึงเปอร์เซ็นต์ธุรกรรมเป้าหมาย (หากซื้อแพ็กเกจอัตราการแจ้งเตือนแบบปรับได้)
- แจ้งผู้ให้บริการ API เกี่ยวกับเหตุการณ์ที่เกี่ยวข้องกับนักพัฒนาแอป เช่น เมื่อนักพัฒนาแอปลงทะเบียนบัญชี หรือเมื่อนักพัฒนาแอปลงชื่อสมัครใช้แพ็กเกจราคา
- ดูรายละเอียดเพิ่มเติมเกี่ยวกับประเภทการแจ้งเตือนและวิธีตั้งค่าได้ที่นี่
ข้อกำหนดเบื้องต้น
ตรวจสอบว่ามีการดำเนินการตามข้อกำหนดเบื้องต้นต่อไปนี้
- การยอมรับแพ็กเกจราคา
สำหรับการแจ้งเตือนการสร้างรายได้ต่อไปนี้ โปรดตรวจสอบว่านักพัฒนาแอปยอมรับแพ็กเกจราคาที่เกี่ยวข้องหรือไม่
- แพ็กเกจราคาใหม่
- แพ็กเกจราคาที่แก้ไขแล้ว
- แพ็กเกจราคาหมดอายุ
- แพ็กเกจราคาแบบต่ออายุ
- เกินขีดจำกัดของอัตรา
- แพ็กเกจราคาฟรีเมียมที่หมดแล้ว
หากนักพัฒนาแอปไม่ยอมรับแพ็กเกจราคา ระบบจะไม่ทริกเกอร์การแจ้งเตือนเหล่านี้สำหรับนักพัฒนาซอฟต์แวร์รายนั้น
- ควรเรียกใช้เครื่องจัดตารางเวลางานสำหรับการแจ้งเตือนที่เจาะจง
การสร้างรายได้มีเครื่องจัดตารางเวลางานและชุดตำแหน่งงานที่มีการกำหนดเวลาให้แสดงในเวลาที่กำหนดไว้ล่วงหน้า ต้องเรียกใช้เครื่องจัดตารางเวลางานสำหรับการแจ้งเตือนที่เฉพาะเจาะจง หากไม่ทำงาน การแจ้งเตือนจะไม่ทำงาน
- ใช้คำแนะนำที่ระบุไว้ในเอกสารต่อไปนี้เพื่อดูว่างานที่กำหนดเวลาไว้สำหรับการแจ้งเตือนหนึ่งๆ ได้ทำงานแล้วหรือไม่
หมายเหตุ: คุณเปลี่ยนกำหนดเวลาได้ทุกเมื่อตามกรณีการใช้งาน
- หากงานที่ตั้งเวลาไว้สำหรับการแจ้งเตือนหนึ่งๆ ได้ทำงานแล้วและคุณยังไม่ได้รับการแจ้งเตือน ให้ไปยังส่วนสาเหตุที่เป็นไปได้เพื่อแก้ปัญหานี้ต่อไป
- หรือไม่เช่นนั้น ให้รอจนกว่างานที่กำหนดเวลาไว้สำหรับการแจ้งเตือนนั้นๆ จะทำงาน
- ใช้คำแนะนำที่ระบุไว้ในเอกสารต่อไปนี้เพื่อดูว่างานที่กำหนดเวลาไว้สำหรับการแจ้งเตือนหนึ่งๆ ได้ทำงานแล้วหรือไม่
สาเหตุที่เป็นไปได้
สาเหตุที่เป็นไปได้สำหรับปัญหานี้มีดังนี้
สาเหตุ | คำอธิบาย | วิธีแก้ปัญหาที่เหมาะสมสำหรับ |
---|---|---|
การกำหนดค่า SMTP ไม่ถูกต้อง | การกำหนดค่า SMTP ที่ระบุไม่ถูกต้อง | ผู้ใช้ Edge Private Cloud |
งานการแจ้งเตือนยังไม่เริ่มต้น | ผู้ใช้ Edge Public Cloud และ Private Cloud |
สาเหตุที่ 1: การกำหนดค่า SMTP ไม่ถูกต้อง
การวิเคราะห์
- ตรวจสอบไฟล์
/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" }
- ยืนยันว่าเซิร์ฟเวอร์ SMTP และการตั้งค่าผู้ใช้ถูกต้องหรือไม่ หากการตั้งค่าเหล่านี้ไม่ถูกต้องหรือไม่ได้ตั้งค่า ให้ไปยังขั้นตอนที่ 3 หากข้อมูลนี้ถูกต้อง ให้ไปยังขั้นตอนที่ 4
- อัปเดตการตั้งค่าเซิร์ฟเวอร์ SMTP และผู้ใช้อย่างถูกต้องโดยใช้คำแนะนำในเอกสารต่อไปนี้
- ตรวจสอบอีกครั้งว่าการแจ้งเตือนการสร้างรายได้ทำงานแล้วหรือยัง หากยังแก้ไขไม่ได้ โปรดทำตามขั้นตอนที่ 5
- หากการตั้งค่า SMTP ถูกต้อง ให้เรียกใช้ API ดูการแจ้งเตือนที่ส่ง เพื่อดูสถานะของการแจ้งเตือนที่ส่ง
- API นี้จะส่งคืน JSON พร้อมการแจ้งเตือนทั้งหมดที่เริ่มทำงานแล้ว รวมถึงสถานะของการแจ้งเตือนแต่ละรายการ
- คุณสามารถดู 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 ระบบจะแสดงสถานะเป็น "ล้มเหลว" สำหรับการแจ้งเตือนเฉพาะข้างต้น "อัปเดตนักพัฒนาซอฟต์แวร์"
- ซึ่งอาจเป็นเพราะเซิร์ฟเวอร์และพอร์ต SMTP นั้นเข้าถึงจากเซิร์ฟเวอร์การจัดการไม่ได้ ใช้คำสั่ง telnet เพื่อตรวจสอบว่าคุณเชื่อมต่อกับเซิร์ฟเวอร์ SMTP ที่ระบุในพอร์ตที่ระบุได้หรือไม่
telnet <SMTP-server-IP-address> <SMTP-Port#>
หากได้รับข้อผิดพลาด "หมดเวลาการเชื่อมต่อ" หรือ "การเชื่อมต่อถูกปฏิเสธ" สำหรับเอาต์พุต telnet จากนั้นไปที่ "ความละเอียด"
ความละเอียด
- ทำงานร่วมกับผู้ดูแลระบบเครือข่ายและตรวจสอบว่าเซิร์ฟเวอร์ SMTP ยอมรับการเชื่อมต่อจากเครื่องอื่นและพอร์ตเฉพาะนั้นเปิดให้เข้าถึงจากภายนอกเพื่อสื่อสารได้
- หากปัญหายังคงอยู่ ให้ไปยัง "ต้องรวบรวมข้อมูลการวินิจฉัย" ด้วย
สาเหตุที่ 2: กำหนดเวลางานการแจ้งเตือน
งานการแจ้งเตือนยังไม่เริ่มต้น
การวิเคราะห์
- เรียกใช้การเรียก API ต่อไปนี้เพื่อดูงานการสร้างรายได้ที่กำหนดเวลาไว้ทั้งหมดในปัจจุบัน
- ตรวจสอบว่ามีเงื่อนไขการแจ้งเตือนอยู่หรือไม่ และเปิดใช้สำหรับการแจ้งเตือนที่ไม่ทำงาน หากไม่มี ให้ไปที่ขั้นตอนที่ 3 เพื่อสร้างเงื่อนไขการแจ้งเตือนและข้ามขั้นตอนที่เหลือ
- หากมี ให้ดูว่าเปิดใช้เป็น "จริง" หรือไม่ แต่หากไม่ได้ใช้ ให้เรียกใช้ Update a notifications condition and action API เพื่ออัปเดตเงื่อนไขการแจ้งเตือน
หรือ
- ใช้ UI เพื่ออัปเดตเงื่อนไขการแจ้งเตือนโดยใช้กระบวนการที่ระบุไว้ในเอกสารด้านล่าง
- เรียกใช้สร้างเงื่อนไขการแจ้งเตือนและ Action API เพื่อสร้างเงื่อนไขการแจ้งเตือนที่เหมาะสมและการดำเนินการที่เกี่ยวข้อง
- เมื่อสร้างเงื่อนไขการแจ้งเตือนแล้ว ให้เรียกใช้แสดงรายการเงื่อนไขการแจ้งเตือนและการดำเนินการ API เพื่อยืนยันว่าได้สร้างเงื่อนไขการแจ้งเตือนแล้ว
- นอกจากนี้ คุณยังประมวลผลการแจ้งเตือนอีกครั้งได้โดยใช้ประมวลผล API การแจ้งเตือนอีกครั้ง
- ขั้นตอนนี้ใช้ได้กับผู้ใช้ 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
- หากมีการทริกเกอร์เงื่อนไขการแจ้งเตือน และคุณยังคงไม่ได้รับการแจ้งเตือน ให้ไปยังต้องรวบรวมข้อมูลการวินิจฉัยพร้อมด้วยข้อมูลและเอาต์พุตจากขั้นตอนด้านบนที่บันทึกไว้
- หากมี ให้ดูว่าเปิดใช้เป็น "จริง" หรือไม่ แต่หากไม่ได้ใช้ ให้เรียกใช้ Update a notifications condition and action API เพื่ออัปเดตเงื่อนไขการแจ้งเตือน
ความละเอียด
- ประมวลผลการแจ้งเตือนอีกครั้งโดยใช้ประมวลผล API การแจ้งเตือนอีกครั้ง
ต้องรวบรวมข้อมูลการวินิจฉัย
หากปัญหายังคงอยู่แม้ว่าจะทำตามวิธีการข้างต้นแล้ว โปรดติดต่อทีมสนับสนุนของ Apigee Edge
และระบุข้อมูลการวินิจฉัยดังต่อไปนี้
ผู้ใช้สาธารณะและ Private Cloud ควรระบุข้อมูลด้านล่าง
- ชื่อองค์กร
- ชื่อสภาพแวดล้อม
- เงื่อนไขของการแจ้งเตือนการสร้างรายได้ไม่ทำงาน
- รายละเอียดว่าส่วนใดใน Playbook นี้มีการลองใช้และข้อมูลเชิงลึกอื่นๆ ที่จะช่วยให้เราแก้ไขปัญหานี้ได้อย่างรวดเร็ว
นอกเหนือจากข้อมูลข้างต้น ผู้ใช้ Private Cloud ควรให้ข้อมูลต่อไปนี้ด้วย
- บันทึกของเซิร์ฟเวอร์การจัดการ
วันที่/opt/apigee/var/log/edge-management-server/logs/system.log