Gebeurtenissen verzenden naar een Azure Time Series Insights Gen1-omgeving met behulp van een Event Hub

Artikel
09/30/2020

Notitie

De Time Series Insights-service wordt op 7 juli 2024 buiten gebruik gesteld. Overweeg om bestaande omgevingen zo snel mogelijk naar alternatieve oplossingen te migreren. Voor meer informatie over de afkeuring en migratie, ga naar onze documentatie.

Voorzichtigheid

Dit is een Gen1-artikel.

In dit artikel wordt uitgelegd hoe u een Event Hub maakt en configureert in Azure Event Hubs. Ook wordt beschreven hoe u een voorbeeldtoepassing uitvoert om gebeurtenissen vanuit Event Hubs naar Azure Time Series Insights te pushen. Als u een bestaande Event Hub hebt met gebeurtenissen in JSON-indeling, slaat u deze zelfstudie over en bekijkt u uw omgeving in Azure Time Series Insights.

Een Event Hub configureren

Om te leren hoe je een Event Hub maakt, lees de documentatie van Event Hubs.
Zoek in het zoekvak naar Event Hubs. Selecteer in de geretourneerde lijst Event Hubs.
Selecteer uw Event Hub.
Wanneer u een Event Hub maakt, maakt u een Event Hub-naamruimte. Als u nog geen Event Hub in de naamruimte hebt gemaakt, maakt u in het menu onder Entiteiteneen Event Hub.
Nadat u een Event Hub hebt gemaakt, selecteert u deze in de lijst met Event Hubs.
Selecteer in het menu onder EntiteitenEvent Hubs.
Selecteer de naam van de Event Hub om deze te configureren.
Selecteer onder OverzichtConsumentengroepenen selecteer Consumentengroep.
Zorg ervoor dat u een consumentengroep maakt die uitsluitend wordt gebruikt door uw Azure Time Series Insights-gebeurtenisbron.

Belangrijk

Zorg ervoor dat deze consumentengroep niet wordt gebruikt door een andere service, zoals een Azure Stream Analytics-taak of een andere Azure Time Series Insights-omgeving. Als de consumentengroep wordt gebruikt door de andere services, worden leesbewerkingen negatief beïnvloed, zowel voor deze omgeving als voor andere services. Als u $Default gebruikt als consumentengroep, kunnen andere lezers uw consumentengroep mogelijk opnieuw gebruiken.
Selecteer in het menu, onder Instellingen, beleid voor gedeelde toegangen selecteer vervolgens toevoegen.
Maak in het deelvenster Nieuw beleid voor gedeelde toegang toevoegen een gedeelde toegang met de naam MySendPolicy. U gebruikt dit beleid voor gedeelde toegang om gebeurtenissen te verzenden in de C#-voorbeelden verderop in dit artikel.
Schakel onder Claimhet selectievakje Verzenden in.

Een Azure Time Series Insights-exemplaar toevoegen

In Azure Time Series Insights Gen2 kunt u contextuele gegevens toevoegen aan binnenkomende telemetrie met behulp van het Time Series-model (TSM). In TSM worden uw tags of signalen aangeduid als exemplaren, en kunt u contextuele gegevens opslaan in instantievelden. De gegevens worden gekoppeld op het moment van de query met behulp van een Time Series-id. De Time Series ID voor het proefmolenproject dat we verderop in dit artikel gebruiken, is id. Lees het overzicht van het Time Series-model voor meer informatie over het opslaan van gegevens in exemplaarvelden.

Een Azure Time Series Insights-gebeurtenisbron maken

Als u nog geen gebeurtenisbron hebt gemaakt, voert u de stappen uit om een gebeurtenisbron te maken.
Stel een waarde in voor timeSeriesId. Lees Tijdreeksmodellenvoor meer informatie over tijdreeks-id.

Gebeurtenissen sturen naar windmolens voorbeeld

Zoek in de zoekbalk naar Event Hubs. Selecteer in de geretourneerde lijst Event Hubs.
Selecteer uw Event Hub-exemplaar.
Ga naar Beleid voor gedeelde toegang>MySendPolicy. Kopieer de waarde voor verbindingsreeksprimairesleutel.
Navigeer naar de TSI Sample Wind Farm Pusher. De site maakt en voert gesimuleerde windmolenapparaten uit.
Plak in het Event Hub Connection String vak op de webpagina de verbindingsreeks die u hebt gekopieerd in het windmoleninvoerveld.
Selecteer Klik omte starten.

Fooi

De windmolensimulator maakt ook JSON die u kunt gebruiken als payload met de Azure Time Series Insights GA Query APIs.

Notitie

De simulator blijft gegevens verzenden totdat het browsertabblad is gesloten.
Ga terug naar uw Event Hub in Azure Portal. Op de pagina Overzicht worden de nieuwe gebeurtenissen weergegeven die door de Event Hub worden ontvangen.

Ondersteunde JSON-vormen

Voorbeeld 1

Invoer: een eenvoudig JSON-object.

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

Uitvoer: Eén gebeurtenis.

ID tijdstempel

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

ID	tijdstempel
apparaat1	2016-01-08T01:08:00Z

Voorbeeld twee

Invoer: een JSON-matrix met twee JSON-objecten. Elk JSON-object wordt geconverteerd naar een gebeurtenis.

[
    {
        "id":"device1",
        "timestamp":"2016-01-08T01:08:00Z"
    },
    {
        "id":"device2",
        "timestamp":"2016-01-17T01:17:00Z"
    }
]

Uitvoer: twee gebeurtenissen.

id tijdstempel

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

apparaat2 2016-01-08T01:17:00Z

id	tijdstempel
apparaat1	2016-01-08T01:08:00Z
apparaat2	2016-01-08T01:17:00Z

Voorbeeld drie

Invoer: een JSON-object met een geneste JSON-matrix die twee JSON-objecten bevat.

{
    "location":"WestUs",
    "events":[
        {
            "id":"device1",
            "timestamp":"2016-01-08T01:08:00Z"
        },
        {
            "id":"device2",
            "timestamp":"2016-01-17T01:17:00Z"
        }
    ]
}

uitvoer: twee gebeurtenissen. De eigenschap locatie wordt gekopieerd naar elke gebeurtenis.

plaats evenementen.id gebeurtenissen.tijdstempel

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

WestUs apparaat-2 2016-01-08T01:17:00Z

plaats	evenementen.id	gebeurtenissen.tijdstempel
WestUs	apparaat1	2016-01-08T01:08:00Z
WestUs	apparaat-2	2016-01-08T01:17:00Z

Voorbeeld vier

Invoer: een JSON-object met een geneste JSON-matrix die twee JSON-objecten bevat. Deze invoer laat zien dat globale eigenschappen kunnen worden vertegenwoordigd door het complexe JSON-object.

{
    "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
            }
        }
    ]
}

uitvoer: twee gebeurtenissen.

plaats	manufacturer.name	fabrikant.locatie	evenementen.id	evenementen.tijdstempel	gebeurtenissen.data.type	events.data.units	events.data.value
WestUs	fabrikant1	EastUs	apparaat1	8 januari 2016 om 01:08 CET	druk	psi	108.09
WestUs	fabrikant1	EastUs	apparaat2	8 januari 2016 01:17:00 UTC	trilling	abs G	217.09

Volgende stappen

Meer informatie over IoT Hub-apparaatberichten

Delen via