Synchronizácia do MQTT

Automatizácie MQTT umožňujú automaticky publikovať zdravotné údaje na MQTT broker. Hodí sa na integráciu s IoT platformami, systémami domácej automatizácie alebo ľubovoľnou službou s podporou správ MQTT.

Prehľad

Automatizácie MQTT publikujú zdravotné údaje ako JSON správy na zadanú tému MQTT na brokery MQTT. Údaje sa odosielajú pri každom spustení automatizácie podľa nastavení frekvencie synchronizácie.

Prípady použitia:

• Integrácia s IoT platformami (Home Assistant, OpenHAB atď.)
• Publikovanie zdravotných údajov na dashboardy založené na MQTT
• Systémy sledovania zdravia v reálnom čase
• Vlastné integrácie domácej automatizácie
• Logovanie údajov a analytické platformy

Hlavné funkcie:

• Len formát JSON (optimalizovaný pre MQTT)
• Podporuje autentifikované aj anonymné pripojenia
• Konfigurovateľná štruktúra tém
• Správa Client ID
• Voliteľná autentifikácia menom a heslom

Obmedzenia

• Prístup k zdravotným údajom: Aplikácie nemôžu pristupovať k zdravotným údajom, kým je iPhone zamknutý. Automatizácie bežia len vtedy, keď je zariadenie odomknuté. To môže ovplyvniť čerstvosť údajov. Pozrite pokyny na manuálnu synchronizáciu, aby ste údaje udržali aktuálne.

• Spracovanie na pozadí: iOS obmedzuje spracovanie na pozadí kvôli výdrži batérie. Automatizácie závisia od obnovenia aplikácií na pozadí a nemusia sa spustiť okamžite, ak:

  • je pre aplikáciu vypnuté obnovenie aplikácií na pozadí,
  • je zariadenie v úspornom režime,
  • bolo zariadenie dlhší čas neaktívne,
  • sú obmedzené systémové zdroje,
  • viac aplikácií súperí o čas vykonávania na pozadí.

• Len formát JSON (nedá sa zmeniť)

• Vyžaduje MQTT broker (lokálny alebo v cloude)

Predpoklady

• MQTT broker (napr. Mosquitto, HiveMQ, AWS IoT Core atď.)
• Sieťové pripojenie k MQTT brokerovi
• IP adresa alebo hostname brokera
• Číslo portu
• Voliteľne: meno a heslo, ak broker vyžaduje autentifikáciu

Konfigurácia

Prejdite na obrazovku Automatizované exporty v hlavnej navigácii, potom klepnite na „Nová automatizácia“ a ako typ automatizácie vyberte „MQTT“.

Názov automatizácie

Zadajte výstižný názov automatizácie (napr. „Home Assistant MQTT“, „Cloud MQTT broker“).

Upozornenia

Nastavte, kedy chcete dostávať upozornenia:

• Upozorniť pri aktualizácii vyrovnávacej pamäte — upozornenie pri aktualizácii dát vo vyrovnávacej pamäti
• Upozorniť pri spustení — upozornenie pri každom publikovaní údajov automatizáciou

Konfigurácia brokera

IP adresa

Zadajte IP adresu alebo hostname MQTT brokera.

Príklady:

• 192.168.1.100 (lokálna IP adresa)
• mqtt.example.com (hostname)
• broker.hivemq.com (cloudový MQTT broker)
• localhost (ak beží na tom istom zariadení, na iOS neodporúčané)

Poznámka: Pre lokálnych brokerov v sieti používajte IP adresy, pre brokerov v cloude hostnames. Uistite sa, že je broker zo zariadenia dostupný.

Port

Zadajte číslo portu pre MQTT broker.

Poznámka: Predvolený port je 1883.

Téma

Zadajte tému MQTT, na ktorú sa budú publikovať zdravotné údaje. Ide o tému, ktorú odberatelia použijú na príjem vašich zdravotných údajov.

Príklady tém:

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

Odporúčania pre témy:

• Pomocou lomítok (/) vytvárajte hierarchiu tém
• Používajte výstižné názvy podľa typu údajov
• Vyhnite sa medzerám a špeciálnym znakom
• Pri viacerých automatizáciách zvážte zahrnutie názvu automatizácie

Poznámka: Názov témy rozlišuje veľkosť písmen. Uistite sa, že odberatelia používajú presne rovnaký názov témy.

Client ID

Zadajte jedinečný identifikátor klienta pre toto pripojenie MQTT. Identifikuje vaše zariadenie voči MQTT brokerovi.

Príklady Client ID:

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

Meno používateľa (voliteľné)

Zadajte meno používateľa na autentifikáciu voči MQTT brokerovi. Nechajte prázdne, ak broker autentifikáciu nevyžaduje.

Heslo (voliteľné)

Zadajte heslo na autentifikáciu voči MQTT brokerovi. Nechajte prázdne, ak broker autentifikáciu nevyžaduje.

Nastavenia typu údajov

Typ údajov

Vyberte, ktorý typ zdravotných údajov exportovať:

• Zdravotné metriky — kroky, srdcová frekvencia, spánok a ďalšie zdravotné merania
• Tréningy — cvičenia a športové aktivity
• Príznaky — zdravotné príznaky a stavy
• EKG — záznamy elektrokardiogramu
• Upozornenia na srdcovú frekvenciu — udalosti vysokej alebo nízkej srdcovej frekvencie
• Stav mysle — záznamy nálady a duševného stavu (iOS 18.0+)
• Sledovanie cyklu — menštruačný cyklus a reprodukčné zdravotné údaje
• Lieky — záznamy liekov a adherencia (iOS 26.0+)

Konfigurácia zdravotných metrík

Pri výbere Zdravotné metriky:

Vybrať zdravotné metriky — vyberte konkrétne metriky na zahrnutie. Môžete vybrať všetky dostupné metriky alebo len vybrané.

Tip: Výber len potrebných metrík zmenšuje veľkosť správ a skracuje čas spracovania.

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

Konfigurácia tréningov

Pri výbere Tréningy:

Zahrnúť údaje o trase — zapnite, ak chcete zahrnúť trasy pre tréningy, ktoré majú údaje o polohe.

Zahrnúť metriky tréningu — zapnite, ak chcete zahrnúť zdravotné metriky zozbierané počas tréningov (srdcová frekvencia, kalórie atď.).

Časové zoskupenie (metriky tréningu) — pri použití exportnej verzie 2 a zapnutom zahrnutí metrík tréningu:

• Minúty — zoskupuje metriky tréningu po minútach
• Sekundy — zoskupuje metriky tréningu po sekundách

Nastavenia exportu

Formát exportu

Poznámka: Automatizácie MQTT podporujú len formát JSON. Toto nastavenie sa nedá zmeniť a automaticky sa nastaví na JSON.

Verzia exportu

Vyberte verziu exportu pre údaje o tréningoch:

• Verzia 1 — starší formát
• Verzia 2 — aktuálny formát s rozšírenými údajmi o tréningoch

Poznámka: Verzia exportu ovplyvňuje predovšetkým štruktúru údajov o tréningoch, ak tréningy exportujete.

Časové rozpätie

Vyberte, kedy sa majú údaje exportovať:

• Predvolené — synchronizuje údaje za celý predchádzajúci deň plus údaje do aktuálneho dátumu a času
• Od poslednej synchronizácie — pri každej synchronizácii exportuje všetky údaje od posledného spustenia exportu až do aktuálneho dátumu a času
• Dnes — synchronizuje všetky údaje za aktuálny deň do aktuálneho času
• Včera — synchronizuje všetky údaje za celý predchádzajúci deň
• Predchádzajúcich 7 dní — synchronizuje údaje za celých predchádzajúcich sedem dní

Zhrnúť údaje

Pri formáte JSON a type údajov Zdravotné metriky zapnite alebo vypnite zhrnutie údajov.

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

Časová agregácia

Pri zapnutom zhrnutí údajov vyberte, ako sa majú údaje agregovať.

Zhrnúť údaje

Zapnite alebo vypnite zhrnutie údajov pre zdravotné metriky.

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

Poznámka: Toto nastavenie platí len pre typ údajov Zdravotné metriky.

Frekvencia synchronizácie

Nastavte, ako často má automatizácia publikovať údaje na MQTT:

Vyberte číslo a interval.

Testovanie a overenie

Manuálne testovanie

1. Na obrazovke konfigurácie automatizácie klepnite na „Manuálny export“
2. Vyberte časové rozpätie
3. Klepnite na „Export“ a publikujte správu
4. V MQTT klientovi sa prihláste na vašu tému a overte, či bola správa prijatá

Použitie MQTT klienta

Ak chcete overiť, že sa správy publikujú:

1. Nastavte MQTT klienta
2. Pripojte sa k MQTT brokerovi rovnakými prihlasovacími údajmi
3. Prihláste sa na vašu tému
4. Spustite manuálny export z aplikácie
5. Overte, či sa správa zobrazí v MQTT klientovi

Denníky aktivít

1. Na obrazovke konfigurácie automatizácie klepnite na „Zobraziť denníky aktivít“
2. Skontrolujte nedávne spustenia automatizácie
3. Hľadajte chyby pripojenia alebo zlyhania pri publikovaní
4. Overte časové značky publikovania

Formát správy

Správy MQTT sa publikujú ako JSON. Payload správy sleduje štandardný formát exportu JSON:

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

Správa sa publikuje s:

• Témou: podľa konfigurácie v automatizácii
• QoS: najviac raz doručenie
• Retain: správy sa neuchovávajú
• Payload: reťazec JSON so zdravotnými údajmi

Riešenie problémov

Bežné problémy

Zlyhanie pripojenia

• Overte, či je IP adresa alebo hostname brokera správna
• Skontrolujte, či je port správny a broker na ňom počúva
• Uistite sa, že existuje sieťové pripojenie k brokerovi
• Overte pravidlá firewallu, ktoré pripúšťajú pripojenie k brokerovi
• Skontrolujte, či broker nevyžaduje TLS/SSL

Zlyhanie autentifikácie

• Overte správnosť mena a hesla
• Skontrolujte, či je na brokeri zapnutá autentifikácia, ak posielate prihlasovacie údaje
• Uistite sa, že používateľ má oprávnenie publikovať na zadanú tému

Správy neprichádzajú

• Overte presnú zhodu názvu témy (rozlišuje sa veľkosť písmen)
• Skontrolujte, či sú odberatelia pripojení k tomu istému brokerovi
• Uistite sa, že sú odberatelia prihlásení na správnu tému
• Overte, či je automatizácia zapnutá a beží
• Pozrite denníky aktivít kvôli chybám pri publikovaní

Veľká veľkosť správy

• Znížte počet vybraných zdravotných metrík
• Použite menej detailnú agregáciu
• Zvážte rozdelenie do viacerých automatizácií pre rôzne typy údajov

Tipy a osvedčené postupy

1. Automatická synchronizácia:

   • Nabíjajte zariadenie a používajte zrkadlenie iPhonu
     • Pri nabíjaní iOS menej obmedzuje výkon zariadenia, takže sa údaje môžu synchronizovať častejšie
     • Pri zrkadlení iPhonu sa zariadenie správa rovnako ako pri odomknutí. Zdravotné údaje sú tak pre Health Auto Export dostupné na spúšťanie automatizovaných akcií

2. Organizácia tém:

   • Používajte hierarchické štruktúry tém (napr. health/metrics, health/workouts)
   • Zahrňte do tém identifikátory zariadenia alebo automatizácie
   • Zdokumentujte štruktúru tém pre jednoduchú orientáciu

3. Veľkosť správ:

   • Udržujte rozumnú veľkosť správ, aby ste sa vyhli limitom brokera
   • Menej detailná agregácia znižuje objem dát
   • Pri veľkých súboroch údajov zvážte rozdelenie do viacerých správ

4. Sledovanie:

   • V aplikácii používajte denníky aktivít na sledovanie ú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
     • Skontrolujte limity veľkosti správ a frekvencie
     • Overte konvencie pomenovania tém