Руководство. Использование разделов пространства имен для маршрутизации сообщений MQTT в Центры событий Azure (портал Azure)

В этом руководстве описано, как использовать раздел пространства имен для маршрутизации данных из клиентов MQTT в Центры событий Azure.

Необходимые компоненты

• Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.
• Если вы не знакомы с сеткой событий, ознакомьтесь с обзором сетки событий перед началом работы.
• Зарегистрируйте поставщик ресурсов сетки событий в соответствии с инструкциями, описанными в разделе "Регистрация поставщика ресурсов сетки событий".
• Убедитесь, что порт 8883 открыт в брандмауэре. В этом руководстве используется протокол MQTT, который взаимодействует через порт 8883. Этот порт может быть заблокирован в некоторых корпоративных и образовательных сетевых средах.

Создание пространства имен на портале Azure

Пространство имен в Сетке событий Azure — это логический контейнер для одной или нескольких тем, клиентов, групп клиентов, пространств тем и привязок разрешений. С помощью пространства имен Сетки событий Azure можно группировать связанные ресурсы и управлять ими в рамках одной единицы в подписке Azure. Уникальное пространство имен позволяет иметь несколько ресурсов в одном регионе Azure.

Создание пространства имен службы:

1. Войдите на портал Azure.

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

   

3. На странице "Пространства имен сетки событий" нажмите кнопку "+ Создать".

   

4. На странице "Основы" выполните следующие действия.

   1. Выберите подписку Azure, в которой необходимо создать пространство имен.

   2. Выберите существующую группу ресурсов или создайте группу ресурсов.

   3. Введите имя пространства имен.

   4. Выберите расположение пространства имен.

   5. Выберите Review + create.

      

5. На вкладке Рецензирование и создание проверьте параметры. Затем выберите Создать.

6. На странице "Развертывание выполнено успешно" выберите "Перейти к ресурсу", чтобы перейти к пространству имен.

Создание раздела пространства имен

1. Если вы не на странице пространства имен сетки событий, следуйте инструкциям по созданию, просмотру и управлению пространствами имен, чтобы просмотреть пространство имен, которое вы хотите использовать для создания раздела.

2. На странице Пространства имен Сетки событий, в разделе Брокер событий, выберите Топики.

3. На странице "Темы" выберите +Раздел.

   

4. На странице "Создание раздела" введите имя темы, которую вы хотите создать, и нажмите кнопку "Создать".

   

Включение управляемого удостоверения для пространства имен Сетки событий

1. На странице Пространства имен сетки событий в разделе Параметры выберите Удостоверение.

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

3. Нажмите кнопку Сохранить, чтобы сохранить параметры.

   

4. В сообщении подтверждения нажмите кнопку "Да".

5. Подтвердите, что отображаются идентификатор объекта назначенного системой управляемого удостоверения и ссылка для назначения ролей.

   

   Проверьте уведомления на портале Azure, чтобы убедиться, что управляемое удостоверение включено для пространства имен.

Включение брокера MQTT для пространства имен Сетки событий

1. На странице пространства имен сетки событий в разделе "Параметры" выберите "Конфигурация".

2. Выберите "Включить брокер MQTT".

3. Выберите Применить.

   

   Проверьте уведомления на портале Azure, чтобы убедиться, что брокер MQTT включен для пространства имен.

На отдельной вкладке веб-браузера или в отдельном окне используйте портал Azure для создания пространства имен Центров событий с концентратором событий.

Создание пространства имен в Центрах событий Azure

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

1. На портале Azure в всплывающем меню выберите "Все службы". На странице "Все службы" найдите и выберите Центры событий.

   

2. На странице "Центры событий" нажмите кнопку "Создать".

   

3. На странице Создание пространства имен выполните следующие действия.

   1. Выберите подписку, в которой нужно создать пространство имен.

   2. Выберите группу ресурсов , созданную на предыдущем шаге.

   3. Введите имя пространства имен. Система немедленно проверяет, доступно ли оно.

   4. Выберите регион для пространства имен.

   5. Для ценовой категории выберите "Базовый".

      Замечание

      Если вы планируете использовать пространство имен из приложений Apache Kafka, используйте уровень "Стандартный". Базовый уровень не поддерживает рабочие нагрузки Apache Kafka. Чтобы узнать о различиях между уровнями, см. статьи Квоты и ограничения, Центры событий ценовой категории «Премиум» и Специальные центры событий.

   6. Оставьте единицы пропускной способности (для стандартного уровня) или единицы обработки (для уровня "Премиум") как есть. Дополнительные сведения о единицах пропускной способности или единицах обработки см. в статье о масштабируемости Центров событий.

   7. Выберите Review + Create.

      

   8. На странице Просмотр и создание проверьте параметры и нажмите кнопку Создать. Дождитесь завершения развертывания.

4. На странице Развертывание нажмите Перейти к ресурсу, чтобы открыть страницу пространства имен.

   

5. Убедитесь, что отображаемая страница Пространство имен Центров событий имеет похожий на следующий вид:

   

Создание концентратора событий

Чтобы создать концентратор событий в пространстве имен, выполните следующие действия:

1. На странице обзора выберите +Концентратор событий.

   

2. Введите имя концентратора событий, а затем нажмите кнопку "Проверить и создать".

   

3. На странице Отзыв и создание выберите Создать.

4. Вы можете проверить состояние создания концентратора событий в оповещениях. После создания концентратора событий вы увидите его в соответствующем списке.

   

Предоставление пространству имен Сетки событий доступ к отправке событий в концентратор событий

1. На странице пространства имен Event Hubs выберите управление доступом (IAM)

2. На странице управления доступом нажмите кнопку +Добавить, а затем выберите "Добавить назначение ролей".

   

3. На странице "Добавление назначения ролей" в списке ролей выберите "Отправитель данных Центров событий Azure" и нажмите кнопку "Далее".

   

4. На странице "Участники" выполните следующие действия:

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

   2. Выберите и выберите участников.

      

5. На странице "Выбор управляемых удостоверений" выполните следующие действия.

   1. Выберите подписку Azure.

   2. Для управляемого удостоверения выберите пространство имен сетки событий.

   3. Выберите управляемое удостоверение, которое имеет то же имя, что и пространство имен Сетки событий.

   4. Нажмите кнопку "Выбрать".

      

6. На странице "Добавить назначение ролей " нажмите кнопку "Проверить и назначить".

7. На странице "Рецензирование и назначение" выберите "Рецензирование и назначение".

Создание подписки на события с центрами событий в качестве конечной точки

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

2. На странице пространства имен сетки событий выберите разделы.

3. На странице разделов выберите созданный ранее раздел пространства имен.

   

4. На странице «Тема пространства имен сети событий» выберите + Подписка.

   

5. На странице "Создание подписки" выполните следующие действия.

   1. Введите название для подписки на мероприятие.

   2. В режиме доставки нажмите кнопку "Отправить".

   3. Убедитесь, что тип конечной точки установлен на Концентратор событий.

   4. Выберите " Настроить конечную точку".

      

   5. На странице "Выбор концентратора событий " выполните следующие действия:

      1. Выберите подписку Azure, которая имеет концентратор событий.

      2. Выберите группу ресурсов с концентратором событий.

      3. Выберите пространство имен Event Hubs.

      4. Выберите концентратор событий в пространстве имен концентраторов событий.

      5. Затем нажмите кнопку "Подтвердить выбор".

         

   6. Вернитесь на страницу "Создание подписки" , выберите "Назначенная системой" для типа управляемого удостоверения.

   7. Нажмите кнопку "Создать".

      

Настройка маршрутизации в пространстве имен Сетки событий

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

2. На странице пространства имен Event Grid в разделе Брокер MQTT выберите Маршрутизация.

3. На странице "Маршрутизация" выберите "Включить маршрутизацию".

4. Для типа раздела выберите раздел пространства имен.

5. В разделе Тема выберите пространство имен Event Grid, где все сообщения MQTT направляются.

6. Выберите Применить.

   

   Проверьте уведомления, чтобы убедиться, что пространство имен включено с информацией о маршрутизации.

Создание клиентов, пространства разделов и привязок разрешений

Выполните действия, описанные в этом кратком руководстве. Публикация и подписка на раздел MQTT :

1. Создайте клиент. Вы можете создать второй клиент, если вы хотите, но это необязательно.

2. Создайте пространство тем.

3. Создание привязок разрешений издателя и подписчика.

4. Используйте MQTTX для отправки нескольких сообщений.

5. Убедитесь, что концентратор событий получил эти сообщения на странице обзора пространства имен Центров событий.

   

Просмотр перенаправленных сообщений MQTT в Центрах событий с помощью запроса Stream Analytics

Перейдите к экземпляру Центров событий (концентратору событий) в подписке на события на портале Azure. Обработка данных из концентратора событий с помощью Stream Analytics. Дополнительные сведения см. в статье "Обработка данных из концентратора событий с помощью Azure Stream Analytics". В запросе отображаются сообщения MQTT.

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

Для примеров кода перейдите в репозиторий MqttApplicationSamples GitHub.