Průvodce automatizací MQTT

Automatizace MQTT umožňují automaticky publikovat zdravotní data do MQTT brokeru. To je ideální pro integraci s IoT platformami, systémy domácí automatizace nebo jakoukoli službou, která podporuje MQTT zprávy.

Přehled

Automatizace MQTT publikují zdravotní data jako JSON zprávy do zadaného MQTT topicu na brokeru MQTT. Data se odesílají pokaždé, když se automatizace spustí podle nastavené frekvence synchronizace.

Případy použití:

• integrace s IoT platformami, například Home Assistant nebo OpenHAB
• publikování zdravotních dat do dashboardů založených na MQTT
• systémy pro sledování zdraví v reálném čase
• vlastní integrace domácí automatizace
• platformy pro logování a analýzu dat

Klíčové funkce:

• pouze formát JSON, optimalizovaný pro MQTT
• podpora ověřených i anonymních připojení
• nastavitelná struktura topiců
• správa Client ID
• volitelné ověřování pomocí jména a hesla

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í

• pouze formát JSON a nelze jej změnit

• vyžaduje MQTT broker, lokální nebo cloudový

Předpoklady

• MQTT broker, například Mosquitto, HiveMQ nebo AWS IoT Core
• síťové připojení k MQTT brokeru
• IP adresu nebo hostname brokeru
• číslo portu
• volitelně uživatelské jméno a heslo, pokud broker vyžaduje ověřování

Konfigurace

V hlavní navigaci přejděte na obrazovku automatizované exporty, klepněte na „Nová automatizace“ a jako typ automatizace vyberte „MQTT“.

Název automatizace

Zadejte popisný název automatizace, například „Home Assistant MQTT“ nebo „Cloud MQTT Broker“.

Oznámení

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

• Oznámit při aktualizaci mezipaměti - dostanete oznámení při aktualizaci dat v mezipaměti
• Oznámit při spuštění - dostanete oznámení pokaždé, když automatizace publikuje data

Konfigurace brokeru

IP adresa

Zadejte IP adresu nebo hostname MQTT brokeru.

Příklady:

• 192.168.1.100 (lokální IP adresa)
• mqtt.example.com (hostname)
• broker.hivemq.com (cloudový MQTT broker)
• localhost (pokud běží na stejném zařízení, pro iOS se to nedoporučuje)

Poznámka: Pro lokální brokery v síti používejte IP adresy a pro cloudové brokery hostname. Ujistěte se, že je broker z vašeho zařízení dostupný.

Port

Zadejte číslo portu pro MQTT broker.

Poznámka: Výchozí port je 1883.

Topic

Zadejte MQTT topic, do kterého se budou zdravotní data publikovat. Tento topic budou odběratelé používat pro příjem dat.

Příklady topiců:

• health/data
• home/health/metrics
• user/health/export
• hae/automation-name

Doporučení pro topicy:

• používejte lomítka / pro vytváření hierarchie topiců
• používejte popisné názvy, které naznačí typ dat
• vyhýbejte se mezerám a speciálním znakům
• pokud máte více automatizací, zvažte zahrnutí názvu automatizace

Poznámka: Název topicu rozlišuje malá a velká písmena. Odběratelé musí používat přesně stejný název.

ID klienta

Zadejte jedinečné Client ID pro toto MQTT připojení. Tím se vaše zařízení identifikuje vůči MQTT brokeru.

Příklady Client ID:

• health-export-iphone
• hae-client-001
• ios-health-app

Uživatelské jméno (volitelné)

Zadejte uživatelské jméno pro ověřování na MQTT brokeru. Pokud broker ověřování nevyžaduje, pole nechte prázdné.

Heslo (volitelné)

Zadejte heslo pro ověřování na MQTT brokeru. Pokud broker ověřování nevyžaduje, pole nechte prázdné.

Nastavení typu dat

Typ dat

Vyberte, jaký typ zdravotních dat chcete exportovat:

• Zdravotní metriky - kroky, tepová frekvence, spánek a další zdravotní měření
• Tréninky - cvičení a fitness aktivity
• Příznaky - zdravotní příznaky a stavy
• EKG - záznamy elektrokardiogramu
• Oznámení o srdeční frekvenci - události vysoké a nízké tepové frekvence
• Duševní stav - záznamy nálady a duševního stavu (iOS 18.0+)
• Sledování cyklu - data o menstruačním cyklu a reprodukčním zdraví
• Léky - záznamy o lécích a dodržování léčby (iOS 26.0+)

Konfigurace zdravotních metrik

Když vyberete Zdravotní metriky:

Vybrat zdravotní metriky - zvolte, které konkrétní metriky chcete zahrnout. Můžete vybrat všechny dostupné metriky nebo jen některé.

Tip: Výběr jen potřebných metrik zmenší velikost zpráv a zkrátí dobu zpracování.

Preferované zdroje - nastavte, které zdroje dat mají mít přednost, když stejnou metriku poskytuje více zdrojů.

Konfigurace tréninků

Když vyberete Tréninky:

Zahrnout data trasy - zapněte, pokud chcete zahrnout trasy u tréninků, které mají polohová data.

Zahrnout metriky tréninku - zapněte, pokud chcete zahrnout zdravotní metriky zaznamenané během tréninků, například tepovou frekvenci nebo kalorie.

Seskupení podle času (metriky tréninku) - když používáte Verzi exportu 2 a máte zapnuté Zahrnout metriky tréninku:

• Minuty – seskupí metriky tréninku po minutách
• Sekundy – seskupí metriky tréninku po sekundách

Nastavení exportu

Formát exportu

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

Verze exportu

Vyberte verzi exportu pre data o trénincích:

• Verze 1 — starší formát
• Verze 2 — aktuální formát s rozšířenými daty o trénincích

Poznámka: Verze exportu ovlivňuje predovšetkým strukturu dat o trénincích, pokud tréninky exportujete.

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
• Od poslednej synchronizácie — při každej synchronizácii exportuje všechna data od posledního spuštění exportu až 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ň
• Posledních 7 dní — synchronizuje data za celých predchádzajúcich sedm dní

Zhrnúť data

Pri formáte JSON a type dat Zdravotní metriky zapnite nebo vypnite zhrnutie dat.

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

Časové seskupení

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

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.

Frekvence synchronizace

Nastavte, jako často má automatizace publikovať data na MQTT:

Vyberte číslo a interval.

Testování a ověření

Použitie MQTT klienta

Ak chcete overiť, že se zprávy publikují:

1. Nastavte MQTT klienta
2. Připojte se k MQTT brokerovi stejnými přihlašovacími dati
3. Přihlaste se na váš tému
4. Spustite manuálny export z aplikácie
5. Ověřte, či se správa zobrazí v MQTT klientovi

Formát zprávy

Zprávy MQTT se publikují jako JSON. Payload zprávy sleduje štandardný formát exportu JSON:

{
  "data": {
    "metrics": [...],
    "workouts": [...],
    ...
  }
}

Správa se publikuje s:

• Topic: podle konfigurace v automatizácii
• QoS: najviac raz doručenie
• Retain: zprávy se neuchovávajú
• Payload: reťazec JSON so zdravotnými daty

Řešení problémů

Časté problémy

Selhání pripojenia

• Ověřte, či je IP adresa nebo hostname brokera správna
• Zkontrolujte, či je port správny a broker na ňom počúva
• Ujistěte se, že existuje sieťové připojení k brokerovi
• Ověřte pravidlá firewallu, ktoré pripúšťajú připojení k brokerovi
• Zkontrolujte, či broker nevyžaduje TLS/SSL

Selhání autentifikácie

• Ověřte správnost jména a hesla
• Zkontrolujte, či je na brokeri zapnutá autentifikácia, pokud posielate prihlasovacie data
• Ujistěte se, že uživatel má oprávnění publikovať na zadaný tému

Zprávy neprichádzajú

• Ověřte presnú zhodu názvu témy (rozlišuje se veľkosť písmen)
• Zkontrolujte, či sú odberatelia pripojení k tomu istému brokerovi
• Ujistěte se, že sú odberatelia přihlášení na správný tému
• Ověřte, či je automatizace zapnutá a beží
• Pozrite protokoly aktivít kvôli chybám při publikovaní

Veľká velikost zprávy

• Znížte počet vybraných zdravotných metrík
• Použijte menej detailnú agregáciu
• Zvažte rozdelene do viacerých automatizácií pre rôzne typy dat

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. Uspořádání tém:

   • Používajte hierarchické štruktúry tém (napr. health/metrics, health/workouts)
   • Zahrňte do tém identifikátory zařízení nebo automatizace
   • Zdokumentujte strukturu tém pre jednoduchú orientáciu

3. Veľkosť správ:

   • Udržujte rozumnú velikost zpráv, aby ste se vyhnuli limitom brokera
   • Méně detailná agregácia znižuje objem dát
   • Pri veľkých súboroch dat zvážte rozdelene do viacerých správ

4. Sledovanie:

   • V aplikácii používajte protokoly aktivít na sledovane úspešnosti publikovania

5. Cloudoví brokeri:

   • Pri použití cloudových MQTT brokerov (AWS IoT, HiveMQ Cloud atď.):
     • Dodržujte ich špecifické požiadavky na pripojenie
     • Zkontrolujte limity veľkosti správ a frekvencie
     • Ověřte konvencie pomenovania tém

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 pripojenia k brokerovi nebo publikovania)—pozrite Prehľad automatizácií — Protokoly aktivít.
4. Zkontrolujte riadky úspešného a neúspešného publikovania pre každý beh.
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.