Inviare eventi a un ambiente Azure Time Series Insights Gen1 usando un hub eventi

Articolo
06/03/2024

Nota

Il servizio Time Series Insights verrà ritirato il 7 luglio 2024. Valutare la possibilità di eseguire la migrazione di ambienti esistenti a soluzioni alternative il prima 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, vedere 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 crea uno spazio dei nomi dell'hub eventi. Se non è ancora stato creato un hub eventi all'interno dello spazio dei nomi, nel menu creare un hub eventi in Entità.
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 evento di Azure Time Series Insights.

Importante

Assicurarsi che questo gruppo di consumer non venga usato da altri servizi, 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 selezionare Aggiungi.
Nel riquadro Aggiungi nuovi criteri di accesso condiviso creare un accesso condiviso denominato MySendPolicy Questo criterio di accesso condiviso viene usato per 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 ed è possibile archiviare i dati contestuali nei campi dell'istanza . I dati vengono uniti 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 di 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 time series.

Eseguire il push di eventi in generatori eolici di esempio

Nella barra di ricerca cercare hub eventi. Nell'elenco restituito selezionare Hub eventi.
Selezionare l'istanza dell'hub eventi.
Passare a Criteri>di accesso condiviso MySendPolicy. Copiare il valore per Stringa di connessione-chiave primaria.
Passare al pusher del parco eolico di esempio TSI. Il sito crea ed esegue dispositivi simulati windmill.
Nella casella Stringa di connessione dell'hub eventi nella pagina Web incollare il stringa di connessione copiato nel campo di input del mulino a vento.
Selezionare Click to start (Fare clic per avviare).

Suggerimento

Il simulatore windmill crea anche JSON che è possibile usare come payload con le API di 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 1

Input: oggetto JSON semplice.

{
    "id":"device1",
    "timestamp":"2016-01-08T01:08:00Z"
}

Output: un evento.

id timestamp

device1 2016-01-08T01:08:00Z

id	timestamp
device1	2016-01-08T01:08:00Z

Esempio 2

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

id	timestamp
device1	2016-01-08T01:08:00Z
device2	2016-01-08T01:17:00Z

Esempio 3

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.

location events.id events.timestamp

WestUs device1 2016-01-08T01:08:00Z

WestUs device2 2016-01-08T01:17:00Z

location	events.id	events.timestamp
WestUs	device1	2016-01-08T01:08:00Z
WestUs	device2	2016-01-08T01:17:00Z

Esempio 4

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.

location	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 hub IoT

Condividi tramite