Cara memecahkan masalah dan men-debug penanganan aktivitas Azure Web PubSub
Ketika koneksi WebSocket tersambung ke layanan Web PubSub, layanan merumuskan permintaan HTTP POST ke upstream terdaftar dan mengharapkan respons HTTP. Kami menyebut upstream sebagai penanganan aktivitas dan penanganan aktivitas bertanggung jawab untuk menangani peristiwa masuk mengikuti spesifikasi Web PubSub CloudEvents.
Menjalankan titik akhir penanganan aktivitas secara lokal
Saat penanganan aktivitas berjalan secara lokal, server lokal tidak dapat diakses secara publik.
Ada dua cara untuk merutekan lalu lintas ke localhost Anda, salah satunya adalah dengan mengekspos localhost agar dapat diakses di internet menggunakan alat seperti ngrok, localtunnel, atau TunnelRelay. Cara lain, dan juga cara yang disarankan adalah menggunakan terowongan awps untuk membuat terowongan lalu lintas dari layanan Web PubSub melalui alat ke server lokal Anda.
Alat terowongan lokal Web PubSub, di bawah tenda, membangun beberapa koneksi terowongan persisten (kami menganggapnya sebagai salah satu jenis koneksi server) ke layanan Web PubSub. Setiap kali peristiwa masuk, layanan Web PubSub merutekan pesan peristiwa melalui koneksi terowongan ke alat terowongan lokal, dan alat terowongan lokal mereformasi permintaan HTTP dan mengirim permintaan ke server upstream Anda.
Alat terowongan lokal menyediakan tampilan alur kerja yang cerah melalui halaman tampilan web. Tampilan web secara default mendengarkan di port upstream port + 1000lokal , dan Anda dapat menyesuaikan port tampilan web menggunakan parameter --webviewPort <your-custom-port>perintah .
Tampilan web berisi empat tab:
- Tab Klien , ini menyediakan klien WebSocket pengujian untuk menyambungkan Web PubSub dan mengirim data.
- Tab Web PubSub , tab ini menyediakan info dasar tentang layanan Web PubSub Anda dan menyematkan halaman Pelacakan Langsung jika diaktifkan.
- Tab Terowongan Lokal, ini mencantumkan semua permintaan melalui alat terowongan lokal ke server lokal Anda.
- Tab Server , ini memperlihatkan info dasar tentang server lokal Anda. Ini juga menyediakan server gema bawaan dengan kode yang mirip dengan kode sampel yang ditunjukkan di bawahnya.
Ikuti Mengembangkan dengan alat terowongan lokal untuk menginstal dan menjalankan alat terowongan secara lokal untuk mengembangkan server penanganan aktivitas Anda secara lokal.
Men-debug titik akhir penanganan aktivitas secara online
Terkadang Anda mungkin mengalami masalah saat mengirim peristiwa ke upstream penanganan aktivitas yang dikonfigurasi. Salah satu jenis kesalahan umum terkait dengan kegagalan perlindungan penyalahgunaan, misalnya, AbuseProtectionResponseInvalidStatusCode, AbuseProtectionResponseMissingAllowedOrigin, atau AbuseProtectionResponseFailed. Kesalahan seperti itu mungkin terkait dengan pengaturan server aplikasi upstream Anda, misalnya, kode status 403 mungkin terkait dengan konfigurasi autentikasi server aplikasi Anda, kode status 404 mungkin disebabkan oleh konfigurasi jalur penanganan aktivitas yang tidak konsisten. Salah satu cara untuk memecahkan masalah kegagalan tersebut adalah dengan mengirim permintaan perlindungan penyalahgunaan ke URL penanganan aktivitas yang dikonfigurasi untuk melihat apakah itu berfungsi, misalnya, menggunakan curl perintah untuk mengirim permintaan perlindungan penyalahgunaan ke URL https://abc.web.com/eventhandler penanganan aktivitas yang dikonfigurasi adalah seperti di bawah ini:
curl https://abc.web.com/eventhandler -X OPTIONS -H "WebHook-Request-Origin: *" -H "ce-awpsversion: 1.0" --ssl-no-revoke -i
Perintah harus mengembalikan 204.
Langkah berikutnya
Gunakan sumber daya ini untuk mulai membangun aplikasi Anda sendiri: