Felsöka och felsöka Azure Web PubSub-händelsehanterare
När en WebSocket-anslutning ansluter till Web PubSub-tjänsten formulerar tjänsten en HTTP POST-begäran till den registrerade uppströms och förväntar sig ett HTTP-svar. Vi anropar uppströms som händelsehanterare och händelsehanteraren ansvarar för att hantera inkommande händelser enligt Web PubSub CloudEvents-specifikationen.
Kör händelsehanterarslutpunkten lokalt
När händelsehanteraren körs lokalt är den lokala servern inte offentligt tillgänglig.
Det finns två sätt att dirigera trafiken till din localhost, en är att exponera localhost för att vara tillgänglig på Internet med hjälp av verktyg som ngrok, localtunnel eller TunnelRelay. Ett annat sätt, och även det rekommenderade sättet är att använda awps-tunnel för att tunneltrafik från Web PubSub-tjänsten via verktyget till din lokala server.
Web PubSubs lokala tunnelverktyg, under huven, upprättar flera beständiga tunnelanslutningar (vi betraktar det som en typ av serveranslutningar) till Web PubSub-tjänsten. När en händelse kommer in dirigerar Web PubSub-tjänsten händelsemeddelandet via tunnelanslutningen till det lokala tunnelverktyget och verktyget för lokal tunnel reformerar HTTP-begäran och skickar begäran till din överordnade server.
Det lokala tunnelverktyget ger en levande vy över arbetsflödet via en webbvysida. Webbvyn lyssnar som standard på den lokala porten upstream port + 1000och du kan anpassa webbvyporten med hjälp av kommandoparametern --webviewPort <your-custom-port>.
Webbvyn innehåller fyra flikar:
- På fliken Klient finns en WebSocket-testklient för att ansluta Web PubSub och skicka data.
- Fliken Web PubSub innehåller grundläggande information om din Web PubSub-tjänst och bäddar in sidan Live Trace om den är aktiverad.
- Fliken Lokal tunnel visar en lista över alla begäranden som går via verktyget för lokal tunnel till din lokala server.
- På fliken Server visas den grundläggande informationen om din lokala server. Det ger också en inbyggd ekoserver med kod som liknar den exempelkod som visas under den.
Följ Utveckla med verktyget för lokal tunnel för att installera och köra tunnelverktyget lokalt för att utveckla händelsehanterarservern lokalt.
Felsöka händelsehanterarslutpunkten online
Ibland kan du ha problem med att skicka händelser till en konfigurerad händelsehanterare uppströms. En typisk feltyp är relaterad till missbruksskyddsfel, AbuseProtectionResponseInvalidStatusCodetill exempel , AbuseProtectionResponseMissingAllowedOrigin, eller AbuseProtectionResponseFailed. Ett sådant fel är förmodligen relaterat till dina överordnade appserverinställningar, till exempel kan 403-statuskoden vara relaterad till konfigurationen av appserverautentiseringen, 404-statuskoden kan orsakas av inkonsekvent konfiguration av händelsehanterarsökväg. Ett sätt att felsöka ett sådant fel är att skicka en begäran om missbruksskydd till din konfigurerade url för händelsehanterare för att se om det fungerar, till exempel genom att använda curl kommandot för att skicka en begäran om missbruksskydd till din konfigurerade url https://abc.web.com/eventhandler för händelsehanterare enligt nedan:
curl https://abc.web.com/eventhandler -X OPTIONS -H "WebHook-Request-Origin: *" -H "ce-awpsversion: 1.0" --ssl-no-revoke -i
Kommandot bör returnera 204.
Nästa steg
Använd dessa resurser för att börja skapa ett eget program: