Samouczek: kierowanie komunikatów MQTT do usługi Azure Event Hubs (Azure Portal) przy użyciu tematów przestrzeni nazw

  • Artykuł

Z tego samouczka dowiesz się, jak używać tematu przestrzeni nazw do kierowania danych z klientów MQTT do usługi Azure Event Hubs. Poniżej przedstawiono ogólne kroki:

Wymagania wstępne

  • Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
  • Jeśli dopiero zaczynasz korzystać z usługi Event Grid, zapoznaj się z omówieniem usługi Event Grid przed rozpoczęciem tego samouczka.
  • Zarejestruj dostawcę zasobów usługi Event Grid zgodnie z krokami w temacie Rejestrowanie dostawcy zasobów usługi Event Grid.
  • Upewnij się, że port 8883 jest otwarty w zaporze. Przykład w tym samouczku używa protokołu MQTT, który komunikuje się za pośrednictwem portu 8883. Ten port może zostać zablokowany w niektórych środowiskach sieci firmowych i edukacyjnych.

Tworzenie przestrzeni nazw w witrynie Azure Portal

Przestrzeń nazw w usłudze Azure Event Grid jest kontenerem logicznym dla co najmniej jednego tematu, klientów, grup klientów, przestrzeni tematów i powiązań uprawnień. Zapewnia on unikatową przestrzeń nazw, umożliwiając posiadanie wielu zasobów w tym samym regionie świadczenia usługi Azure. Dzięki przestrzeni nazw usługi Azure Event Grid możesz teraz grupować powiązane zasoby i zarządzać nimi jako pojedynczą jednostką w ramach subskrypcji platformy Azure.

Postępuj zgodnie z kolejnymi sekcjami, aby utworzyć przestrzeń nazw usługi Azure Event Grid i zarządzać nią.

Aby utworzyć przestrzeń nazw:

  1. Zaloguj się w witrynie Azure Portal.

  2. W polu wyszukiwania wpisz Event Grid Namespaces (Przestrzenie nazw usługi Event Grid) i wybierz pozycję Event Grid Namespaces (Przestrzenie nazw usługi Event Grid) z wyników.

    Zrzut ekranu przedstawiający przestrzenie nazw usługi Event Grid w wynikach wyszukiwania.

  3. Na stronie Przestrzenie nazw usługi Event Grid wybierz pozycję + Utwórz na pasku narzędzi.

    Zrzut ekranu przedstawiający stronę Przestrzenie nazw usługi Event Grid z wybranym przyciskiem Utwórz na pasku narzędzi.

  4. Na stronie Podstawy wykonaj następujące kroki.

    1. Wybierz subskrypcję platformy Azure, w której chcesz utworzyć przestrzeń nazw.

    2. Wybierz istniejącą grupę zasobów lub utwórz grupę zasobów.

    3. Wprowadź nazwę przestrzeni nazw.

    4. Wybierz region lub lokalizację , w której chcesz utworzyć przestrzeń nazw.

    5. Wybierz pozycję Przejrzyj i utwórz w dolnej części strony.

      Zrzut ekranu przedstawiający kartę Podstawowe na stronie Tworzenie przestrzeni nazw.

  5. Na karcie Przeglądanie + tworzenie przejrzyj ustawienia i wybierz pozycję Utwórz.

  6. Na stronie Wdrożenie powiodło się wybierz pozycję Przejdź do zasobu, aby przejść do przestrzeni nazw.

Tworzenie tematu przestrzeni nazw

  1. Jeśli nie jesteś na stronie Przestrzeni nazw usługi Event Grid, wykonaj kroki tworzenia, wyświetlania przestrzeni nazw i zarządzania nimi, aby wyświetlić przestrzeń nazw , której chcesz użyć do utworzenia tematu.

  2. Na stronie Przestrzeń nazw usługi Event Grid wybierz opcję Tematy w sekcji Eventing w menu po lewej stronie.

  3. Na stronie Tematy wybierz przycisk + Temat na pasku poleceń.

    Zrzut ekranu przedstawiający tworzenie tematu przestrzeni nazw usługi Event Grid.

  4. Na stronie Tworzenie tematu wpisz nazwę tematu, który chcesz utworzyć, a następnie wybierz pozycję Utwórz.

    Zrzut ekranu przedstawiający podstawy tworzenia tematu przestrzeni nazw usługi Event Grid.

Włączanie tożsamości zarządzanej dla przestrzeni nazw usługi Event Grid

  1. Na stronie Przestrzeń nazw usługi Event Grid wybierz pozycję Tożsamość w obszarze Ustawienia w menu po lewej stronie.

  2. Włącz przełącznik, aby włączyć tożsamość zarządzaną przypisaną przez system.

  3. Wybierz pozycję Zapisz na pasku narzędzi, aby zapisać ustawienie.

    Zrzut ekranu przedstawiający stronę tożsamości przypisanej przez system dla przestrzeni nazw usługi Event Grid.

  4. Wybierz pozycję Tak w komunikacie potwierdzającym.

  5. Upewnij się, że widzisz identyfikator obiektu tożsamości zarządzanej przypisanej przez system i zobacz link do przypisywania ról.

    Zrzut ekranu przedstawiający ukończenie przypisywania tożsamości do przestrzeni nazw.

    Sprawdź powiadomienia w portalu, aby potwierdzić, że tożsamość zarządzana jest włączona dla przestrzeni nazw.

Włączanie brokera MQTT dla przestrzeni nazw usługi Event Grid

  1. Na stronie Przestrzeń nazw usługi Event Grid wybierz pozycję Konfiguracja w obszarze Ustawienia w menu po lewej stronie.

  2. Zaznacz pole wyboru obok pozycji Włącz brokera MQTT.

  3. Wybierz pozycję Zastosuj w dolnej części strony.

    Zrzut ekranu przedstawiający stronę konfiguracji przestrzeni nazw usługi Event Grid w celu włączenia protokołu MQTT.

    Sprawdź powiadomienia w portalu, aby potwierdzić, że broker MQTT jest włączony dla przestrzeni nazw.

Na osobnej karcie przeglądarki internetowej lub w osobnym oknie użyj witryny Azure Portal, aby utworzyć przestrzeń nazw usługi Event Hubs z centrum zdarzeń.

Tworzenie przestrzeni nazw usługi Event Hubs

Przestrzeń nazw usługi Event Hubs udostępnia unikatowy kontener określania zakresu, w którym tworzysz co najmniej jedno centrum zdarzeń. Aby utworzyć przestrzeń nazw w grupie zasobów przy użyciu portalu, wykonaj następujące akcje:

  1. W witrynie Azure Portal wybierz pozycję Wszystkie usługi w menu po lewej stronie, a następnie wybierz gwiazdkę (*) obok pozycji Event Hubs w kategorii Analiza. Upewnij się, że usługa Event Hubs została dodana do kategorii ULUBIONE w menu nawigacji po lewej stronie.

    Zrzut ekranu przedstawiający wybór usługi Event Hubs na stronie Wszystkie usługi.

  2. Wybierz pozycję Event Hubs w obszarze ULUBIONE w menu nawigacyjnym po lewej stronie, a następnie wybierz pozycję Utwórz na pasku narzędzi.

    Zrzut ekranu przedstawiający wybór przycisku Utwórz na stronie Centrum zdarzeń.

  3. Na stronie Tworzenie przestrzeni nazw wykonaj następujące czynności:

    1. Wybierz subskrypcję, w ramach której chcesz utworzyć przestrzeń nazw.

    2. Wybierz grupę zasobów utworzoną w poprzednim kroku.

    3. Wprowadź nazwę przestrzeni nazw. System od razu sprawdza, czy nazwa jest dostępna.

    4. Wybierz lokalizację dla przestrzeni nazw.

    5. Wybierz pozycję Podstawowa dla warstwy cenowej. Jeśli planujesz używać przestrzeni nazw z aplikacji platformy Apache Kafka , użyj warstwy Standardowa . Warstwa podstawowa nie obsługuje obciążeń platformy Apache Kafka. Aby dowiedzieć się więcej o różnicach między warstwami, zobacz Artykuły Limity przydziału i limity, Usługa Event Hubs Premium i Usługa Event Hubs w wersji dedykowanej .

    6. Pozostaw ustawienia jednostek przepływności (dla warstwy Standardowa) lub jednostek przetwarzania (dla warstwy Premium). Aby dowiedzieć się więcej o jednostkach przepływności lub jednostkach przetwarzania: skalowalność usługi Event Hubs.

    7. Wybierz pozycję Przejrzyj i utwórz w dolnej części strony.

      Zrzut ekranu przedstawiający stronę Tworzenie przestrzeni nazw w witrynie Azure Portal.

    8. Na stronie Przeglądanie + tworzenie przejrzyj ustawienia i wybierz pozycję Utwórz. Zaczekaj na zakończenie wdrażania.

  4. Na stronie Wdrażanie wybierz pozycję Przejdź do zasobu, aby przejść do strony przestrzeni nazw.

    Zrzut ekranu przedstawiający stronę Ukończone wdrożenie z linkiem do zasobu.

  5. Upewnij się, że zostanie wyświetlona strona Przestrzeń nazw usługi Event Hubs podobna do następującego przykładu:

    Zrzut ekranu przedstawiający stronę główną przestrzeni nazw usługi Event Hubs w witrynie Azure Portal.

Tworzenie centrum zdarzeń

Aby utworzyć centrum zdarzeń w przestrzeni nazw, wykonaj następujące akcje:

  1. Na stronie Przegląd wybierz pozycję + Centrum zdarzeń na pasku poleceń.

    Zrzut ekranu przedstawiający wybór przycisku Dodaj centrum zdarzeń na pasku poleceń.

  2. Wpisz nazwę centrum zdarzeń, a następnie wybierz pozycję Przejrzyj i utwórz.

    Zrzut ekranu przedstawiający stronę Tworzenie centrum zdarzeń.

  3. Na stronie Przeglądanie i tworzenie wybierz pozycję Utwórz.

  4. Możesz sprawdzić stan tworzenia centrum zdarzeń w alertach. Po utworzeniu centrum zdarzeń zobaczysz go na liście centrów zdarzeń.

    Zrzut ekranu przedstawiający listę centrów zdarzeń.

Nadawanie przestrzeni nazw usługi Event Grid dostępu do wysyłania zdarzeń do centrum zdarzeń

  1. Na stronie Przestrzeń nazw usługi Event Hubs wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami) w menu po lewej stronie.

  2. Na stronie Kontrola dostępu wybierz pozycję + Dodaj na pasku poleceń, a następnie wybierz pozycję Dodaj przypisanie roli.

    Zrzut ekranu przedstawiający stronę Kontrola dostępu dla przestrzeni nazw usługi Event Hubs.

  3. Na stronie Dodawanie przypisania roli wybierz pozycję Nadawca danych usługi Azure Event Hubs z listy ról, a następnie wybierz pozycję Dalej w dolnej części strony.

    Zrzut ekranu przedstawiający stronę Dodawanie przypisania roli z wybraną pozycją Nadawca danych usługi Azure Event Hubs.

  4. Na stronie Członkowie wykonaj następujące kroki:

    1. W polu Przypisz dostęp do wybierz pozycję Tożsamość zarządzana.

    2. Wybierz pozycję + Wybierz członków.

      Zrzut ekranu przedstawiający stronę Dodawanie przypisania roli z wybraną tożsamością zarządzaną.

  5. Na stronie Wybieranie tożsamości zarządzanych wykonaj następujące kroki:

    1. Wybierz swoją subskrypcję platformy Azure.

    2. W polu Tożsamość zarządzana wybierz pozycję Przestrzeń nazw usługi Event Grid.

    3. Wybierz tożsamość zarządzaną o tej samej nazwie co przestrzeń nazw usługi Event Grid.

    4. Wybierz pozycję Wybierz w dolnej części strony.

      Zrzut ekranu przedstawiający stronę Wybieranie tożsamości zarządzanych z wybraną tożsamością zarządzaną przestrzeni nazw usługi Event Grid.

  6. Na stronie Dodawanie przypisania roli wybierz pozycję Przejrzyj i przypisz w dolnej części strony.

  7. Na stronie Przeglądanie i przypisywanie wybierz pozycję Przejrzyj i przypisz.

Tworzenie subskrypcji zdarzeń za pomocą usługi Event Hubs jako punktu końcowego

  1. Przejdź do karty okna przeglądarki sieci Web z otwartą przestrzenią nazw usługi Event Grid.

  2. Na stronie Przestrzeń nazw usługi Event Grid wybierz pozycję Tematy w menu po lewej stronie.

  3. Na stronie Tematy wybierz utworzony wcześniej temat przestrzeni nazw.

    Zrzut ekranu przedstawiający stronę Tematy z wybranym tematem przestrzeni nazw.

  4. Na stronie Temat przestrzeni nazw usługi Event Grid wybierz pozycję + Subskrypcja na pasku poleceń u góry.

    Zrzut ekranu przedstawiający stronę Subskrypcje.

  5. Na stronie Tworzenie subskrypcji wykonaj następujące kroki:

    1. Wprowadź nazwę subskrypcji zdarzeń.

    2. W obszarze Tryb dostarczania wybierz pozycję Wypychanie.

    3. Upewnij się, że typ punktu końcowego jest ustawiony na Centrum zdarzeń.

    4. Wybierz pozycję Konfiguruj punkt końcowy.

      Zrzut ekranu przedstawiający stronę Tworzenie subskrypcji.

    5. W obszarze Wybierz centrum zdarzeń wykonaj następujące kroki:

      1. Wybierz subskrypcję platformy Azure, która ma centrum zdarzeń.

      2. Wybierz grupę zasobów, która ma centrum zdarzeń.

      3. Wybierz przestrzeń nazw usługi Event Hubs.

      4. Wybierz centrum zdarzeń w przestrzeni nazw usługi Event Hubs.

      5. Następnie wybierz pozycję Potwierdź wybór.

        Zrzut ekranu przedstawiający stronę Wybieranie centrum zdarzeń.

    6. Na stronie Tworzenie subskrypcji wybierz pozycję Przypisane przez system dla typu tożsamości zarządzanej.

    7. Wybierz pozycję Utwórz w dolnej części strony.

      Zrzut ekranu przedstawiający stronę Utwórz subskrypcję z wybranym przyciskiem Utwórz.

Konfigurowanie routingu w przestrzeni nazw usługi Event Grid

  1. Wróć do strony Przestrzeń nazw usługi Event Grid, wybierając przestrzeń nazw w sekcji Podstawy strony Temat przestrzeni nazw usługi Event Grid lub wybierając nazwę przestrzeni nazw w menu nadrzędnym u góry strony.

  2. Na stronie Przestrzeń nazw usługi Event Grid wybierz pozycję Routing w menu po lewej stronie w sekcji Broker MQTT.

  3. Na stronie Routing wybierz pozycję Włącz routing.

  4. W polu Typ tematu wybierz pozycję Temat przestrzeni nazw.

  5. W obszarze Temat wybierz temat przestrzeni nazw usługi Event Grid, który został utworzony, w którym będą kierowane wszystkie komunikaty MQTT.

  6. Wybierz Zastosuj.

    Zrzut ekranu przedstawiający stronę Routing z wybranym tematem przestrzeni nazw.

    Sprawdź powiadomienia, aby potwierdzić, że przestrzeń nazw jest włączona z informacjami o routingu.

Tworzenie klientów, obszaru tematu i powiązań uprawnień

Wykonaj kroki opisane w przewodniku Szybki start: Publikowanie i subskrybowanie tematu MQTT w celu:

  1. Utwórz klienta. Możesz utworzyć drugiego klienta, jeśli chcesz, ale jest to opcjonalne.

  2. Utwórz przestrzeń tematu.

  3. Tworzenie powiązań uprawnień wydawcy i subskrybenta.

  4. Użyj MQTTX, aby wysłać kilka komunikatów.

  5. Sprawdź, czy centrum zdarzeń odebrało te komunikaty na stronie Przegląd dla przestrzeni nazw usługi Event Hubs.

    Zrzut ekranu przedstawiający stronę Przegląd centrum zdarzeń z liczbą komunikatów przychodzących.

Wyświetlanie kierowanych komunikatów MQTT w usłudze Event Hubs przy użyciu zapytania usługi Stream Analytics

Przejdź do wystąpienia usługi Event Hubs (centrum zdarzeń) w ramach subskrypcji zdarzeń w witrynie Azure Portal. Przetwarzanie danych z centrum zdarzeń przy użyciu usługi Stream Analytics. Aby uzyskać więcej informacji, zobacz Przetwarzanie danych z usługi Azure Event Hubs przy użyciu usługi Stream Analytics — Azure Event Hubs | Microsoft Learn. Komunikaty MQTT są widoczne w zapytaniu.

Zrzut ekranu przedstawiający dane komunikatów MQTT w usłudze Event Hubs przy użyciu narzędzia zapytań usługi Stream Analytics.

Następne kroki

Aby uzyskać przykłady kodu, przejdź do tego repozytorium GitHub.