Integrace RichPear Home
Logger
Logger řídí úroveň logování RichPear Home. Pomáhá ztišit běžné záznamy, nebo naopak dočasně zapnout podrobné logy pro konkrétní integraci.
- Doména
logger- Kategorie
- utility
- Komunikace
- neuvedeno
- Kvalita
- internal
Příprava
Než změníte logování, určete konkrétní komponentu nebo namespace, který potřebujete sledovat. Zapnutí podrobného logování pro celý systém může vytvořit zbytečně velké logy.
Integrace se nastavuje v konfiguraci a pokročilé změny vyžadují znalost názvů komponent. Pro krátkou diagnostiku lze použít i služby pro změnu úrovně za běhu.
Lokální adresa
Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.
Nastavení
Do konfigurace přidejte logger a nastavte defaultní úroveň nebo konkrétní položky v mapě logs. Po kontrole konfigurace restartujte systém.
Pro dočasné ladění použijte akce logger.set_level nebo logger.set_default_level. Po dokončení diagnostiky vraťte úroveň zpět na běžnou hodnotu.
Úrovně logů
Běžné úrovně jsou debug, info, warning, error, critical a fatal. Čím podrobnější úroveň nastavíte, tím víc záznamů se bude ukládat.
Pro běžný provoz je vhodné držet rozumně tichou výchozí úroveň a podrobně logovat jen konkrétní problémovou integraci.
Filtry
Logger podporuje filtry přes regulární výrazy. Ty se hodí, když některá komponenta opakovaně zapisuje známou nevýznamnou hlášku.
Filtry používejte opatrně. Příliš široký filtr může skrýt důležitý problém a ztížit pozdější servis.
Zobrazení logů
Logy sledujte v rozhraní RichPear Home nebo podle typu instalace přímo v souborech a výstupech kontejneru. Při předávání podpory přikládejte jen relevantní část.
Po úpravě logování si poznamenejte, co jste změnili a proč. Dočasné debug logování by nemělo zůstat zapnuté trvale.
Kontrola po nasazení
Po prvním dni provozu projděte historii entit integrace Logger. Sledujte, zda se hodnoty aktualizují podle typu komunikace neuvedeno a zda se v logu neopakují stejné chyby nebo odpojení.
Pokud integrace ovládá reálné zařízení, cloudový účet nebo ruční konfiguraci, nechte správcům jasný postup pro vypnutí automatizace a návrat k ručnímu ovládání. Zapište si také místo, kde se spravuje token, IP adresa, párování nebo konfigurační soubor.