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

  • Articolo

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 alla procedura descritta in Registrare il provider di risorse di Griglia di eventi.
  • Assicurarsi che la porta 8883 sia aperta nel firewall. L'esempio in questa esercitazione usa il protocollo MQTT, che comunica sulla 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 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 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 nei 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 si vuole creare lo spazio dei nomi.

    2. Selezionare un gruppo di risorse esistente o creare un gruppo di risorse.

    3. Immettere un nome per lo spazio dei nomi.

    4. Selezionare l'area o la località 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 completata selezionare Vai alla risorsa per passare allo spazio dei nomi.

Creare un argomento dello spazio dei nomi

  1. Se non si è nella pagina Spazio dei nomi di Griglia di eventi, seguire i passaggi per creare, visualizzare e gestire gli spazi dei nomi per visualizzare lo spazio dei nomi da usare per creare l'argomento.

  2. Nella pagina Spazio dei nomi griglia di eventi selezionare l'opzione Argomenti nella sezione Eventi nel menu a sinistra.

  3. Nella pagina Argomenti selezionare il pulsante + Argomento sulla 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 nozioni di base sulla creazione degli argomenti 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 l'impostazione.

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

  4. Nel messaggio di conferma selezionare Sì.

  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 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. Nella portale di Azure selezionare Tutti i servizi nel menu a sinistra e selezionare star (*) accanto a Hub eventi nella categoria Analisi. 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 in PREFERITI nel menu di spostamento a sinistra e selezionare 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. Scegliere Basic per il piano tariffario. Se si prevede di usare lo spazio dei nomi delle 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 Premium e Hub eventi dedicati .

    6. Lasciare invariate le unità elaborate (per il livello Standard) o le unità di elaborazione (per il livello Premium). Per informazioni sulle unità elaborate o sulle unità di elaborazione: scalabilità di Hub eventi.

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

      Screenshot della pagina Crea spazio dei nomi nella 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 nella 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 sulla barra dei comandi.

  2. Digitare un nome per l'hub eventi, 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 di 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 sulla 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 Hub eventi di Azure Mittente dati dall'elenco dei ruoli e quindi selezionare Avanti nella parte inferiore della pagina.

    Screenshot che mostra la pagina Aggiungi assegnazione di ruolo con Hub eventi di Azure Mittente dati selezionato.

  4. Nella pagina Membri seguire questa procedura:

    1. Per il campo Assegna accesso a selezionare Identità gestita.

    2. Scegliere + Seleziona membri.

      Screenshot che mostra la pagina Aggiungi assegnazione di ruolo con l'opzione 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 nella parte inferiore della pagina.

  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 seguire questa procedura:

    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 Select Event Hub (Seleziona hub eventi) seguire questa procedura:

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

      2. Selezionare il gruppo di risorse con l'hub eventi.

      3. Selezionare lo spazio dei nomi di Hub eventi.

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

      5. Selezionare quindi Conferma selezione.

        Screenshot che mostra la pagina Seleziona hub eventi.

    6. Nella pagina Crea sottoscrizione selezionare Assegnata dal sistema per 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 griglia di eventi selezionando lo spazio dei nomi nella sezione Informazioni di base della pagina Argomento dello spazio dei nomi di Griglia di eventi o selezionando il nome dello spazio dei nomi nel menu di navigazione nella parte superiore.

  2. Nella pagina Spazio dei nomi 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 Spazio dei nomi argomento.

  5. In Argomento selezionare l'argomento dello spazio dei nomi di 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. È possibile creare il secondo client se si vuole, ma è facoltativo.

  2. Creare uno spazio degli 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 nella 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.