เรากำลังเลิกใช้งาน API ภายในองค์กร และหากต้องการรายละเอียดเพิ่มเติมและเรียนรู้วิธีย้ายไปใช้ API ระบบคลาวด์รุ่นใหม่ของเรา โปรดดูเอกสารการเลิกใช้งาน API ภายในองค์กรของเรา
บันทึกการสนับสนุน
นอกเหนือจากการใช้โหนด support เพื่อเรียกดูข้อมูลสนับสนุนของคุณแล้ว คุณยังสามารถเรียกดูบันทึก Docker, บันทึก AWS และ ID คำขอ HTTP เพื่อนำมาแก้ไขปัญหาได้อีกด้วย
เอกสารนี้ครอบคลุมเนื้อหาดังต่อไปนี้
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดบัตรคำร้องขอรับความช่วยเหลือโดยตรงที่ "ติดต่อฝ่ายสนับสนุน"
เรียกดูบันทึก Docker
โดยใช้ WADebug (แนะนำ)
คุณสามารถใช้เครื่องมือ WADebug เพื่อรวบรวมและอัพโหลดบันทึกโดยอัตโนมัติได้ คุณจะได้รับ run_id เป็นส่วนหนึ่งของการตอบกลับ ซึ่งคุณจะสามารถนำไปอ้างอิงได้ในการขอรับความช่วยเหลือโดยตรงเพื่อการตรวจสอบที่รวดเร็วยิ่งขึ้น ขั้นตอนนี้สามารถดำเนินการได้ง่ายๆ โดยเรียกใช้คำสั่งต่อไปนี้
wadebug logs --send
หมายเหตุ: สำหรับโหมดความพร้อมใช้งานสูง/การเชื่อมต่อหลายจุดที่ติดตั้งคอนเทนเนอร์บนโฮสต์หนึ่งรายการหรือหลายโฮสต์ คุณต้องเข้าสู่ระบบแต่ละโฮสต์ ติดตั้ง WADebug และเรียกใช้คำสั่งด้านบน คุณจะได้รับ run_id จำนวน 1 รายการเมื่อเรียกใช้คำสั่งสำเร็จแต่ละครั้ง ซึ่งคุณสามารถอ้างอิงได้ในความช่วยเหลือโดยตรงเพื่อการตรวจสอบที่รวดเร็วยิ่งขึ้น
โดยใช้ Docker
หากคุณไม่สามารถใช้เครื่องมือ WADebug ได้ คุณก็สามารถใช้คำสั่ง docker logs เพื่อเรียกดูบันทึกจากคอนเทนเนอร์แต่ละรายการแยกกันได้ ตัวอย่างเช่น หากต้องการเรียกดูบันทึกจากคอนเทนเนอร์ waweb ให้เรียกใช้คำสั่งต่อไปนี้
docker logs <container id of waweb> >> waweb.log
คุณสามารถใช้ตัวเลือกคำสั่ง docker logs เพื่อจำกัดขนาดของไฟล์บันทึกได้ ตัวอย่างเช่น หากต้องการเรียกดูบันทึกจากคอนเทนเนอร์ waweb เฉพาะ 1,000 บรรทัดล่าสุดเท่านั้น ให้เรียกใช้คำสั่งต่อไปนี้
docker logs <container id of waweb> --tail 1000 >> waweb.log
หากต้องการเรียกดูบันทึกของคอนเทนเนอร์ waweb ในช่วงระยะเวลาหนึ่งเท่านั้น ให้เรียกใช้คำสั่งที่มีตัวเลือก --since และ --until ตัวอย่างเช่น
docker logs <container id of waweb> --since 2020-01-20T20:00:00Z --until 2020-01-21T08:00:00Z >> waweb.log
เรียกใช้คำสั่งกับคอนเทนเนอร์ WhatsApp ทั้งหมด และส่งไฟล์เหล่านั้นไปยัง WhatsApp เพื่อวิเคราะห์และแก้ไขจุดบกพร่อง โปรดดูตัวเลือกเพิ่มเติมที่docker logsเอกสารประกอบอย่างเป็นทางการ
หมายเหตุ: บันทึกของคอนเทนเนอร์ทั้งหมดจะเป็นโซนเวลา GMT คุณต้องส่งผ่านประทับเวลาแบบ GMT ไปยังพารามิเตอร์ --since และ --until
โดยใช้ Docker Compose
ให้เรียกใช้คำสั่งต่อไปนี้เพื่อรับบันทึกทั้งหมดจากคอนเทนเนอร์ WhatsApp ทั้งหมด
WA_API_VERSION=new-whatsapp-version docker-compose logs > debug_output.txt
หมายเหตุ: คำสั่งนี้อาจสร้างไฟล์บันทึกที่มีขนาดใหญ่มาก โปรดดูตัวเลือกในการเรียกดูบันทึกที่มีขนาดเล็กกว่าและมีความเกี่ยวข้องมากยิ่งขึ้นที่ส่วน "โดยใช้ Docker"
จากนั้นคุณสามารถส่งไฟล์เหล่านี้ไปที่ WhatsApp เพื่อการวิเคราะห์และการแก้ไขจุดบกพร่อง
บันทึกข้อขัดข้อง
เราใช้ระบบบันทึกข้อขัดข้องใหม่ในเวอร์ชั่น 2.53 ซึ่งจะบันทึกไฟล์ดัมพ์ทุกครั้งที่เกิดข้อขัดข้อง ไฟล์เหล่านี้เรียกว่า Crash Dump โดยจะจัดเก็บไว้ในไดเร็กทอรี logs/ และจะเก็บไว้เป็นเวลา 30 วัน ไฟล์เหล่านี้จะจัดเก็บไว้ในเครื่องเท่านั้นและสามารถเรียกดูได้ในลักษณะเดียวกับไฟล์บันทึก Crash Dump อาจมีข้อมูลหน่วยความจำที่เกี่ยวข้องกับเธรดที่ขัดข้อง
เรียกดูบันทึก Kubernetes
โดยใช้ kubectl
หากต้องการรับบันทึกสำหรับบริการอย่างใดอย่างหนึ่งที่ใช้งานอยู่ เช่น Webapp ให้เรียกใช้คำสั่งต่อไปนี้ในการตั้งค่า Kubernetes
kubectl logs deployments/whatsapp-web-deployment > whatsapp-web-deployment.txt
จากนั้นคุณจะสามารถส่งไฟล์นี้ไปยัง WhatsApp เพื่อวิเคราะห์และแก้ไขจุดบกพร่องได้
เรียกดูบันทึก AWS
โปรดทำตามขั้นตอนด้านล่างเพื่อจัดเก็บบันทึกในการตั้งค่า AWS
ตั้งค่า Rollback on Failure เป็น No เพื่อให้แน่ใจว่าบันทึกจะไม่ถูกลบเมื่อเกิดความล้มเหลว
โดยต้องตั้งค่าส่วนนี้ระหว่างขั้นตอนการสร้าง/อัพเดตสแต็กดังที่แสดงด้านล่างนี้
เรียกดูบันทึกการสร้างสแต็ก CloudFormation และเหตุการณ์ต่างๆ จากคอนโซล CloudWatch
เชื่อมต่อกับอินสแตนซ์ EC2 ของคุณ (หากสร้างสำเร็จ)
ทำตามคู่มือ AWS เกี่ยวกับวิธีการนำ SSH มาใช้กับอินสแตนซ์ EC2 ของคุณ โปรดทราบว่าในระหว่างการสร้าง/การอัพเดตสแต็ก WhatsApp Business API คุณสามารถเลือกว่าจะใช้ VPC ส่วนตัวหรือสาธารณะได้ หากใช้ VPC ส่วนตัว คุณจะต้องทำตามส่วน "Securely Connect to Linux Instances Running in a Private Amazon VPC (เชื่อมต่อกับอินสแตนซ์ Linux ที่ทำงานใน VPC Amazon ส่วนตัวอย่างปลอดภัย)"
การเรียกดูบันทึก
เมื่อคุณมีสิทธิ์การเข้าถึงคอนเทนเนอร์แล้ว โปรดจัดเก็บบันทึกดังต่อไปนี้และแนบไปกับบัตรคำร้องขอรับความช่วยเหลือโดยตรง
sudo docker logs ecs-agent > ecs-agent.log- บีบอัดเป็นไฟล์ Zip และเรียกดู /var/log ของอินสแตนซ์ EC2 ทั้งหมดที่สร้างโดยสแต็ก
- ติดตั้ง WADebug บนอินสแตนซ์ EC2 ทั้งหมดและเรียกใช้คำสั่ง
wadebug logsเพื่อรวบรวมบันทึกคอนเทนเนอร์ทั้งหมด - หากไม่สามารถใช้
WADebugในขั้นตอนที่ 3 ได้ ให้เรียกใช้คำสั่งต่อไปนี้เพื่อรวบรวมบันทึกด้วยตนเอง- เรียกใช้
docker ps -aเพื่อแสดงรายการคอนเทนเนอร์ที่กำลังทำงานอยู่ทั้งหมดและแชร์เอาต์พุต - เรียกใช้
docker logs <docker container id of the core app> >> wacore.logและแชร์บันทึก - เรียกใช้
docker logs <docker container id of the web app> >> waweb.logและแชร์บันทึก - เรียกใช้
docker cp <docker container id of the web app>:/var/log/whatsapp/web.log ./web.logและแชร์บันทึก - เรียกใช้
docker cp <docker container id of the web app>:/var/log/lighttpd/error.log ./error.logและแชร์บันทึก
ประวัติกิจกรรม
หากยังไม่ได้สร้างอินสแตนซ์ EC2 คุณจะต้องมี "Activity History (ประวัติกิจกรรม)" ของ "Auto scaling group (กลุ่มการปรับขนาดอัตโนมัติ)" ที่เหมาะสม โดยประวัติกิจกรรมจะอยู่ใน EC2 console (คอนโซล EC2) -> Auto Scaling (การปรับขนาดอัตโนมัติ) -> Auto Scaling Groups (กลุ่มการปรับขนาดอัตโนมัติ) จากนั้นเลือกกลุ่มที่เหมาะสมสำหรับสแต็กที่มีปัญหา และเลือกแท็บ Activity History (ประวัติกิจกรรม)
การรวบรวม ID คำขอ HTTP
ตั้งแต่ v2.21.3 เป็นต้นไป WhatsApp Business API จะสร้าง ID คำขอที่ไม่ซ้ำกันสำหรับคำขอ HTTP ขาเข้าทุกรายการที่ได้รับ ID คำขอเหล่านี้มีไว้เพื่อช่วยระบุบันทึกที่เกี่ยวข้องกับคำขอที่เฉพาะเจาะจงเพื่อให้แก้ไขปัญหาได้อย่างรวดเร็ว หากคุณต้องการรายงานจุดบกพร่อง โปรดใส่ค่าของส่วนหัวของการตอบกลับเป็น X-Request-ID และ X-Internal-Request-IDS ในบัตรคำร้องของคุณเพื่อช่วยระบุและจำลองปัญหาของคุณขึ้นมาใหม่ได้