Устранение неполадок и отладка обработчика событий Azure Web PubSub

Когда подключение WebSocket подключается к службе Web PubSub, служба сформулирует HTTP-запрос POST к зарегистрированной вышестоящий и ожидает HTTP-ответ. Мы вызываем вышестоящий в качестве обработчика событий, а обработчик событий отвечает за обработку входящих событий после спецификации Web PubSub CloudEvents.

Локальное выполнение конечной точки обработчика событий

При локальном запуске обработчика событий локальный сервер недоступен.

Существует два способа маршрутизации трафика в localhost, один — предоставить localhost доступ к Интернету с помощью таких средств, как ngrok, localtunnel или TunnelRelay. Другой способ, а также рекомендуем использовать awps-туннель для туннелирования трафика из службы Web PubSub через средство на локальный сервер.

Средство локального туннеля Web PubSub под капотом устанавливает несколько постоянных подключений туннеля (мы считаем его одним из типов подключений к серверу) к службе Web PubSub. Всякий раз, когда происходит событие, служба Web PubSub направляет сообщение о событии через подключение туннеля к локальному инструменту туннеля, а локальное средство туннелирования реформирует HTTP-запрос и отправляет запрос на сервер вышестоящий.

Средство локального туннеля предоставляет яркое представление рабочего процесса с помощью страницы веб-представления. Веб-представление по умолчанию прослушивает локальный порт upstream port + 1000, и вы можете настроить порт веб-представления с помощью параметра --webviewPort <your-custom-port>команды.

Веб-представление содержит четыре вкладки:

  • Вкладка "Клиент" предоставляет тестовый клиент WebSocket для подключения web PubSub и отправки данных.
  • Вкладка Web PubSub предоставляет основные сведения о службе Web PubSub и внедряет страницу динамической трассировки при включении.
  • Вкладка "Локальный туннель " содержит список всех запросов, поступающих через средство локального туннеля на локальный сервер.
  • Вкладка "Сервер" отображает основные сведения о локальном сервере. Он также предоставляет встроенный эхо-сервер с кодом, похожим на пример кода, показанного ниже.

Снимок экрана: проверка трафика.

Выполните разработку с помощью средства локального туннеля, чтобы установить и запустить средство туннеля локально, чтобы разработать сервер обработчика событий локально.

Отладка конечной точки обработчика событий в сети

Иногда могут возникнуть проблемы с отправкой событий в настроенный обработчик событий вышестоящий. Один типичный тип ошибки связан с ошибкой защиты от злоупотреблений, например , AbuseProtectionResponseInvalidStatusCodeAbuseProtectionResponseMissingAllowedOriginили AbuseProtectionResponseFailed. Такая ошибка, вероятно, связана с параметрами сервера приложений вышестоящий, например, код состояния 403 может быть связан с конфигурацией проверки подлинности сервера приложений, код состояния 404 может быть вызван несогласованной конфигурацией пути обработчика событий. Одним из способов устранения такой ошибки является отправка запроса на защиту от злоупотреблений в URL-адрес настроенного обработчика событий, чтобы узнать, работает ли это, например, с помощью curl команды для отправки запроса на защиту от злоупотреблений НА URL-адрес https://abc.web.com/eventhandler обработчика событий, как показано ниже:

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

Команда должна возвращать 204.

Следующие шаги

Используйте эти ресурсы для начала создания собственного приложения: