Azure Web PubSub olay işleyicisi sorunlarını giderme ve hatalarını ayıklama

WebSocket bağlantısı Web PubSub hizmetine bağlandığında, hizmet kayıtlı yukarı akışa bir HTTP POST isteği formüle eder ve bir HTTP yanıtı bekler. Yukarı akışı olay işleyicisi olarak çağırırız ve olay işleyicisi Web PubSub CloudEvents belirtimini izleyen gelen olayları işlemekten sorumludur.

Olay işleyici uç noktasını yerel olarak çalıştırma

Olay işleyicisi yerel olarak çalıştırıldığında, yerel sunucu genel olarak erişilemez.

Trafiği localhost'unuza yönlendirmenin iki yolu vardır; bunlardan biri ngrok, localtunnel veya TunnelRelay gibi araçları kullanarak localhost'un İnternet'te erişilebilir olmasını sağlamaktır. Başka bir yol ve ayrıca önerilen yol, web PubSub hizmetinden gelen trafiği araç üzerinden yerel sunucunuza tünel oluşturmak için awps-tunnel kullanmaktır.

Web PubSub yerel tünel aracı, arka planda, Web PubSub hizmetine birkaç kalıcı tünel bağlantısı kurar (bunu tek bir sunucu bağlantısı türü olarak kabul ediyoruz). Her olay geldiğinde Web PubSub hizmeti, tünel bağlantısı aracılığıyla olay iletisini yerel tünel aracına yönlendirir ve yerel tünel aracı HTTP isteğini reforma eder ve isteği yukarı akış sunucunuza gönderir.

Yerel tünel aracı, web görünümü sayfası aracılığıyla iş akışının canlı bir görünümünü sağlar. Web görünümü varsayılan olarak yerel bağlantı noktasında upstream port + 1000dinler ve komut parametresini --webviewPort <your-custom-port>kullanarak webview bağlantı noktasını özelleştirebilirsiniz.

Web görünümü dört sekme içerir:

  • İstemci sekmesinde, Web PubSub'a bağlanmak ve veri göndermek için bir test WebSocket istemcisi sağlar.
  • Web PubSub sekmesi, Web PubSub hizmetinizle ilgili temel bilgileri sağlar ve etkinse Canlı İzleme sayfasını ekler.
  • Yerel Tünel sekmesi, yerel tünel aracından yerel sunucunuza giden tüm istekleri listeler.
  • Sunucu sekmesinde yerel sunucunuzla ilgili temel bilgiler gösterilir. Ayrıca, altında gösterilen örnek koda benzer koda sahip yerleşik bir yankı sunucusu sağlar.

Trafik incelemesini gösteren ekran görüntüsü.

Olay işleyici sunucunuzu yerel olarak geliştirmek için tünel aracını yerel olarak yüklemek ve çalıştırmak için Yerel tünel aracıyla geliştirme'yi izleyin.

Olay işleyici uç noktasında çevrimiçi hata ayıklama

Bazen olayları yapılandırılmış bir olay işleyici yukarı akışına gönderirken sorunlarla karşılaşabilirsiniz. Tipik bir hata türü, , AbuseProtectionResponseMissingAllowedOriginveya AbuseProtectionResponseFailedgibi AbuseProtectionResponseInvalidStatusCodekötüye kullanım koruma hatasıyla ilgilidir. Bu tür bir hata büyük olasılıkla yukarı akış uygulama sunucusu ayarlarınız ile ilgilidir; örneğin, 403 durum kodu uygulama sunucusu kimlik doğrulama yapılandırmanızla ilgili olabilir, 404 durum kodu tutarsız olay işleyici yolu yapılandırması nedeniyle olabilir. Bu tür hataları gidermenin bir yolu, yapılandırılan olay işleyiciSI URL'nize bir kötüye kullanım koruma isteği göndermektir. Örneğin, yapılandırılan olay işleyiciSI URL'nize https://abc.web.com/eventhandler kötüye kullanım koruma isteği göndermek için komutunu kullanmak curl aşağıdaki gibidir:

curl https://abc.web.com/eventhandler -X OPTIONS -H "WebHook-Request-Origin: *" -H "ce-awpsversion: 1.0" --ssl-no-revoke -i

Komut 204 döndürmelidir.

Sonraki adımlar

Kendi uygulamanızı oluşturmaya başlamak için şu kaynakları kullanın: