Come aggiungere un'origine evento hub eventi a un ambiente Time Series InsightsHow to add an Event 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 eventi.This article describes how to use the Azure portal to add an event source that reads data from an Event Hub into your Time Series Insights environment.

PrerequisitiPrerequisites

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 eventi

  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 eventi.Select the Source as Event Hub.

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

    • Se per una delle sottoscrizioni disponibili esiste già un hub eventi, scegliere Usare l'hub eventi dalle sottoscrizioni disponibili.Choose Use Event Hub from available subscriptions when you already have an existing Event Hub on one of your subscriptions. Questo è l'approccio più semplice.This is the easiest approach.
    • Scegliere Specificare le impostazioni dell'hub eventi manualmente se l'hub eventi è esterno alle sottoscrizioni o si vogliono scegliere opzioni avanzate.Choose Provide Event Hub settings manually when the Event 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 eventi dalle sottoscrizioni disponibili:If you have selected the Use Event 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 eventi è stato creato.Select the subscription in which this event hub was created.
    Spazio dei nomi del bus di servizioService bus namespace Selezionare lo spazio dei nomi del bus di servizio che contiene l'hub eventi.Select the Service Bus namespace that contains the Event Hub.
    Nome hub eventiEvent hub name Selezionare il nome dell'hub eventi.Select the name of the Event Hub.
    Nome criteri hub eventiEvent hub policy name Selezionare i criteri di accesso condiviso, che possono essere creati nella scheda Configura dell'hub eventi. Tutti i criteri di accesso condiviso dispongono di un nome e di autorizzazioni impostati, nonché di chiavi di accesso.Select the shared access policy, which can be created on the Event Hub Configure tab. Each shared access policy has a name, permissions that you set, and access keys. I criteri di accesso condiviso per l'origine evento devono disporre di autorizzazioni di lettura.The shared access policy for your event source must have read permissions.
    Chiave criteri hub eventiEvent hub policy key Il valore della chiave può essere prepopolato.The key value may be prepopulated.
    Gruppo di consumer dell'hub eventiEvent hub consumer group Il gruppo di consumer per la lettura degli eventi dall'hub eventi.The consumer group to read events from the Event 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 eventi.To determine this value, you need to understand the message format of the message data sent into Event 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 eventi manualmente:If you have selected the Provide Event Hub settings manually option, the following table explains each required property:

    ProprietàProperty DescrizioneDescription
    ID sottoscrizioneSubscription ID La sottoscrizione in cui l'hub eventi è stato creato.The subscription in which this event hub was created.
    Gruppo di risorseResource group Gruppo di risorse in cui è stato creato questo hub eventi.The resource group in which this event hub was created.
    Spazio dei nomi del bus di servizioService bus namespace Uno spazio dei nomi Service Bus è un contenitore per un set di entità di messaggistica.A Service Bus namespace is a container for a set of messaging entities. Quando si crea un nuovo Hub eventi, viene inoltre creato uno spazio dei nomi Service Bus.When you created a new Event Hub, you also created a Service Bus namespace.
    Nome hub eventiEvent hub name Nome dell'hub eventi.The name of your Event Hub. Al momento della creazione, all'hub eventi è stato anche assegnato un nome specifico.When you created your event hub, you also gave it a specific name.
    Nome criteri hub eventiEvent hub policy name Criteri di accesso condiviso che possono essere creati nella scheda Configura dell'hub eventi. Tutti i criteri di accesso condiviso dispongono di un nome e di autorizzazioni impostati, nonché di chiavi di accesso.The shared access policy, which can be created on the Event Hub Configure tab. Each shared access policy has a name, permissions that you set, and access keys. I criteri di accesso condiviso per l'origine evento devono disporre di autorizzazioni di lettura.The shared access policy for your event source must have read permissions.
    Chiave criteri hub eventiEvent hub policy key Chiave di accesso condivisa 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 di consumer dell'hub eventiEvent hub consumer group Il gruppo di consumer per leggere gli eventi dall'hub eventi.The Consumer Group to read events from the Event 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 eventi.To determine this value, you need to understand the message format of the message data sent into Event 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 eventiAdd a consumer group to your Event Hub

I gruppi di consumer vengono usati dalle applicazioni per eseguire il pull dei dati da hub eventi di Azure.Consumer groups are used by applications to pull data from Azure Event Hubs. Per leggere in modo affidabile i dati dall'hub eventi, 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 Event Hub.

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

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

  2. Sotto l'intestazione Entità selezionare Gruppi di consumer.Under the Entities heading, select Consumer groups.

    Hub eventi: aggiungere un gruppo di consumer

  3. Selezionare + Gruppo di consumer per aggiungere un nuovo gruppo di consumer.Select + Consumer Group to add a new consumer group.

  4. Nella pagina Gruppi di consumer specificare un nuovo Nome univoco.On the Consumer groups page, provide a new unique Name. Usare questo nome al momento di creare una nuova origine evento nell'ambiente Time Series Insights.Use this same name when creating a new event source in the Time Series Insights environment.

  5. Selezionare Crea per creare il nuovo gruppo di consumer.Select Create to create the new consumer group.

Passaggi successiviNext steps