Řešení potíží a ladění obslužné rutiny události Azure Web PubSub
Když se připojení WebSocket připojí ke službě Web PubSub, služba formuluje požadavek HTTP POST na zaregistrovaný upstream a očekává odpověď HTTP. Jako obslužnou rutinu události voláme upstream a obslužná rutina události zodpovídá za zpracování příchozích událostí podle specifikace Web PubSub CloudEvents.
Místní spuštění koncového bodu obslužné rutiny události
Když se obslužná rutina události spustí místně, místní server není veřejně přístupný.
Provoz do místního hostitele můžete směrovat dvěma způsoby. Jedním z nich je zpřístupnění místního hostitele na internetu pomocí nástrojů, jako je ngrok, localtunnel nebo TunnelRelay. Dalším způsobem a také doporučeným způsobem je použít tunel awps-tunnel k tunelování provozu ze služby Web PubSub prostřednictvím nástroje na místní server.
Nástroj pro místní tunel Web PubSub pod kapotou vytváří několik trvalých tunelových připojení (považujeme ho za jeden typ připojení serveru) ke službě Web PubSub. Pokaždé, když dojde k události, služba Web PubSub směruje zprávu události prostřednictvím připojení tunelu k místnímu nástroji tunelu a nástroj místního tunelu reformuje požadavek HTTP a odešle požadavek na nadřazený server.
Nástroj místního tunelu poskytuje živé zobrazení pracovního postupu prostřednictvím stránky webového zobrazení. Webové zobrazení ve výchozím nastavení naslouchá na místním portu upstream port + 1000a můžete přizpůsobit port webového zobrazení pomocí parametru --webviewPort <your-custom-port>příkazu .
Webové zobrazení obsahuje čtyři karty:
- Karta Klienta poskytuje testovacího klienta WebSocket pro připojení web pubSub a odesílání dat.
- Karta Web PubSub poskytuje základní informace o vaší službě Web PubSub a pokud je povolená, vloží stránku živého trasování.
- Karta Místní tunel obsahuje seznam všech požadavků procházejících nástrojem místního tunelu na místní server.
- Karta Server zobrazuje základní informace o místním serveru. Poskytuje také integrovaný server echo s kódem podobným vzorovým kódem, který je zobrazený pod ním.
Pomocí nástroje Vyvíjet pomocí místního tunelu nainstalujte a spusťte nástroj tunelu místně a vyvíjejte server obslužné rutiny událostí místně.
Online ladění koncového bodu obslužné rutiny události
Někdy může dojít k problémům s odesíláním událostí do upstreamu nakonfigurované obslužné rutiny události. Jeden typický typ chyby souvisí se selháním ochrany před zneužitím, AbuseProtectionResponseInvalidStatusCodenapříklad , AbuseProtectionResponseMissingAllowedOriginnebo AbuseProtectionResponseFailed. Taková chyba pravděpodobně souvisí s nastavením nadřazeného aplikačního serveru, například stavový kód 403 může souviset s konfigurací ověřování aplikačního serveru, stavový kód 404 může být způsobený nekonzistentní konfigurací cesty obslužné rutiny události. Jedním zezpůsobůch služeb je odeslání požadavku na ochranu před zneužitím na vaši nakonfigurovanou adresu URL curl https://abc.web.com/eventhandler obslužné rutiny událostí, jak je znázorněno níže:
curl https://abc.web.com/eventhandler -X OPTIONS -H "WebHook-Request-Origin: *" -H "ce-awpsversion: 1.0" --ssl-no-revoke -i
Příkaz by měl vrátit verzi 204.
Další kroky
Pomocí těchto prostředků můžete začít vytvářet vlastní aplikaci: