Condividi tramite


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.

Prerequisiti

  • Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
  • Se sei nuovo a Griglia di eventi, leggi la Panoramica di Griglia di eventi prima di iniziare.
  • 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 namespace in Azure Event Grid è un contenitore logico per uno o più argomenti, client, gruppi client, spazi di argomenti e associazioni di autorizzazioni. Con Azure Event Grid, è possibile raggruppare le risorse correlate e gestirle come singola unità nel vostro abbonamento di Azure. Uno spazio dei nomi univoco consente di avere più risorse nella stessa area di Azure.

Per creare uno spazio dei nomi:

  1. Accedi al portale di Azure.

  2. Nella casella di ricerca, immettere Spazi dei nomi di Event Grid e selezionare Spazi dei nomi di Event Grid 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.

    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 nell'ambito della quale 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 la posizione per lo spazio dei nomi.

    5. Selezionare Rivedi e crea.

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

  5. Nella scheda Rivedi e crea esaminare le impostazioni. Successivamente, seleziona Crea.

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

Creare un argomento per lo 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 Spazio dei nomi di Event Grid, in gestore eventi, selezionare Argomenti.

  3. Nella pagina Argomenti selezionare + Argomento.

    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, nella sezione Impostazioni, selezionare Identità.

  2. Per abilitare un'identità gestita assegnata dal sistema, selezionare .

  3. Selezionare Salva 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 .

  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.

    Verifica le notifiche nel portale di Azure per confermare che l'identità gestita sia abilitata per lo specifico 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 , in Impostazioni selezionare Configurazione.

  2. Selezionare Abilita broker MQTT.

  3. Selezionare Applica.

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

    Controllare le notifiche nel portale di Azure 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 hub eventi. Per creare uno spazio dei nomi nel gruppo di risorse usando il portale, procedere come segue:

  1. Nel portale di Azure selezionare Tutti i servizi dal menu a comparsa. Nella pagina Tutti i servizi cercare e selezionare Hub eventi.

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

  2. Nella pagina Hub eventi selezionare Crea.

    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 un'area di Azure per lo spazio dei nomi.

    5. Per il piano tariffario scegliere Basic.

      Annotazioni

      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 invariate le unità di throughput (per il livello standard) o le unità di elaborazione (per il livello premium). Per informazioni sulle unità di throughput o sulle unità di elaborazione, vedere Scalabilità di Event Hubs.

    7. Selezionare Verifica e crea.

      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.

    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 Event Hubs, seleziona Controllo di accesso (IAM).

  2. Nella pagina Controllo di accesso selezionare + Aggiungi e quindi selezionare Aggiungi assegnazione di ruolo.

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

  3. Nell'elenco dei ruoli della pagina Aggiungi assegnazione di ruolo selezionare Mittente dati di Hub eventi di Azure e quindi selezionare Avanti.

    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. Seleziona la tua 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. Scegli Seleziona.

      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.

  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 di Griglia di eventi selezionare Argomenti.

  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.

    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. Nella pagina 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 Event Hub nello spazio dei nomi di Event Hubs.

      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. Fare clic su Crea.

      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, nella sezione broker MQTT, selezionare Routing.

  3. Nella pagina Routing selezionare Abilita routing.

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

  5. In Argomento, selezionare il topic dello spazio dei nomi di Event Grid che avete creato, in cui vengono 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 descritti in questa 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 ulteriori informazioni, vedere Elaborare i dati dall'hub eventi usando Azure Stream Analytics. È possibile visualizzare i messaggi MQTT nella query.

Screenshot che mostra i dati dei messaggi MQTT in Event Hubs utilizzando lo strumento di query di Stream Analytics.

Passo successivo

Per gli esempi di codice, passare al repository GitHub MqttApplicationSamples.