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. Raadpleeg onze documentatie voor meer informatie over de afschaffing 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-sjablonen en de REST API gebruiken om gebeurtenisbronnen van uw omgeving te maken, bewerken of 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:

Name	Beschrijving	Voorbeeld van Azure Resource Manager-sjabloon
EarliestAvailable	Alle bestaande gegevens opnemen die zijn opgeslagen in de IoT of Event Hub	"ingressStartAt": {"type": "EarliestAvailable"}
EventSourceCreationTime	Beginnen met het opnemen van gegevens die binnenkomen nadat de gebeurtenisbron is gemaakt. Bestaande gegevens die zijn gestreamd vóór aan het maken van de gebeurtenisbron, worden genegeerd. Dit is de standaardinstelling in Azure Portal	"ingressStartAt": {"type": "EventSourceCreationTime"}
CustomEnqueuedTime	In uw omgeving worden gegevens opgenomen vanaf het door u aangepaste tijdstip van in de wachtrij plaatsen (UTC). Alle gebeurtenissen die in de IoT of Event Hub zijn opgenomen op of na het aangepaste tijdstip van in de wachtrij plaatsen, worden opgenomen en opgeslagen. Alle gebeurtenissen die zijn aangekomen vóór uw aangepaste tijdstip van in de wachtrij plaatsen, worden genegeerd. Houd er rekening mee dat 'enqueued time' verwijst naar de tijd (in UTC) dat de gebeurtenis is aangekomen in uw IoT of Event Hub. Dit verschilt van een aangepaste tijdstempeleigenschap die zich in de hoofdtekst 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.

• EarliestAvailable

• EventSourceCreationTime

• CustomEnqueuedTime

Best practices voor streamingopname

• 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 per partitielimiet.

• Configureer een vertragingswaarschuwing om een melding te ontvangen als uw omgeving problemen ondervindt met het verwerken van gegevens. Zie de onderstaande productieworkloads voor voorgestelde waarschuwingsvoorwaarden.

• Streamingopname gebruiken voor bijna realtime en recente gegevens, wordt het streamen van historische gegevens niet ondersteund.

• Begrijpen hoe eigenschappen worden ontsnapt en JSON-gegevens platgemaakt en opgeslagen.

• Volg het principe van minimale bevoegdheden bij het leveren van gebeurtenisbron-verbindingsreeks s. Voor Event Hubs configureert u een beleid voor gedeelde toegang met alleen de verzendclaim . Voor IoT Hub gebruikt u alleen de machtiging voor serviceverbinding .

Let op

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.

Productieworkloads

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. Met waarschuwingen op basis van metrische platformgegevens kunt u end-to-end-pijplijngedrag valideren. De instructies voor het maken en beheren van waarschuwingen zijn hier. Voorgestelde waarschuwingsvoorwaarden:

  • IngressReceivedMessagesTimeLag is groter dan 5 minuten
  • IngressReceivedBytes is 0

• Houd uw opnametaak verdeeld 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 uit de volgorde opneemt, worden de queryprestaties verminderd.
• Gebruik historische gegevens op tijd geordende wijze voor de beste prestaties.
• Blijf binnen de onderstaande limieten voor opnamedoorvoer.
• 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 de Azure Time Series Insights Explorer. Als er tijdens het maken geen eigenschap wordt opgegeven of als de tijdstempeleigenschap ontbreekt in een gebeurtenis, wordt de IoT Hub- of Events Hubs-tijd die als standaardwaarde wordt gebruikt. Tijdstempeleigenschapswaarden worden opgeslagen in UTC.

Over het algemeen kiezen gebruikers ervoor om de tijdstempeleigenschap aan te passen en de tijd te gebruiken waarop de sensor of tag het lezen heeft gegenereerd in plaats van de standaard hub-tijd 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 matrix bevindt, moet u de juiste eigenschapsnaam opgeven volgens onze afvlakkende en escape-naamconventies. De tijdstempel van de gebeurtenisbron voor de hier weergegeven JSON-nettolading 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
±U:MM
±HH:MMZ

Volgende stappen

• Lees de JSON Flattening- en Escapeing-regels om te begrijpen hoe gebeurtenissen worden opgeslagen.

• Inzicht in de doorvoerbeperkingen van uw omgeving