Aggiungere un'origine evento dell'hub eventi all'ambiente di Azure Time Series Insights

Nota

Il servizio Time Series Insights (TSI) non sarà più supportato dopo marzo 2025. Valutare la possibilità di eseguire la migrazione di ambienti TSI esistenti a soluzioni alternative il prima possibile. Per altre informazioni sulla deprecazione e la migrazione, vedere la documentazione.

Questo articolo descrive come usare il portale di Azure per aggiungere all'ambiente Azure Time Series Insights un'origine evento che legge dati da Hub eventi di Azure.

Nota

I passaggi descritti in questo articolo si applicano sia agli ambienti Azure Time Series Insights Gen 1 che Azure Time Series Insights Gen 2.

Prerequisiti

Aggiungere un gruppo di consumer all'hub eventi

Le applicazioni usano gruppi di consumer per estrarre i dati da Hub eventi di Azure. Per leggere in modo affidabile i dati dall'hub eventi, fornire un gruppo di consumer dedicato usato solo da questo ambiente Azure Time Series Insights.

Per aggiungere un nuovo gruppo di consumer nell'hub eventi:

  1. Nel portale di Azure individuare e aprire l'istanza dell'hub eventi dal riquadro Panoramica dello spazio dei nomi dell'hub eventi. Selezionare Hub eventi entità > o trovare l'istanza in Nome.

    Aprire lo spazio dei nomi dell'hub eventi

  2. Nell'istanza dell'hub eventi selezionare Gruppi di consumer di entità>. Selezionare quindi + Gruppo di consumer per aggiungere un nuovo gruppo di consumer.

    Hub eventi - Aggiungere un gruppo di consumer

    In caso contrario, selezionare un gruppo di consumer esistente e passare alla sezione successiva.

  3. Nella pagina Gruppi di consumer immettere un nuovo valore univoco per Nome. Usare questo stesso nome quando si crea una nuova origine evento nell'ambiente Azure Time Series Insights.

  4. Selezionare Crea.

Aggiungere una nuova origine evento

  1. Accedere al portale di Azure.

  2. Individuare l'ambiente di Azure Time Series Insights esistente. Nel menu a sinistra selezionare Tutte le risorse e quindi selezionare l'ambiente Azure Time Series Insights.

  3. Selezionare Origini eventi e quindi Aggiungi.

    In Origini eventi selezionare il pulsante Aggiungi

  4. Immettere un valore per Nome origine evento univoco per questo ambiente Azure Time Series Insights, ad esempio Contoso-TSI-Gen 1-Event-Hub-ES.

  5. In Origine selezionare Hub eventi.

  6. Selezionare i valori appropriati in Opzione di importazione:

    • Se in una delle sottoscrizioni è presente un hub eventi esistente, selezionare Usare un hub eventi dalle sottoscrizioni disponibili. Questa opzione rappresenta l'approccio più semplice.

      Selezionare un'opzione di importazione origine eventi

    • La tabella seguente descrive le proprietà obbligatorie per l'opzione Usare un hub eventi dalle sottoscrizione disponibili:

      Dettagli della sottoscrizione e dell'hub eventi

      Proprietà Descrizione
      Subscription La sottoscrizione a cui appartiene l'istanza e lo spazio dei nomi dell'hub eventi desiderati.
      Spazio dei nomi dell'hub eventi Lo spazio dei nomi dell'hub eventi a cui appartiene l'istanza dell'hub eventi desiderata.
      Nome dell'hub eventi Nome dell'istanza dell'hub eventi desiderata.
      Valore dei criteri dell'hub eventi Selezionare i criteri di accesso condiviso desiderati. È possibile creare i criteri di accesso condiviso nella scheda Configura dell'hub eventi. Ogni criterio di accesso condiviso ha un nome, autorizzazioni impostate e chiavi di accesso. I criteri di accesso condiviso per l'origine evento devono disporre di autorizzazioni di lettura.
      Chiave criteri hub eventi Prepopolato dal valore dei criteri di Hub eventi selezionato.
    • Se l'hub eventi è esterno alle sottoscrizioni o se si vogliono scegliere opzioni avanzate, selezionare Specificare le impostazioni dell'hub eventi manualmente.

      La tabella seguente descrive le proprietà obbligatorie se si seleziona l'opzione Specificare le impostazioni dell'hub eventi manualmente:

      Proprietà Descrizione
      ID sottoscrizione La sottoscrizione a cui appartiene l'istanza e lo spazio dei nomi dell'hub eventi desiderati.
      Resource group Il gruppo di risorse a cui appartiene l'istanza e lo spazio dei nomi dell'hub eventi desiderati.
      Spazio dei nomi dell'hub eventi Lo spazio dei nomi dell'hub eventi a cui appartiene l'istanza dell'hub eventi desiderata.
      Nome dell'hub eventi Nome dell'istanza dell'hub eventi desiderata.
      Valore dei criteri dell'hub eventi Selezionare i criteri di accesso condiviso desiderati. È possibile creare i criteri di accesso condiviso nella scheda Configura dell'hub eventi. Ogni criterio di accesso condiviso ha un nome, autorizzazioni impostate e chiavi di accesso. I criteri di accesso condiviso per l'origine evento devono disporre di autorizzazioni di lettura.
      Chiave criteri hub eventi Chiave di accesso condiviso usata per autenticare l'accesso allo spazio dei nomi del bus di servizio di Azure. Immettere qui la chiave primaria o secondaria.
    • Entrambe le opzioni condividono le opzioni di configurazione seguenti:

      Proprietà Descrizione
      Gruppo di consumer dell'hub eventi Gruppo di consumer per la lettura degli eventi dall'hub eventi. È consigliabile usare un gruppo di consumer dedicato per la propria origine evento.
      Formato di serializzazione eventi Attualmente JSON è l'unico formato di serializzazione disponibile. I messaggi di evento devono essere in questo formato o i dati non possono essere letti.
      Nome della proprietà Timestamp Per determinare questo valore, è necessario comprendere il formato dei dati del messaggio inviati all'hub eventi. Questo valore è il nome della proprietà evento specifica nei dati del messaggio che si desidera utilizzare come timestamp dell'evento. Il valore fa distinzione tra maiuscole e minuscole. Se lasciato vuoto, l'ora di accodamento dell'evento nell'origine evento viene usata come timestamp dell'evento.
  7. Aggiungere il nome dedicato Azure Time Series Insights gruppo di consumer aggiunto all'hub eventi.

  8. Selezionare Crea.

    Dopo aver creato l'origine evento, Azure Time Series Insights avvia automaticamente lo streaming dei dati nell'ambiente.

Passaggi successivi