Sdílet prostřednictvím


Zdroje událostí Azure Time Series Insights Gen2

Poznámka

Služba Time Series Insights bude vyřazena 7. července 2024. Zvažte migraci stávajících prostředí na alternativní řešení co nejdříve. Další informace o migraci a vyřazení 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 musí být odeslány 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 skupině prostředků se vytvoří samostatný prostředek typu Time Series Insights event source. Prostředky IoT Hub nebo Event Hub můžou být ve stejném předplatném Azure jako vaše prostředí Azure Time Series Insights Gen2 nebo v jiném předplatném. Osvědčeným postupem je ale uložit prostředí Azure Time Series Insights a ioT Hub nebo centrum událostí ve stejné oblasti Azure.

Můžete použít Azure Portal, Azure CLI, šablony Azure Resource Managerua REST API pro vytváření, úpravy nebo odstraňování zdrojů událostí vašeho prostředí.

Varování

Neomezovat přístup k veřejnému internetu k centru nebo zdroji událostí používanému službou Time Series Insights nebo dojde k přerušení potřebného připojení.

Možnosti spuštění

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

Jméno Popis Příklad šablony Azure Resource Manageru
Dostupné nejdříve Ingestování všech předem existujících dat uložených v IoT nebo Centru událostí "ingressStartAt": {"type": "EarliestAvailable"}
Čas vzniku zdroje události Začněte přijímat data, která přicházejí po vytvoření zdroje událostí. Všechna existující data streamovaná před vytvořením zdroje událostí budou ignorována. Toto je výchozí nastavení na webu Azure Portal. "ingressStartAt": {"type": "EventSourceCreationTime"}
CustomEnqueuedTime Vaše prostředí bude ingestovat data z vašeho vlastního frontového času (UTC). Všechny události, které byly vloženy do vašeho IoT nebo Centra událostí v době nebo po čase, který jste nastavili pro zařazení, se budou přijímat a ukládat. Všechny události, které přišly před vaším vlastním nastaveným časem pro zařazení do fronty, budou ignorovány. Všimněte si, že "čas zařazení do fronty" se vztahuje na čas (v UTC), kdy událost dorazila do vašeho IoT nebo centra událostí. To se liší od vlastní hodnoty časového razítka , která se nachází v textu vaší události. "ingressStartAt": {"type": "CustomEnqueuedTime", "time": "2021-03-01T17:00:00.20Z"}

Důležitý

  • Pokud vyberete EarliestAvailable a máte hodně předchozích dat, můžete zaznamenat vysokou počáteční latenci, protože prostředí Azure Time Series Insights Gen2 zpracovává všechna vaše data.
  • Tato vysoká latence by se nakonec měla zmírnit, protože se data indexují. Pokud zažíváte přetrvávající vysokou latenci, odešlete lístek podpory prostřednictvím portálu Azure.
  • Nejdříve k dispozici

diagramu s nejstarší dostupností

  • ČasVytvořeníZdrojeUdálosti

diagramu EventSourceCreationTime

  • CustomEnqueuedTime

diagramu CustomEnqueuedTime

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

  • Vždy vytvořte jedinečnou skupinu příjemců pro prostředí Azure Time Series Insights Gen2, která bude využívat data ze zdroje událostí. Opakované nasazení 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 službu IoT Hub nebo Event Hubs ve stejné oblasti Azure. I když je možné nakonfigurovat zdroj událostí v samostatné oblasti, tento scénář se nepodporuje a nemůžeme zaručit vysokou dostupnost.

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

  • Konfigurujte upozornění na zpoždění , abyste byli upozorněni, pokud vaše prostředí zažívá problémy se zpracováním dat. Informace o navrhovaných podmínkách upozornění najdete v části Produkční úlohy níže.

  • Streamování ingestování používejte jenom pro téměř v reálném čase a nedávná data, streamování historických dat se nepodporuje.

  • Chápat, jak budou vlastnosti upraveny a jak budou JSON data zploštěna a uložena.

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

Opatrnost

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 neingestují, dokud tento krok nedokončíte.

Produkční úlohy

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

  • Zvyšte dobu uchovávání dat ioT Hubu nebo centra událostí na maximálně sedm dnů.

  • Vytvořte upozornění na prostředí v Azure portálu. Upozornění založená na metrikách platformy umožňují ověřit chování kompletního kanálu. Pokyny pro vytváření a správu upozornění jsou zde. Navrhované podmínky upozornění:

    • IngressReceivedMessagesTimeLag je větší než 5 minut
    • IngressReceivedBytes je 0
  • Udržujte vyvážené zatížení příjmu dat mezi oddíly IoT Hubu nebo Event Hubu.

Historický příjem dat

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

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

Časové razítko zdroje události

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. Toto je čas, který se použije jako časové razítko $ts v rozhraních API pro dotazy a k vykreslení řad v Průzkumníku služby Azure Time Series Insights. Pokud při vytvoření není zadána žádná vlastnost, nebo pokud událost postrádá vlastnost časového razítka, pak se jako výchozí použije čas zařazení do fronty služby IoT Hub nebo Events Hubs. Hodnoty vlastností časového razítka jsou uloženy v UTC.

Obecně platí, že uživatelé se rozhodnou přizpůsobit vlastnost časového razítka a použít čas, kdy senzor nebo značka vygenerovaly čtení, a nebudou používat výchozí čas vytvoření fronty centra. To je zvlášť potřebné v případě, že zařízení mají přerušovanou ztrátu připojení a do Azure Time Series Insights Gen2 se přepošle dávka zpráv se zpožděním.

Pokud je vaše vlastní časové razítko ve vnořeném objektu JSON nebo poli, budete muset uvést správný název vlastnosti v souladu s našimi konvencemi pojmenování, které se řídí pravidly vyrovnávání a escapingu . Například časové razítko zdroje událostí pro datovou část JSON zobrazené zde 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 standardu UTC. Pokud je zadán posun časového pásma, posun bude použit a poté bude čas uložen a vrácen ve formátu UTC. Pokud je posun nesprávně naformátovaný, nebude brán v úvahu. V situacích, kdy vaše řešení nemusí mít kontext původního posunu, můžete odeslat data o posunu jako další samostatnou vlastnost události, aby se zajistilo, že je zachována, a aby na ni vaše aplikace mohla odkazovat v odpovědi na dotaz.

Posun časového pásma by měl být formátován jedním z následujících způsobů:

±HHMMZ
±HH:MM
±HH:MMZ

Další kroky