Průvodce automatizací Home Assistant

Automatizace Home Assistant umožňují automaticky synchronizovat zdravotní data do Home Assistantu jako stavy senzorů. Díky tomu můžete zdravotní data používat v automatizacích Home Assistantu, na dashboardech i v dalších integracích.

Přehled

Automatizace Home Assistant odesílají zdravotní metriky do REST API Home Assistantu a vytvářejí nebo aktualizují stavy senzorů, které lze následně používat v celé instanci Home Assistantu. Data jsou formátována přímo pro API /states/<entity_id> v Home Assistantu.

Případy použití:

• zobrazení zdravotních metrik na dashboardech Home Assistantu
• vytváření automatizací založených na zdravotních datech
• propojení zdravotních dat s dalšími zařízeními chytré domácnosti
• sledování zdravotních trendů v čase přímo v Home Assistantu

Klíčové funkce:

• automatické vytváření stavů senzorů
• pouze formát JSON, optimalizovaný pro Home Assistant
• podpora pouze datového typu Zdravotní metriky
• jednoduchá konfigurace URL

Omezení

• Přístup ke zdravotním datům: Aplikace nemají povolen přístup ke zdravotním datům, když je iPhone zamknutý. Automatizace poběží jen v době, kdy je zařízení odemčené. Toto je omezení ze strany Apple, které nelze obejít. Více informací

• Zpracování na pozadí: iOS omezuje běh na pozadí kvůli šetření baterie. Automatizace spoléhají na Obnovení aplikací na pozadí a nemusí se spustit okamžitě, pokud:

  • je pro aplikaci vypnuté Obnovení aplikací na pozadí
  • je zařízení v režimu nízké spotřeby
  • bylo zařízení delší dobu neaktivní
  • jsou systémové prostředky omezené
  • si více aplikací současně nárokuje čas pro běh na pozadí

• podporován je pouze datový typ Zdravotní metriky

• používá se pouze formát JSON a nelze jej změnit

Předpoklady

• Běžící a dostupná instance Home Assistant ve vaší síti
• Přístupový token API Home Assistant (Long-Lived Access Token)
• Síťové připojení k instanci Home Assistant
• Verze Home Assistant s podporou REST API

Konfigurace

Přejděte na obrazovku automatizované exporty v hlavní navigaci, klepněte na „Nová automatizace“ a jako typ automatizace vyberte „Home Assistant“.

Název automatizace

Zadejte výstižný název automatizace. Tento název se použije na vygenerování ID entity senzora v Home Assistant.

Poznámka: Název automatizace se převede na malé písmená a odstraní se mezery, aby vzniklo ID entity. Například „My Health Data“ se změní na hae.myhealthdata.

Oznámení

Nastavte, kdy chcete dostávat oznámení:

• Oznámit při aktualizaci mezipaměti — oznámení při aktualizaci dat v mezipaměti
• Oznámit při spuštění — oznámení při každém spuštění automatizace

URL Home Assistant

Zadejte základní URL instance Home Assistant. Mala by zahrnovat protokol a port, pokud nepoužíváte výchozí port.

Příklady URL:

• http://homeassistant.local:8123
• http://192.168.1.100:8123

Poznámka: URL musí být ze zařízení dostupná. Při HTTPS se ujistěte, že je certifikát platný nebo přidejte výjimku.

Automaticky generovaný endpoint

Aplikace automaticky vygeneruje úplný endpoint API podle názvu automatizace:

{your_url}/api/states/hae.{automation_name}

Například pokud je vaša URL http://homeassistant.local:8123 a název automatizace je „Health Metrics“, endpoint bude:

http://homeassistant.local:8123/api/states/hae.healthmetrics

Tento endpoint se zobrazuje pod poľom URL jako referencia.

Časový limit požiadavky

Vyberte interval časového limitu pre HTTP požiadavky na Home Assistant.

Dostupné možnosti časového limitu:

• 60 sekund — výchozí, vhodné pro většinu instancí Home Assistant
• 300 sekúnd (5 minút) — pre pomalšie instance Home Assistant
• 1800 sekúnd (30 minút) — při veľmi pomalom spracovaní
• 3600 sekúnd (1 hodina) — maximálny odporúčaný časový limit

HTTP hlavičky

Pridajte autentifikačné hlavičky pre prístup k API Home Assistant. Musíte pridať hlavičku Authorization s Long-Lived Access Tokenom.

Povinná hlavička:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Získane Long-Lived Access Tokenu:

1. Otevřete Home Assistant
2. Přejděte do profilu (klepněte na svoje meno vľavo dole)
3. Posuňte se nadol na „Long-Lived Access Tokens“
4. Klepněte na „Create Token“
5. Zadejte název (napr. „Health Auto Export“)
6. Skopírujte token a vložte ho do poľa hodnoty hlavičky

Voliteľné hlavičky:
Podľa potreby můžete pridať ďalšie hlavičky pre vaše nastavení Home Assistant.

Přidání hlaviček:

1. Klepněte na „Přidat hlavičky“
2. Zadejte kľúč hlavičky do ľavého poľa
3. Zadejte hodnotu hlavičky do pravého poľa
4. Opakujte pre ďalšie hlavičky

Důležité: Každý kľúč hlavičky musí mať zodpovedajúcu hodnotu. Prázdne hlavičky se ignorují.

Nastavení typu dat

Typ dat

Poznámka: Automatizace Home Assistant podporují len typ dat Zdravotní metriky. Toto nastavení se nelze změnit a automaticky se nastaví na Zdravotní metriky.

Konfigurace zdravotných metrík

Vybrat zdravotní metriky — vyberte konkrétne metriky na zahrnutie. Môžete vybrat všechna dostupné metriky nebo len vybrané.

Tip: Výber len potrebných metrík může skrátiť čas spracovania a zmenšiť objem dat odoslaných do Home Assistant.

Preferované zdroje — nastavte, ktoré zdroje dat mají prednosť, keď viac zdrojov poskytuje rovnakú metriku.

Nastavení exportu

Formát exportu

Poznámka: Automatizace Home Assistant podporují len formát JSON. Toto nastavení se nelze změnit a automaticky se nastaví na JSON.

Verze exportu

Poznámka: Verze exportu není pre automatizace Home Assistant k dispozícii, pretože je formát optimalizovaný špecificky pre state API Home Assistant.

Rozsah dat

Vyberte, kdy se mají data exportovat:

• Predvolené — synchronizuje data za celý predchádzajúci deň plus data do aktuálního data a času
• Dnes — synchronizuje všechna data za aktuální den do aktuálního času
• Včera — synchronizuje všechna data za celý predchádzajúci deň

Poznámka: Automatizace Home Assistant nepodporují možnosti „Real Time“, „Since Last Sync“ ani „Previous 7 Days“.

Zhrnúť data

Zapnite nebo vypnite zhrnutie dat pre Zdravotní metriky.

• Zapnuté — poskytuje agregované súhrny dat (predvolené)
• Vypnuté — kde je to možné, poskytuje neagregované data

Poznámka: Toto nastavení platí len pre typ dat Zdravotní metriky.

Časové seskupení

Při zapnutém souhrnných dat dat vyberte, jako se mají data agregovat:

• Predvolené — bez agregácie, surové body dat
• Dni — zoskupuje data po dňoch (odporúčané)

Frekvence synchronizace

Nastavte, jako často má automatizace synchronizovat data s Home Assistant:

Vyberte číslo a interval.

Testování a ověření

Ověření v Home Assistant

1. Otevřete Home Assistant
2. Přejděte na Nástroje pre vývojárov > Stavy
3. Vyhľadajte hae.{název_vaší_automatizace} (malé písmená, bez medzier)
4. Ověřte, či stav senzora zobrazuje vaše zdravotní data
5. Zkontrolujte časové razítko „Last Updated“, či potvrdzuje nedávne synchronizácie

Kontrola logov Home Assistant

Ak se data v Home Assistant nezobrazujú:

1. Otevřete Home Assistant
2. Přejděte na Nastavení > Systém > Logy
3. Hľadajte chyby súvisiace s REST API nebo stavmi senzorov
4. Zkontrolujte chyby autentifikácie nebo neplatný formát dat

Řešení problémů

Časté problémy

Chyby autentifikácie

• Ověřte správnosť Long-Lived Access Tokenu
• Ujistěte se, že hlavička Authorization má formát: Bearer VÁŠ_TOKEN
• Zkontrolujte, či platnosť tokenu nevypršala a či nebol zrušený
• Ověřte, či má token v Home Assistant vhodné oprávnenia

Senzor se nezobrazuje v Home Assistant

• Zkontrolujte, či název automatizace neobsahuje špeciálne znaky
• Ověřte formát ID entity: hae.{název_automatizace} (malé písmená, bez medzier)
• Pozrite logy Home Assistant kvôli chybám
• Ujistěte se, že požiadavka API bola úspešná (skontrolujte protokoly aktivít)

Data se neaktualizujú

• Zkontrolujte, či je automatizace zapnutá
• Pozrite protokoly aktivít kvôli chybám
• Ujistěte se, že existuje sieťové připojení k Home Assistant

Časový limit pripojenia

• Ověřte, či Home Assistant beží a je dostupný
• Zkontrolujte sieťové pripojenie
• Ak Home Assistant pomaly odpovedá, zvýšte nastavení časového limitu požiadavky
• Ověřte správnosť URL a portu

Chybové zprávy

Aplikace zobrazí chybové hlásenia, pokud napríklad:

• URL je neplatná nebo nedostupná,
• autentifikácia zlyhá (skontrolujte hlavičku Authorization),
• Home Assistant vráti chybový stavový kód,
• sieťové připojení není k dispozícii.

Podrobné informácie o chybách nájdete v denníkoch aktivít vrátane HTTP stavových kódov a chybových hlásení z Home Assistant.

Tipy na integráciu s Home Assistant

Použitie zdravotných dat v automatizáciách

Keď se zdravotní data synchronizujú do Home Assistant, můžete ich používať v automatizáciách:

automation:
  - alias: "Good Sleep Quality"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Great sleep last night!"

Tvorba dashboardov

Pridajte zdravotní metriky na dashboard Home Assistant:

1. Přejděte na svoj dashboard
2. Pridajte novú kartu
3. Vyberte typ karty „Entities“ nebo „Gauge“
4. Pridajte entity senzorov hae.{název_vaší_automatizace}

Štruktúra stavu senzora

Stav senzora v Home Assistant obsahuje:

• state: aktuálna hodnota nebo stav
• attributes: ďalšie data vrátane:
  • informácií o časových razítkach
  • štruktúry dat zodpovedajúcej exportovanému formátu JSON
  • informácií o jednotkách, kde je to relevantné

Tipy a osvědčené postupy

1. Automatická synchronizácia:

   • Nabíjejte zariadene a používajte Zrcadlení iPhonu iPhonu
     • Pri nabíjaní iOS menej omezuje výkon zařízení, takže se data mohou synchronizovat častejšie
     • Pri zrkadlení iPhonu se zariadene správa stejně jako při odemčení. Zdravotní data jsou tpokud pre Health Auto Export dostupné na spouštění automatizovaných akcí

2. Pomenovanie:

   • Vyhnite se špeciálnym znakom, ktoré by mohli spôsobiť problémy

3. Výber dat:

   • Vyberte len metriky, ktoré potrebujete

Zobrazene protokolů aktivít

1. Klepněte na Zobrazit protokoly aktivít na obrazovce konfigurace automatizace.
2. Zkontrolujte běhy (zoskupené, najnovšie prvé) a rozbaliť udalosti v rámci každého behu.
3. Rozlište varování (napr. pomalý dotaz na zdravotní data) od chyby (zlyhania publikovania entity nebo pripojenia)—pozrite Prehľad automatizácií — Protokoly aktivít.
4. Beh Home Assistant může zaznamenávať výsledky podle entity; beh může byť čiastočne úspešný, keď se niektoré entity aktualizujú a iné zlyhajú.
5. Zdieľať (panel nástrojov) exportuje úplné diagnostické ZIP Protokoly udalostí aplikácie pre podporu (rovnaké jako Nastavení → Pokročilé).
6. Vymazať odstráni iba históriu aktivít tejto automatizace.