Zdroje událostí Azure Time Series Insights Gen2

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:

• Azure IoT Hub
• Azure Event Hubs

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 vaším 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 Hubu 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 uložit prostředí Azure Time Series Insights a ioT Hub nebo centrum událostí ve stejné oblasti Azure.

Pomocí webu Azure Portal, Azure CLI, šablon Azure Resource Manageru a rozhraní REST API můžete vytvářet, upravovat nebo odebírat zdroje událostí vašeho prostředí.

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 nepovinné. Existují tyto možnosti:

• Nejdříve k dispozici

• EventSourceCreationTime

• 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řechávejte nad rámec limitu propustnosti vašeho prostředí nebo limitu počtu oddílů.

• Pokud ve vašem prostředí dochází k problémům se zpracováním dat, nakonfigurujte upozornění na prodlevu. Navrhované podmínky upozornění najdete níže v produkčních úlohách .

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

• Porozumíte tomu, jak budou vlastnosti řídicími znaky a data JSON zploštěná a uložená.

• Při poskytování připojovací řetězec zdrojů událostí dodržujte zásadu nejnižšího oprávnění. Pro službu Event Hubs nakonfigurujte zásady sdíleného přístupu pouze s deklarací identity odesílání a pro IoT Hub použijte pouze oprávnění pro připojení ke službě.

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ů.

• Vytváření upozornění prostředí na webu Azure Portal Upozornění založená na metrikách platformy umožňují ověřit chování kompletního kanálu. Tady jsou pokyny pro vytváření a správu upozornění. 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 Hubu nebo centra událostí.

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ů.
• Ingestování historických dat podle času pro zajištění nejlepšího výkonu
• Zůstaňte v limitech propustnosti příjmu dat níže.
• 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á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. Toto je čas, který se použije jako časové razítko $ts v rozhraních API dotazů a k vykreslení řad v Průzkumníku služby Azure Time Series Insights. Pokud v době vytvoření není k dispozici žádná vlastnost nebo pokud vlastnost časového razítka v události chybí, použije se jako výchozí hodnota čas vytvoření fronty služby IoT Hub nebo Event Hubs události. 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 nezbytné zejména v případě, že zařízení mají občasnou ztrátu připojení a do Azure Time Series Insights Gen2 se přepošla dávka zpožděných zpráv.

Pokud je vaše vlastní časové razítko vnořeného objektu JSON nebo pole, budete muset zadat správný název vlastnosti podle našich konvencí pro zploštění a odvozování názvů. 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 zadaný posun časového pásma, použije se posun a čas uložený a vrácený 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 posun dat v další samostatné vlastnosti události, aby se zajistilo, že je zachována a že vaše aplikace může odkazovat v odpovědi dotazu.

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

• Přečtěte si pravidla zploštění a eskapace JSON, abyste pochopili, jak se budou ukládat události.

• Vysvětlení omezení propustnosti vašeho prostředí