Azure Event Hub

01

Co integrace přidá

Integrace se napojuje na události systému a odesílá je do Azure. Data pak můžete ukládat přes Capture do Azure Blob Storage nebo Data Lake, zpracovat přes Stream Analytics, poslat do databází, Databricks, Power BI nebo obsloužit Azure Function.

Před zapnutím promyslete rozsah dat. Bez filtru může RichPear Home posílat velké množství událostí a tím zvyšovat náklady i objem citlivých provozních dat v cloudu.

Nastavení vyžaduje Azure účet, Event Hub namespace a konkrétní Event Hub nebo odpovídající IoT Hub.

02

Příprava před přidáním

V Azure vytvořte Event Hub namespace a Event Hub. Připravte connection string nebo údaje vyžadované průvodcem. Pokud posíláte data do IoT Hubu, použijte odpovídající koncový bod a oprávnění.

Předem si určete, které domény nebo entity chcete exportovat. U běžné instalace je lepší začít malým filtrem a rozsah rozšiřovat až po kontrole objemu dat.

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.

03

Nastavení v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Azure Event Hub a projděte průvodce. Pokud používáte ruční konfiguraci, doplňte konfigurační soubor a restartujte RichPear Home.

azure_event_hub:
  filter:
    include_domains:
      - alarm_control_panel
      - light
    include_entity_globs:
      - binary_sensor.*_occupancy
    exclude_entities:
      - light.kitchen_light

Bez filtru se odesílají všechny entity. S filtrem se vyhodnocují include a exclude pravidla podle domén, glob patternů a konkrétních entit.

04

Kontrola entit a funkcí

Po přidání ověřte v Azure, že do Event Hubu přicházejí nové události. Nejdřív testujte jen několik málo domén nebo entit, aby bylo jasné, že mapping a oprávnění fungují.

V logu RichPear Home zkontrolujte případné chyby při odesílání, autorizaci nebo připojení k Azure.

05

Použití v automatizacích

Azure Event Hub je hlavně exportní cesta, ne ovládací integrace. Automatizace používejte spíše pro kontrolu dostupnosti exportu nebo upozornění na chyby v logu.

Pokud data dál zpracováváte v Azure Function nebo Stream Analytics, testujte změny schématu nejdřív na omezeném rozsahu entit.

06

Provoz a údržba

Po změně Event Hubu, connection stringu, filtru nebo cílového zpracování proveďte nový test zápisu. Sledujte objem příchozích zpráv, náklady a případné chyby v Azure metrikách.

Ukládaná data mohou obsahovat názvy entit a atributy domácnosti. Přístup v Azure nastavte jen lidem a službám, které tato data skutečně potřebují.

07

Řešení problémů

Když se data v Azure neobjevují, ověřte connection string, namespace, název Event Hubu, síťovou dostupnost, oprávnění, filtr a chyby po startu. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény azure_event_hub.

Pokud se posílá příliš mnoho dat, dočasně zúžte filtr na jednu testovací doménu a až po stabilizaci jej rozšiřte.