Synkronoi MQTT:hen

MQTT-automaatiot julkaisevat terveysdatasi automaattisesti MQTT-välittäjälle. Tämä sopii integraatioihin IoT-alustoille, älykotiautomaatioon tai mihin tahansa palveluun, joka tukee MQTT-viestintää.

Yleiskatsaus

MQTT-automaatiot julkaisevat terveysdatasi JSON-viesteinä valitulle MQTT-aiheelle (topic) välittäjällä. Data lähetetään aina, kun automaatio suoritetaan synkronoinnin tiheysasetustesi mukaan.

Käyttötapaukset:

• Integraatio IoT-alustoihin (Home Assistant, OpenHAB jne.)
• Terveysdatan julkaisu MQTT-pohjaisiin koontinäyttöihin
• Reaaliaikaiset terveysvalvontajärjestelmät
• Mukautetut älykoti-integraatiot
• Datan lokitus ja analytiikka

Keskeiset ominaisuudet:

• Vain JSON-muoto (optimoitu MQTT:lle)
• Tukee sekä todennettuja että anonyymeja yhteyksiä
• Säädettävä aiherakenne
• Client ID -hallinta
• Valinnainen käyttäjätunnus/salasana -todennus

Rajoitukset

• Terveysdatan käyttö: Sovellukset eivät saa käyttää terveysdataa, kun iPhone on lukittu. Automaatiot suoritetaan vain silloin, kun laite on lukitsemattomana. Tämä voi vaikuttaa datan ajantasaisuuteen. Katso ohjeet manuaaliseen synkronointiin pitääksesi datan ajan tasalla.

• Taustakäsittely: iOS rajoittaa taustakäsittelyä akun keston vuoksi. Automaatiot käyttävät taustasovellusten päivitystä (Background App Refresh) eivätkä välttämättä suoritu heti, jos:

  • Taustasovellusten päivitys on pois käytöstä sovellukselta
  • Laite on vähävirtaisessa tilassa
  • Laite on ollut pitkään passiivisena
  • Järjestelmän resurssit ovat kireät
  • Useat sovellukset kilpailevat taustasuorituksesta

• Vain JSON-muoto (ei voi muuttaa)

• Vaatii MQTT-välittäjän (paikallinen tai pilvipohjainen)

Edellytykset

• MQTT-välittäjä (esim. Mosquitto, HiveMQ, AWS IoT Core jne.)
• Verkkoyhteys MQTT-välittäjään
• Välittäjän IP-osoite tai verkkonimi
• Porttinumero
• Valinnainen: käyttäjätunnus ja salasana, jos välittäjä vaatii todennusta

Määritys

Siirry päävalikosta automaattisten vientien näyttöön, napauta Uusi automaatio ja valitse automaation tyypiksi MQTT.

Automaation nimi

Anna automaatiolle kuvaava nimi (esim. ”Home Assistant MQTT”, ”Cloud MQTT Broker”).

Ilmoitukset

Määritä, milloin haluat ilmoituksia:

• Notify on Cache Update – Ilmoitus, kun välimuistidata päivittyy
• Notify When Run – Ilmoitus joka kerta, kun automaatio julkaisee dataa

Välittäjän määritys

IP-osoite

Anna MQTT-välittäjän IP-osoite tai verkkonimi.

Esimerkkejä:

• 192.168.1.100 (paikallinen IP)
• mqtt.example.com (verkkonimi)
• broker.hivemq.com (pilvi-MQTT)
• localhost (jos sama laite; iOS:llä ei yleensä suositella)

Huom: Käytä paikallisille välittäjille IP-osoitetta tai pilville verkkonimeä. Varmista, että välittäjä on laitteesi saavutettavissa.

Portti

Anna MQTT-välittäjän portti.

Huom: Oletusportti on 1883.

Aihe (topic)

Anna MQTT-aihe, johon terveysdata julkaistaan. Tätä aihetta tilaajat käyttävät datan vastaanottamiseen.

Esimerkkejä aiheista:

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

Hyviä käytäntöjä aiheille:

• Käytä kauttaviivoja (/) aihehierarkioihin
• Käytä kuvaavia nimiä, jotka kertovat datatyypin
• Vältä välilyöntejä ja erikoismerkkejä
• Harkitse automaation nimen sisällyttämistä useille automaatioille

Huom: Aihe on kirjainkoolla merkitsevä. Tilaajien on käytettävä täsmälleen samaa nimeä.

Client ID

Anna yksilöllinen client ID tälle MQTT-yhteydelle. Tunniste erottaa laitteesi välittäjälle.

Esimerkkejä client ID:stä:

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

Käyttäjätunnus (valinnainen)

Anna MQTT-välittäjän todennukseen käyttäjätunnus. Jätä tyhjäksi, jos välittäjä ei vaadi todennusta.

Salasana (valinnainen)

Anna MQTT-välittäjän todennukseen salasana. Jätä tyhjäksi, jos välittäjä ei vaadi todennusta.

Datatyypin asetukset

Datatyyppi

Valitse, minkä terveysdatan tyyppiä viedään:

• Health Metrics – Askeleet, syke, uni ja muut terveysmittaukset
• Workouts – Liikunta- ja kuntoaktiviteetit
• Symptoms – Terveysoireet ja tilat
• ECG – EKG-mittaukset
• Heart Rate Notifications – Korkea/matala syke -tapahtumat
• State of Mind – Mielialan ja mielentilan merkinnät (iOS 18.0+)
• Cycle Tracking – Kuukautiskierto ja lisääntymisterveysdata
• Medications – Lääkkeiden kirjaukset ja noudattaminen (iOS 26.0+)

Health Metrics -asetukset

Kun on valittu Health Metrics:

Select Health Metrics – Valitse, mitkä mittarit sisällytetään. Voit valita kaikki saatavilla olevat tai tiettyjä.

Vinkki: Vain tarvitsemiesi mittareiden valinta pienentää viestikokoa ja käsittelyaikaa.

Preferred Sources – Määritä, mitkä datalähteet ovat etusijalla, kun sama mittari tulee useasta lähteestä.

Workout-asetukset

Kun on valittu Workouts:

Include Route Data – Ota käyttöön, jotta mukaan tulee reitit harjoituksille, joissa on sijaintidataa.

Include Workout Metrics – Ota käyttöön, jotta mukaan tulee harjoituksen aikana kerätyt terveysmittarit (syke, kalorit jne.).

Aikaryhmittely (harjoitusmittarit) – Kun käytössä on Export Version 2 ja Sisällytä harjoitusmittarit on päällä:

• Minutes – Ryhmittelee harjoitusmittarit minuuteittain
• Seconds – Ryhmittelee harjoitusmittarit sekunteittain

Viennin asetukset

Viennin muoto

Huom: MQTT-automaatiot tukevat vain JSON-muotoa. Tätä ei voi muuttaa; se on automaattisesti JSON.

Viennin versio

Valitse Export Version harjoitusdatalle:

• Version 1 – Vanha muoto
• Version 2 – Nykyinen muoto, laajennettu harjoitusdata

Huom: Viennin versio vaikuttaa ennen kaikkea harjoitusdatan rakenteeseen, jos viet harjoituksia.

Aikaväli

Valitse, milloin data viedään:

• Default – Synkronoi datan koko edelliseltä päivältä sekä kuluvaan päivään ja -aikaan asti
• Since Last Sync – Jokaisella synkronoinnilla vie kaiken datan edellisen viennin jälkeen kuluvaan päivään ja -aikaan asti
• Today – Synkronoi kaiken kuluvan päivän datan kuluvaan hetkeen asti
• Yesterday – Synkronoi koko edellisen päivän data
• Previous 7 Days – Synkronoi edellisten seitsemän päivän data

Yhteenveto datasta

Kun käytät JSON-muotoa Health Metrics -datatyypin kanssa, kytke Summarize Data päälle tai pois.

• Päällä – Tarjoaa koostetut yhteenvedot (oletus)
• Poissa – Tarjoaa mahdollisuuksien mukaan erittelemätön datan, yksittäiset datapisteet näkyvissä

Huom: Tämä asetus koskee vain Health Metrics -datatyyppiä.

Aikaryhmittely

Kun Summarize Data on päällä, valitse, miten data koostetaan.

Synkronoinnin tiheys

Määritä, kuinka usein automaation tulisi julkaista dataa MQTT:hen:

Valitse luku ja aikaväli.

Testaus ja varmistus

Manuaalinen testaus

1. Napauta automaation määritysnäytössä Manual Export
2. Valitse aikaväli
3. Napauta Export julkaistaksesi viestin
4. Käytä MQTT-asiakasohjelmaa ja tilaa aiheesi varmistaaksesi, että viesti vastaanotettiin

MQTT-asiakasohjelman käyttö

Viestien varmistamiseksi:

1. Asenna MQTT-asiakas
2. Yhdistä samaan MQTT-välittäjään samoilla tunnuksilla
3. Tilaa aiheesi
4. Käynnistä manuaalinen vienti sovelluksessa
5. Varmista, että viesti näkyy asiakasohjelmassa

Toimintalokien tarkastelu

1. Napauta automaation määritysnäytössä View Activity Logs
2. Tarkista viimeisimmät automaatiosuoritukset
3. Etsi yhteys- tai julkaisuvirheitä
4. Varmista julkaisuaikaleimat

Viestimuoto

MQTT-viestit julkaistaan JSONina. Kuormitus noudattaa vakio JSON-vientimuotoa:

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

Viesti julkaistaan seuraavasti:

• Topic: Automaatiossa määritetty aihe
• QoS: Enintään kerran toimitus (at most once)
• Retain: Viestejä ei säilytetä (retain ei käytössä)
• Payload: JSON-merkkijono, joka sisältää terveysdatan

Ongelmanratkaisu

Yleisiä ongelmia

Yhteys epäonnistuu

• Varmista, että välittäjän IP/verkkonimi on oikein
• Tarkista, että portti on oikein ja välittäjä kuuntelee sillä
• Varmista verkkoyhteys välittäjään
• Tarkista palomuurisäännöt
• Tarkista, vaatiiko välittäjä TLS/SSL:ää

Todennus epäonnistuu

• Varmista käyttäjätunnus ja salasana
• Tarkista, että todennus on käytössä välittäjällä, jos annoit tunnukset
• Varmista, että käyttäjällä on oikeus julkaista valittuun aiheeseen

Viestejä ei vastaanoteta

• Varmista, että aiheen nimi täsmää (kirjainkoko merkitsee)
• Tarkista, että tilaajat ovat samassa välittäjässä
• Varmista, että tilaajat tilaavat oikean aiheen
• Varmista, että automaatio on käytössä ja suorituu
• Tarkista toimintalokit julkaisuvirheiden varalta

Viesti liian suuri

• Vähennä valittujen terveysmittareiden määrää
• Käytä karkeampaa koostamista
• Harkitse useiden automaatioiden jakamista eri datatyypeille

Vinkkejä ja hyviä käytäntöjä

1. Automaattinen synkronointi:

   • Lataa laitetta ja käytä iPhonen peilausta (iPhone Mirroring)
     • Latauksen aikana iOS rajoittaa laitteen suorituskykyä vähemmän, jolloin data voi synkronoitua useammin
     • Peilauksella laite käyttäytyy kuin lukitsemattomana, jolloin Health Auto Export voi käyttää terveysdataa automaattisten toimintojen suorittamiseen

2. Aiheiden järjestäminen:

   • Käytä hierarkkisia aiheita (esim. health/metrics, health/workouts)
   • Sisällytä aiheisiin laite- tai automaatiotunnisteita
   • Dokumentoi aiherakenne helppoa viittausta varten

3. Viestikoko:

   • Pidä viestit kohtuullisina välittäjän rajojen vuoksi
   • Käytä karkeampaa koostamista pienentääksesi datamäärää
   • Harkitse suurten aineistojen jakamista useisiin viesteihin

4. Seuranta:

   • Käytä sovelluksen toimintalokeja julkaisun onnistumisen seuraamiseen

5. Pilvivälittäjät:

   • Pilvi-MQTT-välittäjillä (AWS IoT, HiveMQ Cloud jne.):
     • Noudata palvelun yhteysvaatimuksia
     • Tarkista viestikoko- ja nopeusrajat
     • Varmista aiheiden nimeämissäännöt