Prometheus | RichPear Home dokumentace

00

Co návod pokrývá

Návod popisuje praktické zapojení integrace Prometheus v RichPear Home, přípravu účtu nebo zařízení, kontrolu entit a zásady bezpečného použití v automatizacích.

Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

Hlavní témata

Nastavení
Nastavení filtrů
Kompletní příklad
Metriky v nedostupném nebo neznámém stavu
Podporované metriky
Související témata

01

Příprava

Potřebujete běžící Prometheus server, síťový přístup na endpoint RichPear Home a promyšlený rozsah metrik. Před zapnutím si určete, které entity mají být exportované.

Nastavení provádějte z účtu správce. Před přidáním si připravte názvy místností, očekávané entity a pravidla, kde se smí integrace používat.

Před prvním testem

Nejdřív ověřte dostupnost účtu, zařízení nebo služby mimo automatizace. Teprve potom zapojujte hodnoty do scén, notifikací nebo řízení domácnosti.

02

Nastavení v RichPear Home

V konfiguraci zapněte integraci Prometheus a nastavte filtry. Na straně Promethea přidejte scrape job s URL systému, například http://rphome.local:8123, nebo použijte http://IP-ADRESA:8123, pokud lokální jméno nefunguje.

Po dokončení nastavení otevřete detail integrace v části Nastavení, Zařízení a služby. Zkontrolujte vytvořená zařízení, pojmenujte je podle skutečného umístění a vypněte entity, které nechcete používat.

Lokální adresa systému

Při práci v místní síti používejte http://rphome.local:8123. Pokud se lokální jméno nepřeloží, otevřete systém přes http://IP-ADRESA:8123.

CFG

Ukázka konfigurace

Ukázku berte jako výchozí kostru. Konkrétní adresy, názvy, klíče a seznam entit upravte podle vlastní instalace.

prometheus:
  filter:
    include_domains:
      - sensor
      - binary_sensor

03

Filtry entit

Neexportujte bez rozmyslu úplně všechno. Velký počet entit zvyšuje kardinalitu metrik, zatěžuje Prometheus a komplikuje alerty. Začněte systémovými, energetickými a kritickými provozními hodnotami.

Po změně nastavení vždy ověřte chování přímo v RichPear Home. Otevřete detail integrace, sledujte stav entit a porovnejte ho s reálným zařízením nebo službou, aby se do automatizací nedostal špatný předpoklad.

04

Metriky a názvy

Názvy entit v RichPear Home ovlivňují čitelnost metrik. Před dlouhodobým nasazením sjednoťte pojmenování důležitých senzorů, aby grafy a pravidla zůstaly pochopitelné.

Po změně nastavení vždy ověřte chování přímo v RichPear Home. Otevřete detail integrace, sledujte stav entit a porovnejte ho s reálným zařízením nebo službou, aby se do automatizací nedostal špatný předpoklad.

05

Bezpečnost endpointu

Endpoint s metrikami nevystavujte veřejně. Pokud Prometheus běží mimo domácí síť, použijte zabezpečené spojení a omezený přístup jen z konkrétní adresy.

Po změně nastavení vždy ověřte chování přímo v RichPear Home. Otevřete detail integrace, sledujte stav entit a porovnejte ho s reálným zařízením nebo službou, aby se do automatizací nedostal špatný předpoklad.

99

Kontrola po nasazení

Po nastavení integrace Prometheus sledujte alespoň jeden běžný provozní cyklus. U cloudových integrací počítejte se zpožděním, u lokálních zařízení ověřte chování po restartu routeru, zařízení i RichPear Home.

Do automatizací vkládejte jen hodnoty, které jste viděli v reálném provozu. Důležité akce doplňte podmínkou dostupnosti entity a rozumnou prodlevou, aby jednorázový výpadek nespustil chybnou reakci.

Před předáním běžným uživatelům ověřte názvy entit, práva uživatelů a chování při nedostupnosti služby. U zařízení, která něco fyzicky spínají nebo řídí, ponechte dostupné i ruční ovládání mimo automatizace.

Hotový provozní test

Integrace je připravená pro běžné použití, když se entity aktualizují, názvy odpovídají skutečným zařízením a automatizace mají ošetřený výpadek nebo nedostupný stav.