Integrace RichPear Home

Aktivita

Aktivita zobrazuje změny v domácnosti v obráceném časovém pořadí. Nejde o běžnou integraci přidávanou průvodcem; je to systémová funkce domény logbook, která čte data uložená integrací recorder.

Zkontrolovat panel Zpět na audit

Doména: logbook
Název v UI: Aktivita
Závislost: recorder
Nastavení: default_config nebo YAML

Otevřete panel Aktivita

V levém menu otevřete Aktivita, případně přejděte přímo na http://rphome.local:8123/logbook. Panel ukazuje poslední změny entit, události a vlastní záznamy vytvořené akcí logbook.log.

Časový rozsah můžete měnit nahoře v panelu. Tlačítko Přidat cíl slouží k omezení zobrazení na vybranou entitu, oblast nebo zařízení.

Panel Aktivita v českém RichPear Home s časovým rozsahem a záznamy změn entit.

Ověřte, že je Aktivita zapnutá

Ve výchozí instalaci RichPear Home je Aktivita zapnutá přes default_config:. Ruční zásah je potřeba jen tehdy, když jste default_config: odstranili nebo používáte vlastní minimalistickou konfiguraci.

V takovém případě přidejte do configuration.yaml doménu logbook a po kontrole konfigurace restartujte RichPear Home.

Minimální konfigurace

# configuration.yaml
logbook:

Počítejte se stejným úložištěm jako u Historie

Aktivita používá data z integrace recorder. Pokud máte recorder nastavený na MySQL nebo PostgreSQL, Aktivita čte z tohoto úložiště a nepoužívá samostatnou SQLite databázi.

To je důležité hlavně u filtrování: skrytí záznamů v logbook nešetří místo v databázi. Pokud chcete omezit, co se vůbec ukládá, nastavujte filtr také v recorder.

Senzory s jednotkou měření, například teplotní nebo energetické senzory, se považují za často se měnící a Aktivita je automaticky nezobrazuje.

Omezte záznamy pomocí include a exclude

Bez vlastního filtru Aktivita používá filtr z recorder. V logbook můžete nastavit include a exclude pro konkrétní entity, celé domény nebo vzory entit.

Vzory v entity_globs podporují * pro libovolný počet znaků a ? pro žádný nebo jeden znak.

Typický filtr

logbook:
  include:
    domains:
      - alarm_control_panel
      - light
    entity_globs:
      - binary_sensor.*_occupancy
  exclude:
    entities:
      - light.kitchen_light

Zvolte správný typ filtru

Pokud použijete jen exclude, zobrazí se vše kromě vyjmenovaných entit, vzorů nebo domén. Pokud použijete jen include, zobrazí se jen vyjmenované položky.

Kombinace include a exclude dává smysl hlavně tehdy, když chcete zobrazit celou doménu a z ní vynechat několik hlučných entit.

Příklad jen s exclude

logbook:
  exclude:
    entities:
      - sensor.last_boot
      - sensor.date
    entity_globs:
      - sensor.weather_*
    domains:
      - sun

Přidejte vlastní záznam přes akci logbook.log

V automatizaci nebo skriptu můžete vytvořit vlastní položku Aktivity akcí logbook.log. Povinné jsou hodnoty name a message; volitelně přidejte entity_id a domain, aby záznam navazoval na konkrétní entitu.

Pokud akci zavoláte bez domain i bez entity_id, záznam se uloží pod doménou logbook. Neodfiltrujte proto doménu logbook, pokud chcete tyto vlastní záznamy v panelu vidět.

Výběr akce logbook.log ve vývojářských nástrojích RichPear Home — Akce `logbook.log` je dostupná ve vývojářských nástrojích pod názvem Log aktivity.

Ukázka skriptu pro vlastní položku

Následující skript přidá do Aktivity čitelnou položku navázanou na světlo v kuchyni. Použijte vlastní entitu a text, který dává smysl ve vaší domácnosti.

Skript v YAML

script:
  add_logbook_entry:
    alias: "Přidat záznam aktivity"
    sequence:
      - action: logbook.log
        data:
          name: Kuchyně
          message: se používá
          entity_id: light.kitchen
          domain: light

Když se záznamy nezobrazují

Nejdřív ověřte, že je spuštěná integrace recorder, že se díváte na správný časový rozsah a že entita není vyloučená filtrem recorder nebo logbook.

U vlastních položek zkontrolujte povinná pole akce logbook.log a filtr domény logbook. U běžných senzorů s jednotkou měření počítejte s automatickým vynecháním z Aktivity.

Panel Aktivita a výběr akce logbook.log byly ověřené v českém RichPear Home. Ruční úpravy YAML konfigurace dělejte jen se zálohou a po kontrole konfigurace.