Azure Time Series Insights Gen2-gebeurtenisbronnen

  • Artikel

Notitie

De TSI-service (Time Series Insights) wordt na maart 2025 niet meer ondersteund. Overweeg om bestaande TSI-omgevingen zo snel mogelijk te migreren naar alternatieve oplossingen. Raadpleeg onze documentatie voor meer informatie over de afschaffing en migratie.

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

Gebeurtenissen moeten worden verzonden als JSON met UTF-8-codering.

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 onder te brengen.

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 openbare internettoegang niet tot een hub of gebeurtenisbron die wordt gebruikt door Time Series Insights, anders wordt de benodigde verbinding 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
EarliestAvailable Alle bestaande gegevens opnemen die zijn opgeslagen in de IoT of Event Hub "ingressStartAt": {"type": "EarliestAvailable"}
EventSourceCreationTime Begin met het opnemen van gegevens die binnenkomen nadat de gebeurtenisbron is gemaakt. Alle bestaande gegevens die vóór het maken van de gebeurtenisbron zijn gestreamd, worden genegeerd. Dit is de standaardinstelling in de Azure Portal "ingressStartAt": {"type": "EventSourceCreationTime"}
CustomEnqueuedTime Uw omgeving neemt gegevens op van uw aangepaste enqueued time (UTC) forward. Alle gebeurtenissen die op of na uw aangepaste enqueued-tijd in uw IoT of Event Hub zijn opgenomen, worden opgenomen en opgeslagen. Alle gebeurtenissen die vóór uw aangepaste enqueued-tijd zijn aangekomen, worden genegeerd. Houd er rekening mee dat 'enqueued time' verwijst naar de tijd (in UTC) dat de gebeurtenis in uw IoT of Event Hub is aangekomen. 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 bestaande gegevens hebt, kan het zijn dat u een hoge initiële latentie ondervindt omdat uw Azure Time Series Insights Gen2-omgeving al uw gegevens verwerkt.
  • Deze hoge latentie neemt uiteindelijk af naarmate de gegevens worden geïndexeerd. Dien een ondersteuningsticket in via de Azure Portal als er sprake is van een continue hoge latentie.
  • EarliestAvailable

EarliestAvailable-diagram

  • EventSourceCreationTime

EventSourceCreationTime-diagram

  • CustomEnqueuedTime

CustomEnqueuedTime-diagram

Aanbevolen procedures voor opname van streaming

  • Maak altijd een unieke consumentengroep voor uw Azure Time Series Insights Gen2-omgeving om gegevens uit uw gebeurtenisbron te gebruiken. Het opnieuw gebruiken van consumentengroepen kan leiden tot willekeurige verbroken verbindingen 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 hoge beschikbaarheid niet garanderen.

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

  • Configureer een vertragingswaarschuwing om te worden gewaarschuwd als uw omgeving problemen ondervindt met het verwerken van gegevens. Zie Productieworkloads hieronder voor voorgestelde waarschuwingsvoorwaarden.

  • Gebruik streamingopname alleen voor bijna realtime en recente gegevens. Het streamen van historische gegevens wordt niet ondersteund.

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

  • Volg het principe van minimale bevoegdheden bij het opgeven van verbindingsreeksen voor gebeurtenisbronnen. Configureer voor Event Hubs een beleid voor gedeelde toegang met alleen de claim verzenden en gebruik voor IoT Hub alleen de machtiging serviceverbinding.

Waarschuwing

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 best practices wordt u aangeraden het volgende te implementeren voor bedrijfskritieke workloads.

  • Verhoog de retentietijd van uw IoT Hub of Event Hub tot maximaal zeven dagen.

  • Maak omgevingswaarschuwingen in de 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 staan hier. Voorgestelde waarschuwingsvoorwaarden:

    • IngressReceivedMessagesTimeLag is langer dan 5 minuten
    • IngressReceivedBytes is 0

  • Houd de opnamebelasting verdeeld tussen uw IoT Hub- of Event Hub-partities.

Historische gegevensopname

Het gebruik van de streaming-pijplijn 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. Het opnemen van gegevens buiten de volgorde leidt tot verminderde queryprestaties.
  • Historische gegevens op tijd geordende wijze opnemen voor de beste prestaties.
  • Blijf binnen de onderstaande limieten voor de opnamedoorvoersnelheid.
  • Schakel Warm Store uit als de gegevens ouder zijn dan de bewaarperiode voor warmopslag.

Tijdstempel van gebeurtenisbron

Wanneer u een gebeurtenisbron configureert, wordt u gevraagd om een tijdstempel-id-eigenschap op te geven. De eigenschap timestamp 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 plotten van reeksen in de Azure Time Series Insights Explorer. Als er geen eigenschap wordt opgegeven tijdens het maken of als de tijdstempeleigenschap ontbreekt in een gebeurtenis, wordt de IoT Hub- of Event Hubs-enqueued-tijd als standaard gebruikt. Waarden van de timestamp-eigenschap 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 de leestijd heeft gegenereerd in plaats van de standaard hub-enqueuedtijd 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 binnen een genest JSON-object of een matrix bevindt, moet u de juiste eigenschapsnaam opgeven volgens onze naamconventies voor platmaken en escapen. Het 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 vervolgens 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 blijven en waarnaar uw toepassing kan verwijzen in een queryantwoord.

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

±HHMMZ
± UU:MM
±HH:MMZ

Volgende stappen