เกตเวย์ API คอนเวอร์ชั่น - การแก้ไขข้อผิดพลาดและการเตือน
หากคุณสังเกตเห็นว่าเหตุการณ์เซิร์ฟเวอร์หายไป หรือเหตุการณ์เซิร์ฟเวอร์มีปริมาณน้อยกว่าเหตุการณ์เบราว์เซอร์ ให้ใช้เอกสารประกอบนี้เพื่อแก้ไขปัญหาดังกล่าว หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับเครื่องมือการแก้ไขปัญหา โปรดดูเกตเวย์ API คอนเวอร์ชั่น - เครื่องมือการแก้ไขปัญหา
ทำตามขั้นตอนต่อไปนี้เพื่อช่วยในการระบุปัญหา
- ไปที่ตัวจัดการเหตุการณ์
- ตรวจสอบยืนยันว่าโดเมนได้รับการกำหนดค่าเพื่อส่งเหตุการณ์แล้ว
- เปิดเว็บไซต์ในเบราว์เซอร์
- ตรวจสอบยืนยันว่า DNS ได้รับการกำหนดค่าอย่างถูกต้อง
- ตรวจสอบยืนยันว่ามีการออกใบรับรองแล้วและใบรับรองยังไม่หมดอายุ
- UI ผู้ดูแลเกตเวย์ API คอนเวอร์ชั่น
- ตรวจสอบยืนยันว่าคุณมีเกตเวย์ API คอนเวอร์ชั่นในเวอร์ชั่นปัจจุบัน
โดเมนไม่ได้รับการกำหนดค่าให้ส่งเหตุการณ์
เกตเวย์ API คอนเวอร์ชั่นจะได้รับเหตุการณ์จากโดเมนที่มีการเชื่อมต่อที่คุณได้กำหนดค่าไว้ระหว่างการตั้งค่าการผสานการทำงาน หากปริมาณเหตุการณ์เซิร์ฟเวอร์ต่ำลงเมื่อเทียบกับเหตุการณ์เบราว์เซอร์ นั่นอาจเป็นเพราะพิกเซลเริ่มการทำงานจากโดเมนที่ยังไม่ได้เชื่อมต่อกับ Meta
การวินิจฉัย
- เข้าสู่ระบบไปยังตัวจัดการเหตุการณ์
- เลือกเหตุการณ์ที่เหมาะสม
- คลิกดูรายละเอียดแล้วเลือกภาพรวมเหตุการณ์
- จากเมนูดร็อปดาวน์ที่อยู่ด้านซ้าย เลือกโดเมนเพื่อหาโดเมนที่เหตุการณ์เบราว์เซอร์ถูกส่งออกมา
- หากโดเมนเหล่านั้นขาดหายไปหรือต่างจากโดเมนที่กำหนดค่าไว้ ให้คาดการณ์ว่าเหตุการณ์เบราว์เซอร์จะไม่ได้ถูกบันทึกไว้
การแก้ไขปัญหา
- เพิ่มโดเมนที่กำหนดให้กับการเชื่อมต่อเกตเวย์ API คอนเวอร์ชั่นโดยปฏิบัติตามคู่มือนี้
DNS ไม่ได้รับการกำหนดค่าหรือการแมป DNS ไม่ถูกต้อง
เกตเวย์ API คอนเวอร์ชั่นจะโฮสต์อยู่บน AWS ซึ่งจะมอบหมายที่อยู่ IP ให้เกตเวย์ดังกล่าวเมื่อสร้าง IP คุณต้องแมปโดเมนย่อยของโดเมนของคุณให้กับที่อยู่ IP เพื่อให้สามารถเข้าถึงตำแหน่งข้อมูลเกตเวย์ API คอนเวอร์ชั่นได้จากเบราว์เซอร์ผ่านการเรียกใช้คำขอบุคคลที่หนึ่ง
การวินิจฉัย
- ใช้ตัวตรวจสอบ DNS ออนไลน์ เช่น
https://dnschecker.org/เพื่อตรวจสอบยืนยันว่าโดเมนเกตเวย์ API คอนเวอร์ชั่นได้รับการแปลงเป็นที่อยู่ IP ที่ถูกต้องและเผยแพร่อย่างเต็มรูปแบบแล้ว หากโดเมนของคุณไม่ได้รับการแปลงเป็นที่อยู่ IP ให้อ่านหัวข้อการแก้ไขปัญหาสำหรับขั้นตอนถัดไป - รับที่อยู่ IP เซิร์ฟเวอร์เกตเวย์ API คอนเวอร์ชั่นจากแดชบอร์ด AWS EC2 ของคุณหรือขอข้อมูลนี้จากบุคคลติดต่อด้านโครงสร้างพื้นฐานระบบคลาวด์ของคุณ
- หากที่อยู่ IP สองรายการแตกต่างกัน ให้อ่านหัวข้อการแก้ไขปัญหาสำหรับขั้นตอนถัดไป
การแก้ไขปัญหา
- ขอความช่วยเหลือจากผู้ดูแลระบบในการค้นหาผู้รับจดทะเบียนโดเมน
- อัพเดตบันทึก DNS กับผู้รับจดทะเบียนโดเมนของคุณโดยใช้ที่อยู่ IP ของเซิร์ฟเวอร์เกตเวย์ API คอนเวอร์ชั่น (ที่แสดงบนแดชบอร์ด AWS EC2 ของคุณ)
- ตั้งบันทึก DNS ประเภท A ที่แมปกับโดเมนย่อยของเกตเวย์ API คอนเวอร์ชั่นให้เป็นที่อยู่ IP เซิร์ฟเวอร์ที่สร้างขึ้นระหว่างการตั้งค่า
ไม่มีการออกใบรับรอง
หากเกตเวย์ API คอนเวอร์ชั่นไม่ได้รับใบรับรองจาก Let's Encrypt แม้จะผ่านมานานแล้วหลังจากกำหนดค่า DNS อย่างถูกต้อง ก็หมายความว่าโดเมนของคุณได้รับความนิยมมากจน Let's Encrypt ไม่สามารถออกใบรับรองให้ได้
การแก้ไขปัญหา
- ลองเพิ่ม AWS Load Balancer (ALB) ไว้ด้านหน้าอินสแตนซ์เกตเวย์ API คอนเวอร์ชั่น แล้วใช้ ALB เพื่อโฮสต์ใบรับรองของคุณเอง
มีการออกใบรับรองแล้วแต่หมดอายุ
ปัญหานี้จะเกิดขึ้นหากคุณปิดพอร์ต 80 หลังจากติดตั้งเกตเวย์ API คอนเวอร์ชั่นสำเร็จแล้ว หรือหากคุณใช้งานเวอร์ชั่นเก่าอยู่
การแก้ไขปัญหา
- เปิดพอร์ต 80 และอัพเกรดเกตเวย์ API คอนเวอร์ชั่นเป็นเวอร์ชั่นล่าสุด
เข้าใช้งาน UI เกตเวย์ไม่ได้
ปัญหานี้จะเกิดขึ้นหากคุณปิดพอร์ต 80 หลังจากติดตั้งเกตเวย์ API คอนเวอร์ชั่นสำเร็จแล้ว หรือหากคุณใช้งานเวอร์ชั่นเก่าอยู่
การแก้ไขปัญหา
- ตรวจสอบว่าที่อยู่ IP สำหรับอินสแตนซ์เกตเวย์ API คอนเวอร์ชั่นตรงกับการกำหนดค่า DNS หรือไม่ หากไม่ตรง หมายความว่า DNS ไม่ได้รับการกำหนดค่าหรือการแมป DNS ไม่ถูกต้อง
- หากเซิร์ฟเวอร์ไม่ตอบสนอง อาจมีสาเหตุเนื่องมาจากความผิดพลาดทางเครือข่ายแบบชั่วคราว และสามารถแก้ไขได้โดยเริ่มการทำงานของอินสแตนซ์อีกครั้ง โดยการเริ่มทำงานใหม่ของเกตเวย์ API คอนเวอร์ชั่นจะใช้เวลาประมาณ 1-2 นาที ควรรอประมาณ 10 นาทีก่อนที่จะเข้าสู่ระบบอีกครั้ง
ต้องอัพเกรดเวอร์ชั่นเกตเวย์
คุณอาจพบว่าเกตเวย์ API คอนเวอร์ชั่นในเวอร์ชั่นที่เก่ากว่า 1.0.8 หยุดส่งเหตุการณ์ไปยัง Meta เราขอแนะนำให้คุณอัพเกรดเกตเวย์เป็นเวอร์ชั่น 1.0.8 เป็นอย่างน้อยเพื่อให้ได้รับประโยชน์สูงสุดจากการตั้งค่า ระบบจะดำเนินขั้นตอนของเหตุการณ์ต่อและยังเป็นการรับรองว่าการอัพเดตจะเป็นไปโดยอัตโนมัติในอนาคต
การวินิจฉัย
- หากต้องการตรวจสอบเวอร์ชั่นเกตเวย์ API คอนเวอร์ชั่นล่าสุด ให้ดำเนินการดังนี้
- เปิด UI ผู้ดูแลเกตเวย์ API คอนเวอร์ชั่น:
https://<Conversions API Gateway Endpoint>/hub
- ตรวจสอบเวอร์ชั่นเซิร์ฟเวอร์เกตเวย์ API คอนเวอร์ชั่นล่าสุดของคุณ
- เมนูด้านซ้าย > การตั้งค่า > อัพเดต
การแก้ไขปัญหา
หากต้องการอัพเกรดเกตเวย์ API คอนเวอร์ชั่น ให้ดำเนินการต่อไปนี้
- อัพเดตบันทึก DNS เพื่อใช้ IP จากสแต็กใหม่
การแก้ไขปัญหาด้วยบันทึก EKS
หากคุณพบปัญหาในการติดตั้งเกตเวย์ API คอนเวอร์ชั่นสำหรับเวอร์ชั่น EKS บัญชีเดียวหรือเวอร์ชั่นหลายบัญชี คุณสามารถดูบันทึกนี้เพื่อแก้ไขปัญหาได้
บันทึกการติดตั้ง EKS พร้อมใช้งานแล้วใน AWS Cloudwatch ใต้ชื่อกลุ่ม "ConversionsAPIGateway/cloud-init-output.log" คุณสามารถตรวจสอบว่ามีข้อความแสดงข้อผิดพลาดใดหรือไม่ได้ ข้อผิดพลาดที่พบได้บ่อย ได้แก่ ทรัพยากร AWS เกินขีดจำกัดและไม่มีสิทธิ์การอนุญาต AWS
บันทึก DNS ที่มีประเภท CAA ไม่มี amazonaws.com
หากบันทึก DNS ที่เกตเวย์ API คอนเวอร์ชั่นขอให้ตั้งค่ามีใบรับรอง TLS ที่ถูกต้องหรือไม่มีบันทึก CAA คุณไม่จำเป็นต้องดูเนื้อหาส่วนนี้
แต่ถ้าหากคุณมีบันทึก CAA สำหรับโดเมน โปรดอย่าลืมระบุ amazonaws.com เป็นค่าสำหรับบันทึก CAA หากคุณได้ติดตั้งเกตเวย์ API คอนเวอร์ชั่นในเวอร์ชั่น AWS EKS (สำหรับบัญชีเดียว) หรือเกตเวย์ API คอนเวอร์ชั่นสำหรับหลายบัญชีเวอร์ชั่น 1.10.* ขึ้นไปซึ่งใช้ AWS Certificate Manager สำหรับการสร้างโดเมน ตัวอย่างบันทึก CAA จะมีลักษณะดังนี้
0 issue "amazonaws.com"
หากคุณได้ติดตั้งเกตเวย์ API คอนเวอร์ชั่นสำหรับหลายบัญชีเวอร์ชั่น 1.9.* หรือเก่ากว่า โปรดอย่าลืมระบุ letsencrypt.org เป็นค่าสำหรับบันทึก CAA ตัวอย่างจะมีลักษณะดังนี้
0 issue "letsencrypt.org"