Gebeurtenisbronnen van Azure Time Series Insights Gen2

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. Ga naar onze documentatievoor meer informatie over de veroudering en migratie.

Uw Azure Time Series Insights Gen2-omgeving kan maximaal twee streaming-gebeurtenisbronnen hebben. Twee typen Azure-resources worden ondersteund als invoer:

• Azure IoT Hub
• Azure Event Hubs

Gebeurtenissen moeten worden verzonden als UTF-8 gecodeerde JSON.

Gebeurtenisbronnen maken of bewerken

De gebeurtenisbron is de koppeling tussen uw hub en uw Azure Time Series Insights Gen2-omgeving en er wordt een afzonderlijke resource van het type Time Series Insights event source gemaakt in uw resourcegroep. De IoT Hub- of Event Hub-resource(s) kunnen zich in hetzelfde Azure-abonnement bevinden als uw Azure Time Series Insights Gen2-omgeving of een ander abonnement. Het is echter een best practice om uw Azure Time Series Insights-omgeving en de IoT Hub of Event Hub binnen dezelfde Azure-regio te plaatsen.

U kunt de Azure Portal, Azure CLI, Azure Resource Manager-sjablonenen de REST API- gebruiken om de gebeurtenisbronnen van uw omgeving te maken, te bewerken of te verwijderen.

Waarschuwing

Beperk geen openbare internettoegang tot een hub of gebeurtenisbron die wordt gebruikt door Time Series Insights of de benodigde verbinding wordt verbroken.

Startopties

Wanneer u een gebeurtenisbron maakt, kunt u opgeven welke bestaande gegevens moeten worden verzameld. Deze instelling is optioneel. De volgende opties zijn beschikbaar:

Naam	Beschrijving	Voorbeeld van Azure Resource Manager-sjabloon
Eerst Beschikbaar	Alle vooraf bestaande gegevens opnemen die zijn opgeslagen in ioT of Event Hub	"ingressStartAt": {"type": "EarliestAvailable"}
AanmaakTijdstipGebeurtenisBron	Begin met het opnemen van gegevens die binnenkomen nadat de gebeurtenisbron is gemaakt. Alle vooraf bestaande gegevens die vóór het maken van de gebeurtenisbron zijn gestreamd, worden genegeerd. Dit is de standaardinstelling in Azure Portal	"ingressStartAt": {"type": "EventSourceCreationTime"}
CustomEnqueuedTime	Uw omgeving zal vanaf uw aangepaste ingeroosterde tijd (UTC) gegevens opnemen. Alle gebeurtenissen die zijn geïnventueerd in uw IoT of Event Hub op of na uw aangepaste enqueuedtijd, worden opgenomen en opgeslagen. Alle gebeurtenissen die vóór uw aangepaste enqueuedtijd zijn aangekomen, worden genegeerd. Houd er rekening mee dat 'enqueued time' verwijst naar het moment (in UTC) dat het evenement in uw IoT- of Event Hub is gearriveerd. Dit verschilt van een aangepaste tijdstempeleigenschap die zich in de inhoud van uw gebeurtenis bevindt.	"ingressStartAt": {"type": "CustomEnqueuedTime", "time": "2021-03-01T17:00:00.20Z"}

Belangrijk

• Als u EarliestAvailable selecteert en veel vooraf bestaande gegevens hebt, ondervindt u mogelijk een hoge initiële latentie omdat uw Azure Time Series Insights Gen2-omgeving al uw gegevens verwerkt.
• Deze hoge latentie moet uiteindelijk worden afgetrokken wanneer gegevens worden geïndexeerd. Dien een ondersteuningsticket in via Azure Portal als u een doorlopende hoge latentie ondervindt.

• EerstBeschikbaar

• AanmaaktijdEventBron

• CustomEnqueuedTime

Best practices voor gegevensinname bij streaming

• Maak altijd een unieke consumentengroep voor uw Azure Time Series Insights Gen2-omgeving om gegevens uit uw gebeurtenisbron te gebruiken. Het hergebruik van consumentengroepen kan willekeurige verbroken verbindingen veroorzaken en kan leiden tot gegevensverlies.

• Configureer uw Azure Time Series Insights Gen2-omgeving en uw IoT Hub en/of Event Hubs in dezelfde Azure-regio. Hoewel het mogelijk is om een gebeurtenisbron in een afzonderlijke regio te configureren, wordt dit scenario niet ondersteund en kunnen we geen hoge beschikbaarheid garanderen.

• Ga niet verder dan de doorvoersnelheidslimiet van uw omgeving of de limiet per partitie.

• Configureer een vertraging -waarschuwing om op de hoogte gesteld te worden wanneer uw omgeving problemen ondervindt met het verwerken van gegevens. Zie Productieworkloads hieronder voor voorgestelde waarschuwingsvoorwaarden.

• Gebruik streaming-inname alleen voor bijna realtime en recente gegevens; streaming van historische gegevens wordt niet ondersteund.

• Begrijp hoe eigenschappen zullen worden vastgelegd en hoe JSON -data worden afgevlakt en opgeslagen.

• Volg het principe van minimale bevoegdheden wanneer u verbindingsreeksen voor de gebeurtenisbron opgeeft. Voor Event Hubs configureert u een beleid voor gedeelde toegang met de alleen claim verzenden. Voor IoT Hub gebruikt u alleen de serviceverbinding machtiging.

Voorzichtigheid

Als u uw IoT Hub of Event Hub verwijdert en een nieuwe resource met dezelfde naam maakt, moet u een nieuwe gebeurtenisbron maken en de nieuwe IoT Hub of Event Hub koppelen. Gegevens worden pas opgenomen als u deze stap hebt voltooid.

Productie werklasten

Naast de bovenstaande aanbevolen procedures raden we u aan het volgende te implementeren voor bedrijfskritieke workloads.

• Verhoog uw IoT Hub- of Event Hub-gegevensretentietijd tot maximaal zeven dagen.

• Maak omgevingswaarschuwingen in Azure Portal. Waarschuwingen op basis van metrische gegevens van platform en stellen u in staat het gedrag van end-to-end-pijplijnen te valideren. De instructies voor het maken en beheren van waarschuwingen zijn hier. Voorgestelde waarschuwingsvoorwaarden:

  • IngressReceivedMessagesTimeLag is groter dan 5 minuten
  • IngressOntvangenBytes is 0

• Houd uw verwerkingsbelasting gebalanceerd tussen uw IoT Hub- of Event Hub-partities.

Historische gegevensopname

Het gebruik van de streamingpijplijn voor het importeren van historische gegevens wordt momenteel niet ondersteund in Azure Time Series Insights Gen2. Als u eerdere gegevens in uw omgeving wilt importeren, volgt u de onderstaande richtlijnen:

• Stream live- en historische gegevens niet parallel. Als u gegevens in de verkeerde volgorde opneemt, zullen de queryprestaties verlagen.
• Gebruik historische gegevens op tijd geordende wijze voor de beste prestaties.
• Blijf binnen de onderstaande limieten voor opnamedoorvoersnelheid.
• Schakel Warm Store uit als de gegevens ouder zijn dan de bewaarperiode van uw Warm Store.

Tijdstempel van gebeurtenisbron

Wanneer u een gebeurtenisbron configureert, wordt u gevraagd een tijdstempel-id-eigenschap op te geven. De tijdstempeleigenschap wordt gebruikt om gebeurtenissen in de loop van de tijd bij te houden. Dit is de tijd die wordt gebruikt als tijdstempel $ts in de Query-API's en voor het tekenen van reeksen in Azure Time Series Insights Explorer. Als er tijdens het aanmaken geen eigenschap wordt opgegeven of als de tijdstempeleigenschap ontbreekt in een gebeurtenis, dan wordt de inrijtijd van de IoT Hub of Event Hubs gebruikt als standaardwaarde. Tijdstempeleigenschapswaarden worden opgeslagen in UTC.

Over het algemeen kiezen gebruikers ervoor om de tijdeigenschap aan te passen en de tijd te gebruiken waarop de sensor of tag de meting heeft uitgevoerd in plaats van de standaard wachttijd van de hub te gebruiken. Dit is met name nodig wanneer apparaten onregelmatig connectiviteitsverlies hebben en een batch vertraagde berichten worden doorgestuurd naar Azure Time Series Insights Gen2.

Als uw aangepaste tijdstempel zich in een genest JSON-object of een array bevindt, moet u de juiste naam van de eigenschap opgeven volgens onze afvlak- en escape-naamgevingsconventies. De tijdstempel van de gebeurtenisbron voor de JSON-nettolading die hier wordt weergegeven, moet bijvoorbeeld worden ingevoerd als "values.time".

Tijdzone-verschuivingen

Tijdstempels moeten worden verzonden in ISO 8601-indeling en worden opgeslagen in UTC. Als er een tijdzone-offset wordt opgegeven, wordt de offset toegepast en wordt de tijd opgeslagen en geretourneerd in UTC-indeling. Als de offset onjuist is opgemaakt, wordt deze genegeerd. In situaties waarin uw oplossing mogelijk geen context heeft van de oorspronkelijke offset, kunt u de offsetgegevens verzenden in een extra afzonderlijke gebeurteniseigenschap om ervoor te zorgen dat deze behouden blijft en dat uw toepassing kan verwijzen in een queryantwoord.

De tijdzone-offset moet worden opgemaakt als een van de volgende:

±HHMMZ
±HH:MM
±HH:MMZ

Volgende stappen

• Lees de JSON Flattening and Escapeing Rules om te begrijpen hoe gebeurtenissen worden opgeslagen.

• Inzicht in de doorvoerbeperkingen van uw omgeving