Come aggiungere un'origine evento hub IoT a un ambiente Time Series InsightsHow to add an IoT Hub event source to Time Series Insights environment

Questo articolo descrive come usare il portale di Azure per aggiungere all'ambiente Time Series Insights un'origine evento che legge dati da un hub IoT.This article describes how to use the Azure portal to add an event source that reads data from an IoT Hub into your Time Series Insights environment.

PrerequisitiPrerequisites

  • Creare un ambiente Time Series InsightsCreate a Time Series Insights environment. Per altre informazioni, vedere Creare un ambiente Azure Time Series Insights.For more information, see Create an Azure Time Series Insights environment
  • Creare un hub IoT.Create an IoT Hub. Per altre informazioni sugli hub IoT, vedere Creare un hub IoT usando il portale di AzureFor more information on IoT Hubs, see Create an IoT Hub using the Azure portal
  • Lo hub IoT deve ricevere eventi messaggio attivi.The IoT Hub needs to have active message events being sent in.
  • Creare un gruppo di consumer dedicato nell'hub IoT per l'utilizzo nell'ambiente Time Series Insights.Create a dedicated consumer group in IoT Hub for the Time Series Insight environment to consume from. Tutte le origini evento Time Series Insights devono avere un proprio gruppo di consumer dedicato che non sia condiviso con altri consumer.Each Time Series Insights event source needs to have its own dedicated consumer group that is not shared with any other consumers. Se più lettori consumano eventi dello stesso gruppo di consumer, è probabile che tutti i lettori riscontrino errori.If multiple readers consume events from the same consumer group, all readers are likely to see failures. Per altre informazioni, vedere la Guida per gli sviluppatori dell'hub IoT.For details, see the IoT Hub developer guide.

Aggiungere una nuova origine eventoAdd a new event source

  1. Accedere al portale di Azure.Sign in to the Azure portal.

  2. Individuare l'ambiente Time Series Insights esistente.Locate your existing Time Series Insights environment. Fare clic su Tutte le risorse nel menu sul lato sinistro del portale di Azure.Click All resources in the menu on the left side of the Azure portal. Selezionare l'ambiente Time Series Insights.Select your Time Series Insights environment.

  3. Sotto l'intestazione Topologia dell'ambiente fare clic su Origini eventi.Under the Environment Topology heading, click Event Sources. + Aggiungi origini eventiEvent Sources + Add

  4. Fare clic su + Aggiungi.Click + Add.

  5. Specificare un Nome dell'origine evento univoco per questo ambiente Time Series Insights, ad esempio event-stream.Provide an Event source name unique to this Time Series Insights environment, such as event-stream.

    Compilare i primi tre parametri del modulo.

  6. Per Origine selezionare Hub IoT.Select the Source as IoT Hub.

  7. Selezionare l'Opzione di importazione appropriata.Select the appropriate Import option.

    • Se per una delle sottoscrizioni disponibili esiste già un hub IoT, scegliere Usare l'hub IoT dalle sottoscrizioni disponibili.Choose Use IoT Hub from available subscriptions when you already have an existing IoT Hub on one of your subscriptions. Questo è l'approccio più semplice.This is the easiest approach.
    • Scegliere Specificare le impostazioni dell'hub IoT manualmente se l'hub IoT è esterno alle sottoscrizioni o si vogliono scegliere opzioni avanzate.Choose Provide IoT Hub settings manually when the IoT Hub is external to your subscriptions, or you wish to choose advanced options.
  8. La tabella seguente illustra le proprietà obbligatorie se si seleziona l'opzione Usare l'hub IoT dalle sottoscrizioni disponibili:If you have selected the Use IoT Hub from available subscriptions option, the following table explains each required property:

    Dettagli hub eventi e sottoscrizione

    ProprietàProperty DescrizioneDescription
    ID sottoscrizioneSubscription ID Selezionare la sottoscrizione in cui l'hub IoT è stato creato.Select the subscription in which this IoT Hub was created.
    Nome dell'hub IoTIoT Hub name Selezionare il nome dell'hub IoT.Select the name of the IoT Hub.
    Nome dei criteri dell'hub IoTIoT Hub policy name Selezionare il criterio di accesso condiviso che si può trovare nella scheda Impostazioni hub IoT. Ogni criterio di accesso condiviso ha un nome, autorizzazioni impostate e chiavi di accesso.Select the shared access policy, which can be found on the IoT Hub settings tab. Each shared access policy has a name, permissions that you set, and access keys. Il criterio di accesso condiviso per l'origine evento deve avere le autorizzazioni per la connessione al servizio.The shared access policy for your event source must have service connect permissions.
    Chiave dei criteri dell'hub IoTIoT Hub policy key La chiave è prepopolata.The key is prepopulated.
    Gruppo consumer dell'hub IoTIoT Hub consumer group Il gruppo di consumer per la lettura degli eventi dall'hub IoT.The consumer group to read events from the IoT Hub. È consigliabile usare un gruppo di consumer dedicato per l'origine evento.It is highly recommended to use a dedicated consumer group for your event source.
    Formato di serializzazione eventiEvent serialization format JSON è l'unico formato di serializzazione attualmente disponibile.JSON is the only available serialization at present. I messaggi relativi agli eventi devono essere in questo formato. In caso contrario, non è possibile leggere i dati.The event messages must be in this format, or no data can be read.
    Nome della proprietà TimestampTimestamp property name Per determinare questo valore, è necessario comprendere il formato dei dati del messaggio inviato all'hub IoT.To determine this value, you need to understand the message format of the message data sent into IoT Hub. Questo valore è il nome della proprietà evento specifica nei dati del messaggio che si vuole usare come timestamp dell'evento.This value is the name of the specific event property in the message data that you want to use as the event timestamp. Il valore fa distinzione tra maiuscole e minuscole.The value is case-sensitive. Se lasciato vuoto, come timestamp dell'evento viene usato il tempo di accodamento dell'evento all'interno dell'origine evento.When left blank, the event enqueue time within the event source is used as the event timestamp.
  9. La tabella seguente illustra le proprietà obbligatorie se si seleziona l'opzione Specificare le impostazioni dell'hub IoT manualmente:If you have selected the Provide IoT Hub settings manually option, the following table explains each required property:

    ProprietàProperty DescrizioneDescription
    ID sottoscrizioneSubscription ID La sottoscrizione in cui l'hub IoT è stata creata.The subscription in which this IoT Hub was created.
    Gruppo di risorseResource group Nome del gruppo di risorse in cui è stato creato questo hub IoT.The resource group name in which this IoT Hub was created.
    Nome dell'hub IoTIoT Hub name Il nome dell'hub IoT.The name of your IoT Hub. Al momento della creazione, all'hub IoT è stato anche assegnato un nome specifico.When you created your IoT Hub, you also gave it a specific name.
    Nome dei criteri dell'hub IoTIoT Hub policy name Il criterio di accesso condiviso che può essere creato nella scheda Impostazioni hub IoT. Ogni criterio di accesso condiviso ha un nome, autorizzazioni impostate e chiavi di accesso.The shared access policy, which can be created on the IoT Hub settings tab. Each shared access policy has a name, permissions that you set, and access keys. Il criterio di accesso condiviso per l'origine evento deve avere le autorizzazioni per la connessione al servizio.The shared access policy for your event source must have service connect permissions.
    Chiave dei criteri dell'hub IoTIoT Hub policy key Chiave di accesso condiviso usata per autenticare l'accesso allo spazio dei nomi del bus di servizio.The shared access key used to authenticate access to the Service Bus namespace. Digitare la chiave primaria o secondaria qui.Type the primary or secondary key here.
    Gruppo consumer dell'hub IoTIoT Hub consumer group Il gruppo di consumer per la lettura degli eventi dall'hub IoT.The consumer group to read events from the IoT Hub. È consigliabile usare un gruppo di consumer dedicato per l'origine evento.It is highly recommended to use a dedicated consumer group for your event source.
    Formato di serializzazione eventiEvent serialization format JSON è l'unico formato di serializzazione attualmente disponibile.JSON is the only available serialization at present. I messaggi relativi agli eventi devono essere in questo formato. In caso contrario, non è possibile leggere i dati.The event messages must be in this format, or no data can be read.
    Nome della proprietà TimestampTimestamp property name Per determinare questo valore, è necessario comprendere il formato dei dati del messaggio inviato all'hub IoT.To determine this value, you need to understand the message format of the message data sent into IoT Hub. Questo valore è il nome della proprietà evento specifica nei dati del messaggio che si vuole usare come timestamp dell'evento.This value is the name of the specific event property in the message data that you want to use as the event timestamp. Il valore fa distinzione tra maiuscole e minuscole.The value is case-sensitive. Se lasciato vuoto, come timestamp dell'evento viene usato il tempo di accodamento dell'evento all'interno dell'origine evento.When left blank, the event enqueue time within the event source is used as the event timestamp.
  10. Selezionare Crea per aggiungere la nuova origine evento.Select Create to add the new event source.

    Fare clic su Crea

    Dopo la creazione dell'origine evento, Time Series Insights inizierà automaticamente a trasmettere i dati nell'ambiente.After creation of the event source, Time Series Insights will automatically start streaming data into your environment.

Aggiungere un gruppo di consumer all'hub IoTAdd a consumer group to your IoT Hub

I gruppi di consumer vengono usati dalle applicazioni per eseguire il pull dei dati da hub IoT di Azure.Consumer groups are used by applications to pull data from Azure IoT Hubs. Per leggere in modo affidabile i dati dall'hub IoT, specificare un gruppo di consumer dedicato per l'uso esclusivo da parte di questo ambiente Time Series Insights.Provide a dedicated consumer group, for use by this Time Series Insights environment only, to reliably read data from your IoT Hub.

Per aggiungere un nuovo gruppo di consumer all'hub IoT, eseguire questa procedura:To add a new consumer group to your IoT Hub, follow these steps:

  1. Nel portale di Azure individuare e aprire l'hub IoT.In the Azure portal, locate and open your IoT Hub.

  2. Sotto l'intestazione Messaggistica selezionare Endpoint.Under the Messaging heading, select Endpoints.

    Aggiungere un gruppo di consumer

  3. Selezionare l'endpoint Eventi. Si aprirà la pagina Proprietà.Select the Events endpoint, and the Properties page opens.

  4. Sotto l'intestazione Gruppi di consumer specificare un nuovo nome univoco per il gruppo di consumer.Under the Consumer groups heading, provide a new unique name for the consumer group. Usare questo nome al momento di creare una nuova origine evento nell'ambiente Time Series Insights.Use this same name in Time Series Insights environment when creating a new event source.

  5. Selezionare Salva per salvare il nuovo gruppo di consumer.Select Save to save the new consumer group.

Passaggi successiviNext steps