Esercitazione: Usare gli argomenti dello spazio dei nomi per instradare i messaggi MQTT a Hub eventi di Azure (portale di Azure)

In questa esercitazione si apprenderà come usare un argomento dello spazio dei nomi per instradare i dati dai client MQTT a Hub eventi di Azure. Ecco i passaggi principali:

Prerequisiti

  • Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
  • Se non si ha familiarità con Griglia di eventi, leggere la panoramica di Griglia di eventi prima di iniziare questa esercitazione.
  • Registrare il provider di risorse di Griglia di eventi in base ai passaggi descritti in Registrare il provider di risorse di Griglia di eventi.
  • Assicurarsi che la porta 8883 sia aperta nel firewall. L'esempio di questa esercitazione usa il protocollo MQTT, che comunica tramite la porta 8883. Questa porta potrebbe essere bloccata in alcuni ambienti di rete aziendali e didattici.

Creare uno spazio dei nomi nel portale di Azure

Uno spazio dei nomi in Griglia di eventi di Azure è un contenitore logico per uno o più argomenti, client, gruppi client, spazi di argomenti e associazioni di autorizzazioni. Fornisce uno spazio dei nomi univoco, consentendo di avere più risorse nella stessa area di Azure. Con uno spazio dei nomi di Griglia di eventi di Azure è ora possibile raggruppare le risorse correlate e gestirle come singola unità nella sottoscrizione di Azure.

Seguire le sezioni successive per creare, visualizzare e gestire uno spazio dei nomi di Griglia di eventi di Azure.

Per creare uno spazio dei nomi:

  1. Accedere al portale di Azure.

  2. Nella casella di ricerca immettere Spazi dei nomi di Griglia di eventi e selezionare Spazi dei nomi di Griglia di eventi dai risultati.

    Screenshot che mostra gli spazi dei nomi di Griglia di eventi nei risultati della ricerca.

  3. Nella pagina Spazi dei nomi di Griglia di eventi, selezionare + Crea sulla barra degli strumenti.

    Screenshot che mostra la pagina Spazi dei nomi di Griglia di eventi con il pulsante Crea sulla barra degli strumenti selezionata.

  4. Nella pagina Informazioni di base seguire questa procedura.

    1. Selezionare la sottoscrizione di Azure in cui creare lo spazio dei nomi.

    2. Selezionare un gruppo di risorse esistente o crearne uno.

    3. Immettere un nome per lo spazio dei nomi.

    4. Selezionare l'area o l'ubicazione in cui si vuole creare lo spazio dei nomi.

    5. Selezionare Rivedi e crea nella parte inferiore della pagina.

      Screenshot che mostra la scheda Informazioni di base della pagina Crea spazio dei nomi.

  5. Nella scheda Rivedi e crea esaminare le impostazioni e selezionare Crea.

  6. Nella pagina Distribuzione riuscita selezionare Vai alla risorsa per passare allo spazio dei nomi.

Creare un argomento dello spazio dei nomi

  1. Se non ci si trova nella pagina Spazio dei nomi di Griglia di eventi, seguire la procedura Creare, visualizzare e gestire gli spazi dei nomi per visualizzare lo spazio dei nomi da usare per creare l'argomento.

  2. Nella pagina griglia di eventi Namespace selezionare l'opzione Argomenti nella sezione Gestore eventi nel menu a sinistra.

  3. Nella pagina Argomenti selezionare + Argomento nella barra dei comandi.

    Screenshot che mostra la creazione di argomenti dello spazio dei nomi di Griglia di eventi.

  4. Nella pagina Crea argomento digitare il nome dell'argomento da creare e selezionare Crea.

    Screenshot che mostra le informazioni di base per la creazione di argomenti dello spazio dei nomi di Griglia di eventi.

Abilitare l'identità gestita per lo spazio dei nomi di Griglia di eventi

  1. Nella pagina Spazio dei nomi di Griglia di eventi, selezionare Identità in Impostazioni nel menu a sinistra.

  2. Attivare l'opzione per abilitare un'identità gestita assegnata dal sistema.

  3. Selezionare Salva sulla barra degli strumenti per salvare le impostazioni.

    Screenshot di una pagina di identità assegnata dal sistema per uno spazio dei nomi di Griglia di eventi.

  4. Nel messaggio di conferma selezionare .

  5. Verificare di visualizzare l'ID oggetto dell'identità gestita assegnata dal sistema e visualizzare un collegamento per assegnare i ruoli.

    Screenshot che mostra il completamento dell'assegnazione dell'identità a uno spazio dei nomi.

    Controllare le notifiche nel portale per verificare che l'identità gestita sia abilitata per lo spazio dei nomi.

Abilitare il broker MQTT per lo spazio dei nomi di Griglia di eventi

  1. Nella pagina Spazio dei nomi di Griglia di eventi, selezionare Configurazione in Impostazioni nel menu a sinistra.

  2. Selezionare la casella di controllo accanto a Abilita broker MQTT.

  3. Selezionare Applica nella parte inferiore della pagina.

    Screenshot che mostra la pagina di configurazione dello spazio dei nomi di Griglia di eventi per abilitare MQTT.

    Controllare le notifiche nel portale per verificare che il broker MQTT sia abilitato per lo spazio dei nomi.

In una scheda separata del Web browser o in una finestra separata usare il portale di Azure per creare uno spazio dei nomi di Hub eventi con un hub eventi.

Creare uno spazio dei nomi di Hub eventi

Uno spazio dei nomi di Hub eventi fornisce un contenitore con ambito univoco in cui creare uno o più hub eventi. Per creare uno spazio dei nomi nel gruppo di risorse usando il portale, eseguire le azioni seguenti:

  1. Nel portale di Azure selezionare Tutti i servizi nel menu a sinistra e scegliere la stella (*) accanto a Hub eventi nella categoria Analytics. Verificare che Hub eventi venga aggiunto a PREFERITI nel menu di spostamento a sinistra.

    Screenshot che mostra la selezione di Hub eventi nella pagina Tutti i servizi.

  2. Selezionare Hub eventi sotto PREFERITI nel menu di spostamento a sinistra e scegliere Crea sulla barra degli strumenti.

    Screenshot che mostra la selezione del pulsante Crea nella pagina Hub eventi.

  3. Nella pagina Crea spazio dei nomi seguire questa procedura:

    1. Selezionare la sottoscrizione in cui creare lo spazio dei nomi.

    2. Selezionare il gruppo di risorse creato nel passaggio precedente.

    3. Immettere un nome per lo spazio dei nomi. Verrà effettuato immediatamente un controllo sulla disponibilità del nome.

    4. Selezionare una località per lo spazio dei nomi.

    5. Selezionare Basic come piano tariffario. Se si prevede di usare lo spazio dei nomi di app Apache Kafka, usare il livello Standard. Il livello Basic non supporta i carichi di lavoro Apache Kafka. Per informazioni sulle differenze tra i livelli, vedere gli articoli Quote e limiti, Hub eventi Premiume Hub eventi Dedicato.

    6. Lasciare le unità di velocità effettiva (per il livello Standard) o unità di elaborazione (per il livello Premium) così come sono. Per altre informazioni sulle unità di velocità effettiva o di elaborazione, vedere Scalabilità di Hub eventi.

    7. Selezionare Rivedi e crea nella parte inferiore della pagina.

      Screenshot della pagina Crea spazio dei nomi nel portale di Azure.

    8. Nella pagina Rivedi e crea controllare le impostazioni e selezionare Crea. Attendere il completamento della distribuzione.

  4. Nella pagina Distribuzione selezionare Vai alla risorsa per passare alla pagina relativa allo spazio dei nomi.

    Screenshot della pagina Distribuzione completa con il collegamento alla risorsa.

  5. Verificare che la pagina the Spazio dei nomi di Hub eventi sia simile all'esempio seguente:

    Screenshot della home page per lo spazio dei nomi di Hub eventi nel portale di Azure.

Creare un hub eventi

Per creare un hub eventi all'interno dello spazio dei nomi, eseguire le azioni seguenti:

  1. Nella pagina Panoramica, selezionare + Hub eventi sulla barra dei comandi.

    Screenshot della selezione del pulsante Aggiungi hub eventi nella barra dei comandi.

  2. Digitare un nome per l'hub eventi e quindi selezionare Rivedi e crea.

    Screenshot della pagina Crea hub eventi.

  3. Nella pagina Rivedi e crea selezionare Crea.

  4. È possibile controllare lo stato della creazione dell'hub eventi negli avvisi. Dopo aver creato l'hub eventi, è possibile vederlo nell'elenco corrispondente.

    Screenshot che mostra l'elenco degli hub eventi.

Concedere allo spazio dei nomi di Griglia di eventi l'accesso per inviare eventi all'hub eventi

  1. Nella pagina Spazio dei nomi di Hub eventi, selezionare Controllo di accesso (IAM) nel menu a sinistra.

  2. Nella pagina Controllo di accesso selezionare + Aggiungi nella barra dei comandi e quindi selezionare Aggiungi assegnazione di ruolo.

    Screenshot che mostra la pagina Controllo di accesso per lo spazio dei nomi di Hub eventi.

  3. Nella pagina Aggiungi assegnazione di ruolo selezionare Mittente dati di Hub eventi di Azure dall'elenco dei ruoli e quindi selezionare Avanti nella parte inferiore della pagina.

    Screenshot che mostra la pagina Aggiungi assegnazione di ruolo con l'opzione Mittente dati di Hub eventi di Azure selezionata.

  4. Nella pagina Membri seguire questa procedura:

    1. Nel campo Assegna accesso a selezionare Identità gestita.

    2. Scegliere + Seleziona membri.

      Screenshot che mostra la pagina Aggiungi assegnazione di ruolo con l'identità gestita selezionata.

  5. Alla pagina Selezionare identità gestite, seguire questi passaggi:

    1. Selezionare la sottoscrizione di Azure.

    2. Per Identità gestita, selezionare Spazio dei nomi di Griglia di eventi.

    3. Selezionare l'identità gestita con lo stesso nome dello spazio dei nomi di Griglia di eventi.

    4. Scegliere Seleziona nella parte inferiore della pagina.

      Screenshot che mostra la pagina Seleziona identità gestite con l'identità gestita dello spazio dei nomi di Griglia di eventi selezionata.

  6. Nella pagina Aggiungi assegnazione di ruolo, selezionare Rivedi e assegna in fondo.

  7. Nella pagina Rivedi + assegna, selezionare Rivedi + assegna.

Creare una sottoscrizione di eventi con Hub eventi come endpoint

  1. Passare alla scheda della finestra del Web browser con lo spazio dei nomi Griglia di eventi aperto.

  2. Nella pagina Spazio dei nomi Griglia di eventi, selezionare Argomenti nel menu a sinistra.

  3. Nella pagina Argomenti selezionare l'argomento dello spazio dei nomi creato in precedenza.

    Screenshot che mostra la pagina Argomenti con l'argomento dello spazio dei nomi selezionato.

  4. Nella pagina Argomento dello spazio dei nomi di Griglia di eventi selezionare + Sottoscrizione nella barra dei comandi nella parte superiore.

    Screenshot che mostra la pagina Sottoscrizioni.

  5. Nella pagina Crea sottoscrizione procedere come segue:

    1. Immettere un nome per la sottoscrizione di eventi.

    2. Per Modalità di recapito, selezionare Push.

    3. Verificare che Tipo di endpoint sia impostato su Hub eventi.

    4. Selezionare Configura un endpoint.

      Screenshot che mostra la pagina Crea sottoscrizione.

    5. In Seleziona hub eventi, seguire questa procedura:

      1. Selezionare la sottoscrizione di Azure con l'hub eventi.

      2. Selezionare il gruppo di risorse che contiene l'hub eventi.

      3. Selezionare lo spazio dei nomi di Hub eventi.

      4. Selezionare l'hub eventi nello spazio dei nomi Hub eventi.

      5. Quindi, selezionare Conferma selezione.

        Screenshot che mostra la pagina Seleziona hub eventi.

    6. Nella pagina Crea sottoscrizione. selezionare Assegnata dal sistema come Tipo di identità gestita.

    7. Selezionare Crea nella parte inferiore della pagina.

      Screenshot che mostra la pagina Crea sottoscrizione con il pulsante Crea selezionato.

Configurare il routing nello spazio dei nomi di Griglia di eventi

  1. Tornare alla pagina Spazio dei nomi di Griglia di eventi selezionando lo spazio dei nomi nella sezione Informazioni essenziali della pagina Argomento dello spazio dei nomi di Griglia di eventi oppure selezionando il nome dello spazio dei nomi nel menu di navigazione nella parte superiore.

  2. Nella pagina Spazio dei nomi di Griglia di eventi selezionare Routing nel menu a sinistra nella sezione Broker MQTT.

  3. Nella pagina Routing selezionare Abilita routing.

  4. Per Tipo di argomento, selezionare argomento Spazio dei nomi.

  5. Per Argomentoselezionare l'argomento dello spazio dei nomi Griglia di eventi creato in cui verranno instradati tutti i messaggi MQTT.

  6. Selezionare Applica.

    Screenshot che mostra la pagina Routing con l'argomento dello spazio dei nomi selezionato.

    Controllare le notifiche per verificare che lo spazio dei nomi sia abilitato con le informazioni di routing.

Creare client, spazi argomenti e associazioni di autorizzazioni

Seguire i passaggi della guida introduttiva: Pubblicare e sottoscrivere un argomento MQTT per:

  1. Creare un client. Se lo si desidera, è possibile creare il secondo client.

  2. Creare uno spazio di argomenti.

  3. Creare associazioni di autorizzazioni per server di pubblicazione e sottoscrittore.

  4. Usare MQTTX per inviare alcuni messaggi.

  5. Verificare che l'hub eventi abbia ricevuto tali messaggi nella pagina Panoramica per lo spazio dei nomi di Hub eventi.

    Screenshot che mostra la pagina Panoramica dell'hub eventi con il conteggio dei messaggi in ingresso.

Visualizzare i messaggi MQTT indirizzati in Hub eventi usando una query di Analisi di flusso

Passare all'istanza di Hub eventi (hub eventi) all'interno della sottoscrizione di eventi nel portale di Azure. Elaborare i dati dall'hub eventi usando Analisi di flusso. Per altre informazioni, vedere Elaborare i dati da Hub eventi di Azure usando Analisi di flusso - Hub eventi di Azure | Microsoft Learn. È possibile visualizzare i messaggi MQTT nella query.

Screenshot che mostra i dati dei messaggi MQTT in Hub eventi usando lo strumento di query di Analisi di flusso.

Passaggi successivi

Per gli esempi di codice, passare a questo repository GitHub.