Inviare eventi a un ambiente di Azure Time Series Insights Gen1 usando un hub eventi
Nota
Il servizio Time Series Insights (TSI) non sarà più supportato dopo marzo 2025. Prendere in considerazione la migrazione degli ambienti TSI esistenti alle soluzioni alternative non appena possibile. Per altre informazioni sulla deprecazione e la migrazione, visitare la documentazione.
Attenzione
È un articolo di Gen1.
Questo articolo illustra come creare e configurare un hub eventi in Hub eventi di Azure. Descrive anche come eseguire un'applicazione di esempio per eseguire il push di eventi in Azure Time Series Insights da Hub eventi. Se si dispone di un hub eventi esistente con eventi in formato JSON, ignorare questa esercitazione e visualizzare l'ambiente in Azure Time Series Insights.
Configurare un hub eventi
Per informazioni su come creare un hub eventi, leggere la documentazione di Hub eventi.
Nella casella di ricerca cercare hub eventi. Nell'elenco restituito selezionare Hub eventi.
Selezionare l'hub eventi.
Quando si crea un hub eventi, si sta creando uno spazio dei nomi dell'hub eventi. Se non è ancora stato creato un hub eventi all'interno dello spazio dei nomi, nel menu, in Entità creare un hub eventi.
Dopo aver creato un hub eventi, selezionarlo nell'elenco degli hub eventi.
Nel menu, in Entità selezionare Hub eventi.
Selezionare il nome dell'hub eventi per configurarlo.
In Panoramica selezionare Gruppi di consumer e quindi gruppo di consumer.
Assicurarsi di creare un gruppo di consumer usato esclusivamente dall'origine eventi Azure Time Series Insights.
Importante
Assicurarsi che questo gruppo di consumer non sia usato da alcun altro servizio, ad esempio un processo di Analisi di flusso di Azure o un altro ambiente Azure Time Series Insights. Se il gruppo di consumer viene usato da altri servizi, le operazioni di lettura sono compromesse negativamente per questo ambiente e per altri servizi. Se si usa $Default come gruppo di consumer, altri lettori potrebbero potenzialmente usare nuovamente il gruppo di consumer.
Nel menu, in Impostazioni selezionare Criteri di accesso condiviso e quindi Aggiungi.
Nel riquadro Aggiungi nuovi criteri di accesso condiviso creare un accesso condiviso denominato MySendPolicy Questo criterio di accesso condiviso consente di inviare eventi negli esempi C# più avanti in questo articolo.
In Attestazione selezionare la casella di controllo Invia .
Aggiungere un'istanza di Azure Time Series Insights
In Azure Time Series Insights Gen2 è possibile aggiungere dati contestuali ai dati di telemetria in ingresso usando il modello TSM (Time Series Model). In TSM i tag o i segnali vengono definiti istanze e è possibile archiviare i dati contestuali nei campi dell'istanza. I dati vengono aggiunti in fase di query usando un ID serie temporale. L'ID serie temporale per il progetto windmills di esempio usato più avanti in questo articolo è id
. Per altre informazioni sull'archiviazione dei dati nei campi dell'istanza, vedere Panoramica del modello time series .
Creare un'origine evento Azure Time Series Insights
Completare i passaggi per creare un'origine evento se non ne è stata ancora creata una.
Impostare un valore per
timeSeriesId
. Per altre informazioni sull'ID serie temporale, vedere Modelli di serie temporali.
Eseguire il push di eventi nei mulini a vento
Nella barra di ricerca cercare hub eventi. Nell'elenco restituito selezionare Hub eventi.
Selezionare l'istanza dell'hub eventi.
Passare a Criteri> di accesso condivisoMySendPolicy. Copiare il valore per la chiave primaria stringa di connessione.
Passare al pusher di wind farm di esempio TSI. Il sito crea ed esegue dispositivi di windmill simulati.
Nella casella Stringa di connessione dell'hub eventi nella pagina Web incollare la stringa di connessione copiata nel campo di input del windmill.
Selezionare Click to start (Fare clic per avviare).
Suggerimento
Il simulatore di windmill crea anche JSON che è possibile usare come payload con le API query GA di Azure Time Series Insights.
Nota
Il simulatore continuerà a inviare dati fino alla chiusura della scheda del browser.
Tornare all'hub eventi nel portale di Azure. Nella pagina Panoramica vengono visualizzati i nuovi eventi ricevuti dall'hub eventi.
Forme JSON supportate
Esempio uno
Input: oggetto JSON semplice.
{ "id":"device1", "timestamp":"2016-01-08T01:08:00Z" }
Output: un evento.
id timestamp device1 2016-01-08T01:08:00Z
Esempio due
Input: matrice JSON con due oggetti JSON. Ogni oggetto JSON viene convertito in un evento.
[ { "id":"device1", "timestamp":"2016-01-08T01:08:00Z" }, { "id":"device2", "timestamp":"2016-01-17T01:17:00Z" } ]
Output: due eventi.
id timestamp device1 2016-01-08T01:08:00Z device2 2016-01-08T01:17:00Z
Esempio tre
Input: oggetto JSON con una matrice JSON annidata che contiene due oggetti JSON.
{ "location":"WestUs", "events":[ { "id":"device1", "timestamp":"2016-01-08T01:08:00Z" }, { "id":"device2", "timestamp":"2016-01-17T01:17:00Z" } ] }
Output: due eventi. La proprietà location viene copiata in ogni evento.
posizione events.id events.timestamp WestUs device1 2016-01-08T01:08:00Z WestUs device2 2016-01-08T01:17:00Z
Esempio quattro
Input: oggetto JSON con una matrice JSON annidata che contiene due oggetti JSON. Questo input dimostra che le proprietà globali possono essere rappresentate dall'oggetto JSON complesso.
{ "location":"WestUs", "manufacturer":{ "name":"manufacturer1", "location":"EastUs" }, "events":[ { "id":"device1", "timestamp":"2016-01-08T01:08:00Z", "data":{ "type":"pressure", "units":"psi", "value":108.09 } }, { "id":"device2", "timestamp":"2016-01-17T01:17:00Z", "data":{ "type":"vibration", "units":"abs G", "value":217.09 } } ] }
Output: due eventi.
posizione manufacturer.name manufacturer.location events.id events.timestamp events.data.type events.data.units events.data.value WestUs manufacturer1 EastUs device1 2016-01-08T01:08:00Z pressione psi 108.09 WestUs manufacturer1 EastUs device2 2016-01-08T01:17:00Z vibration abs G 217.09
Passaggi successivi
Visualizzare l'ambiente in Azure Time Series Insights Explorer.
Altre informazioni sui messaggi dei dispositivi di hub IoT