Azure Data Explorer

Připravte Azure prostředí

V Azure vytvořte Service Principal, uložte Application ID, Tenant ID a secret. Potom vytvořte Azure Data Explorer cluster a databázi. U bezplatného clusteru počítejte s queueing ingestion a v průvodci zapněte queueing client.

Vytvořte tabulku pro stavy

V databázi dejte Service Principalu práva ingestor a viewer. Vytvořte tabulku s poli entity_id, state, attributes, last_changed, last_updated a context a přidejte JSON ingestion mapping pro příchozí stavové zprávy.

Přidejte integraci

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Azure Data Explorer a zadejte údaje z Azure: tenant, client, secret, ingestion URI, databázi a tabulku.

Omezte posílaná data

Bez filtru se posílají všechny stavy. U větších instalací nastavte filtr v configuration.yaml.

azure_data_explorer:
  filter:
    include_domains:
      - light
      - sensor
    exclude_entities:
      - sensor.test

Azure příprava

Připravte Service Principal, Application ID, Tenant ID a secret. V Azure Data Explorer vytvořte cluster, databázi, tabulku a JSON ingestion mapping pro stavové události.

U bezplatného clusteru počítejte s queueing ingestion. Při přidání integrace zapněte queueing client, pokud používáte free variantu.

Filtry a objem dat

Bez filtru se posílají všechny entity. U běžné domácnosti to může být velký objem událostí, u větší instalace velmi rychle naroste i cena a nároky na dotazy.

Filtrujte domény, entity nebo glob patterny. Nejprve pošlete jen několik testovacích domén a až potom rozsah rozšiřujte.

Kontrola ingestu

Po přidání spusťte jednoduchý dotaz nad cílovou tabulkou a ověřte, že přichází nové řádky se správným časem, entitou a atributy.

Při změně mapování nebo názvu tabulky upravte konfiguraci integrace a proveďte test jednou vybranou entitou, než znovu povolíte celý rozsah dat.

Finální kontrola

Pro produkční provoz nastavte v Azure monitoring ingestu a chyb. Pokud se data přestanou zapisovat, správce musí dostat upozornění dřív, než se problém projeví v reportech.