Kami akan menghentikan On-Premises API. Lihat Proses Penghentian On-Premises API dokumen untuk detailnya, dan untuk mempelajari cara bermigrasi ke Cloud API generasi berikutnya.
Catatan Dukungan
Selain menggunakan node support untuk mengambil informasi dukungan Anda, Anda juga dapat mengambil catatan Docker, catatan AWS, dan ID Permintaan HTTP untuk memecahkan masalah.
Dokumen ini mencakup:
Lihat Hubungi Dukungan untuk informasi selengkapnya tentang cara membuka tiket Dukungan Langsung.
Mengambil Catatan Docker
Menggunakan WADebug (preferensi)
Anda dapat menggunakan fitur WADebug untuk otomatis mengumpulkan dan mengunggah catatan. Anda akan menerima run_id sebagai bagian dari tanggapan, yang dapat Anda rujuk di Dukungan Langsung untuk penyelidikan yang lebih cepat. Semudah menjalankan perintah berikut:
wadebug logs --send
Catatan: Untuk mode Ketersediaan Tinggi/Multikoneksi tempat kontainer diinstal pada satu atau beberapa host, Anda harus masuk ke setiap host, menginstal WADebug dan menjalankan perintah di atas. Anda akan mendapat satu run_id dari setiap menjalankan perintah yang berhasil yang dapat Anda rujuk di Dukungan Langsung untuk penyelidikan yang lebih cepat.
Menggunakan Docker
Jika Anda tidak dapat menggunakan fitur WADebug, Anda dapat menggunakan perintahdocker logs untuk mengambil catatan dari setiap kontainer satu per satu. Contoh: untuk mengambil catatan dari kontainer waweb, jalankan perintah berikut:
docker logs <container id of waweb> >> waweb.log
Anda dapat menggunakan berbagai opsi perintah docker logs untuk membatasi ukuran file catatan. Contoh: untuk hanya mendapatkan 1.000 baris catatan terakhir dari kontainer waweb, jalankan perintah berikut:
docker logs <container id of waweb> --tail 1000 >> waweb.log
Untuk mendapatkan hanya catatan kontainer waweb antara durasi waktu tertentu, jalankan perintah dengan opsi --since dan --until, contoh:
docker logs <container id of waweb> --since 2020-01-20T20:00:00Z --until 2020-01-21T08:00:00Z >> waweb.log
Jalankan perintah dengan semua kontainer WhatsApp, dan kirim file-file itu ke WhatsApp untuk analisis dan debug. Baca dokumentasidocker logs resmi untuk opsi lainnya.
Catatan: Semua catatan kontainer adalah dalam zona waktu GMT. Anda harus meneruskan cap waktu GMT ke parameter --since dan --until.
Menggunakan Fitur Tulis Docker
Untuk mendapatkan semua catatan dari kontainer WhatsApp, jalankan perintah berikut:
WA_API_VERSION=new-whatsapp-version docker-compose logs > debug_output.txt
Catatan: Perintah ini dapat menghasilkan file catatan yang sangat besar. Lihat bagian "Menggunakan Docker" untuk opsi mengambil catatan yang lebih kecil dan lebih relevan.
Anda dapat mengirim file tersebut ke WhatsApp untuk analisis dan debug.
Catatan crash
Kami menerapkan sistem pencatatan crash baru dalam versi 2.53, yang menyimpan file dump setiap kali terjadi crash. File-file ini, yang dikenal sebagai crash dump, disimpan dalam direktori logs/ dan disimpan selama 30 hari. File-file hanya disimpan secara lokal pada mesin dan dapat diambil dengan cara yang sama seperti file catatan. Crash dump dapat meliputi data memori yang terkait dengan utas yang mengalami crash.
Mengambil Catatan Kubernetes
Menggunakan kubectl
Untuk mendapatkan catatan untuk layanan tertentu yang diterapkan, seperti Webapp, di pengaturan Kubernetes , jalankan perintah berikut:
kubectl logs deployments/whatsapp-web-deployment > whatsapp-web-deployment.txt
Lalu Anda dapat mengirim file tersebut ke WhatsApp untuk analisis dan debug.
Mengambil Catatan AWS
Harap ikuti langkah-langkah berikut untuk mengambil catatan pada pengaturan AWS:
Atur Rollback on Failure ke No untuk memastikan catatan tidak dihapus saat gagal
Ini perlu diatur selama langkah pembuatan/pembaruan tumpukan, seperti yang terlihat di bawah ini:
Dapatkan catatan dan peristiwa pembuatan CloudFormation Stack dari konsol CloudWatch
Hubungkan ke instance EC2 Anda (jika berhasil dibuat)
Ikuti panduan AWS untuk cara SSH ke instance EC2 Anda. Perhatikan bahwa selama pembuatan/pembaruan tumpukan API WhatsApp Business, Anda dapat memilih untuk menggunakan VPC pribadi atau publik. Dengan VPC pribadi, Anda harus mengikuti bagian Terhubung dengan Aman ke Instance Linux yang Aktif di Amazon VPC Pribadi.
Mendapatkan catatan
Setelah Anda memiliki akses ke kontainer, ambil catatan berikut dan lampirkan ke tiket Dukungan Langsung.
sudo docker logs ecs-agent > ecs-agent.log- Zip dan ambil /var/log dari semua instance EC2 yang dibuat oleh tumpukan
- Instal WADebug di semua instance EC2 dan jalankan perintah
wadebug logsuntuk mengumpulkan semua catatan kontainer. - Jika
WADebugtidak dapat digunakan pada langkah 3, jalankan perintah berikut untuk mengumpulkan catatan secara manual:- Jalankan
docker ps -auntuk membuat daftar semua kontainer aktif dan membagikan hasilnya - Jalankan
docker logs <docker container id of the core app> >> wacore.logdan bagikan catatan - Jalankan
docker logs <docker container id of the web app> >> waweb.logdan bagikan catatan - Jalankan
docker cp <docker container id of the web app>:/var/log/whatsapp/web.log ./web.logdan bagikan catatan - Jalankan
docker cp <docker container id of the web app>:/var/log/lighttpd/error.log ./error.logdan bagikan catatan
Riwayat Aktivitas
Jika instance EC2 tidak dibuat, Riwayat Aktivitas grup penskalaan Otomatis yang sesuai akan diperlukan. Ini bisa ditemukan di konsol EC2 -> Auto Scaling -> Auto Scaling Groups. Kemudian pilih grup yang sesuai untuk tumpukan yang bermasalah dan pilih tab Activity History.
Mengumpulkan ID Permintaan HTTP
Diawali v2.21.3, API WhatsApp Business membuat ID permintaan unik untuk setiap permintaan HTTP masuk yang diterima. ID permintaan ini digunakan untuk membantu menentukan catatan yang terkait dengan permintaan tertentu untuk pemecahan masalah yang cepat. Jika Anda ingin melaporkan bug, sertakan nilai dari header tanggapan X-Request-ID dan X-Internal-Request-IDS di tiket Anda untuk membantu menemukan dan mereproduksi masalah Anda.