zdroje událostí Azure Time Series Insights Gen2

  • Článek

Poznámka

Služba Time Series Insights (TSI) už nebude po březnu 2025 podporována. Zvažte migraci stávajících prostředí TSI na alternativní řešení co nejdříve. Další informace o vyřazení a migraci najdete v naší dokumentaci.

Vaše prostředí Azure Time Series Insights Gen2 může mít až dva streamované zdroje událostí. Jako vstupy se podporují dva typy prostředků Azure:

Události se musí odesílat ve formátu JSON s kódováním UTF-8.

Vytvoření nebo úprava zdrojů událostí

Zdrojem událostí je propojení mezi centrem a prostředím Azure Time Series Insights Gen2 a ve vaší skupině prostředků se vytvoří samostatný prostředek typuTime Series Insights event source. Prostředky IoT Hub nebo centra událostí můžou být ve stejném předplatném Azure jako vaše prostředí Azure Time Series Insights Gen2 nebo jiné předplatné. Osvědčeným postupem je ale umístění prostředí Azure Time Series Insights a IoT Hub nebo centra událostí ve stejné oblasti Azure.

K vytváření, úpravám nebo odebírání zdrojů událostí vašeho prostředí můžete použít Azure Portal, Azure CLI, šablony Azure Resource Manager a rozhraní REST API.

Upozornění

Neomezujte veřejný internetový přístup k centru nebo zdroji událostí používaným službou Time Series Insights, jinak dojde k přerušení potřebného připojení.

Možnosti zahájení

Při vytváření zdroje událostí můžete určit, jaká existující data se mají shromažďovat. Toto nastavení je volitelné. Dostupné jsou tyto možnosti:

Název Popis Příklad šablony Azure Resource Manager
Nejdříve k dispozici Ingestování všech již existujících dat uložených ve službě IoT nebo Event Hub "ingressStartAt": {"type": "EarliestAvailable"}
EventSourceCreationTime Začněte ingestovat data, která přijdou po vytvoření zdroje událostí. Všechna existující data, která byla streamována před vytvořením zdroje událostí, budou ignorována. Toto je výchozí nastavení v Azure Portal "ingressStartAt": {"type": "EventSourceCreationTime"}
CustomEnqueuedTime Vaše prostředí bude ingestovat data z vlastního času zařazení do fronty (UTC). Všechny události, které byly ve službě IoT nebo Event Hub ve vašem vlastním čase zařazení do fronty nebo po nich, budou ingestovány a uloženy. Všechny události, které přišly před vaším vlastním časem zařazení do fronty, budou ignorovány. Všimněte si, že "čas zařazení do fronty" označuje čas (v UTC), kdy událost dorazila do vašeho IoT nebo centra událostí. To se liší od vlastní vlastnosti časového razítka , která je v textu události. "ingressStartAt": {"type": "CustomEnqueuedTime", "time": "2021-03-01T17:00:00.20Z"}

Důležité

  • Pokud vyberete možnost Nejdříve k dispozici a máte velké množství již existujících dat, může docházet k vysoké počáteční latenci, protože prostředí Azure Time Series Insights Gen2 zpracovává všechna vaše data.
  • Tato vysoká latence by měla nakonec po indexování dat ustupovat. Pokud dochází k trvalé vysoké latenci, odešlete lístek podpory prostřednictvím Azure Portal.
  • Nejdříve k dispozici

Diagram s nejstarším dostupným

  • EventSourceCreationTime

EventSourceCreationTime Diagram

  • CustomEnqueuedTime

CustomEnqueuedTime Diagram

Osvědčené postupy pro příjem dat streamování

  • Pro prostředí Azure Time Series Insights Gen2 vždy vytvořte jedinečnou skupinu příjemců, která bude využívat data ze zdroje událostí. Opakované využití skupin příjemců může způsobit náhodné odpojení a může vést ke ztrátě dat.

  • Nakonfigurujte prostředí Azure Time Series Insights Gen2 a IoT Hub nebo Event Hubs ve stejné oblasti Azure. I když je možné nakonfigurovat zdroj událostí v samostatné oblasti, tento scénář není podporovaný a nemůžeme zaručit vysokou dostupnost.

  • Nepřekračujte limit propustnosti vašeho prostředí ani limit počtu oddílů.

  • Nakonfigurujte upozornění na prodlevu, které má být upozorňováno na problémy se zpracováním dat ve vašem prostředí. Navrhované podmínky upozornění najdete níže v tématu Produkční úlohy .

  • Příjem streamovaných dat používejte jenom pro data téměř v reálném čase a poslední data, streamování historických dat se nepodporuje.

  • Seznamte se s tím, jak se budou umisovat vlastnosti a jak se data JSON zploštěnou a ukládají.

  • Při poskytování připojovacích řetězců zdroje událostí dodržujte princip nejnižšího oprávnění. V případě služby Event Hubs nakonfigurujte zásady sdíleného přístupu pouze s deklarací identity pro odeslání a pro IoT Hub použít pouze oprávnění připojení služby.

Upozornění

Pokud odstraníte IoT Hub nebo centrum událostí a znovu vytvoříte nový prostředek se stejným názvem, musíte vytvořit nový zdroj událostí a připojit nový IoT Hub nebo centrum událostí. Data se nebudou ingestovat, dokud tento krok nedokončíte.

Produkční úlohy

Kromě výše uvedených osvědčených postupů doporučujeme pro důležité obchodní úlohy implementovat následující:

  • Prodlužte dobu uchovávání dat IoT Hub nebo centra událostí na maximálně sedm dnů.

  • Vytvořte upozornění prostředí v Azure Portal. Upozornění založená na metrikách platformy umožňují ověřovat chování kanálu od konce do konce. Pokyny pro vytváření a správu upozornění najdete tady. Navrhované podmínky upozornění:

    • IngressReceivedMessagesTimeLag je větší než 5 minut
    • IngressReceivedBytes je 0

  • Udržujte vyrovnávání zatížení příjmu dat mezi oddíly IoT Hub nebo centra událostí.

Příjem historických dat

Použití streamovacího kanálu k importu historických dat není v současné době v Azure Time Series Insights Gen2 podporováno. Pokud potřebujete importovat minulou data do svého prostředí, postupujte podle následujících pokynů:

  • Nes streamujte živá a historická data paralelně. Příjem dat mimo pořadí způsobí snížení výkonu dotazů.
  • Ingestování historických dat časově seřazeným způsobem pro zajištění nejlepšího výkonu
  • Držte se níže uvedených limitů propustnosti příjmu dat.
  • Zakažte teplé úložiště, pokud jsou data starší než doba uchovávání teplého úložiště.

Časové razítko zdroje událostí

Při konfiguraci zdroje událostí se zobrazí výzva k zadání vlastnosti ID časového razítka. Vlastnost časového razítka se používá ke sledování událostí v průběhu času. Jedná se o čas, který se použije jako časové razítko $ts v rozhraních API pro dotazy a pro vykreslení řad v průzkumníku Azure Time Series Insights. Pokud při vytváření není k dispozici žádná vlastnost nebo pokud v události chybí vlastnost časového razítka, použije se jako výchozí IoT Hub události nebo čas zařazení do fronty služby Events Hubs. Hodnoty vlastností časového razítka jsou uloženy v UTC.

Obecně platí, že se uživatelé rozhodnou přizpůsobit vlastnost časového razítka a použijí čas, kdy senzor nebo značka vygenerovaly čtení, místo výchozího času zařazení centra do fronty. To je nezbytné zejména v případě, že zařízení mají přerušovanou ztrátu připojení a do Azure Time Series Insights Gen2 se přeposílají dávky zpožděných zpráv.

Pokud se vaše vlastní časové razítko nachází v rámci vnořeného objektu JSON nebo pole, budete muset zadat správný název vlastnosti podle našich konvencí zploštělování a úniku názvů. Například časové razítko zdroje událostí pro datovou část JSON, která je zde zobrazená, by mělo být zadáno jako "values.time".

Posuny časových pásem

Časová razítka musí být odeslána ve formátu ISO 8601 a budou uložena ve formátu UTC. Pokud je k dispozici posun časového pásma, použije se posun a pak se čas uloží a vrátí ve formátu UTC. Pokud je posun nesprávně naformátovaný, bude ignorován. V situacích, kdy vaše řešení nemusí mít kontext původního posunu, můžete odeslat data posunu v další samostatné vlastnosti události, abyste zajistili, že se zachová a že vaše aplikace může odkazovat v odpovědi na dotaz.

Posun časového pásma by měl být naformátovaný jako jeden z následujících způsobů:

±HHMMZ
±HH:MM
±HH:MMZ

Další kroky