Apple Health-gegevens synchroniseren met MQTT

MQTT-automatiseringen stellen u in staat om automatisch uw gezondheidsgegevens te publiceren naar een MQTT-broker. Dit is ideaal voor integratie met IoT-platforms, domotica-systemen of elke service die MQTT-berichten ondersteunt.

Overzicht

MQTT-automatiseringen publiceren uw gezondheidsgegevens als JSON-berichten naar een opgegeven MQTT-onderwerp op een MQTT-broker. De gegevens worden verzonden wanneer de automatisering wordt uitgevoerd volgens uw synchronisatiefrequentie-instellingen.

Gebruikssituaties:

• Integratie met IoT-platforms (Home Assistant, OpenHAB, etc.)
• Publiceren van gezondheidsgegevens naar MQTT-gebaseerde dashboards
• Real-time gezondheidsmonitoringsystemen
• Aangepaste domotica-integraties
• Gegevenslogboek- en analyseplatforms

Belangrijkste functies:

• Alleen JSON-formaat (geoptimaliseerd voor MQTT)
• Ondersteunt geverifieerde en anonieme verbindingen
• Configureerbare onderwerpstructuur
• Client-ID-beheer
• Optionele gebruikersnaam/wachtwoord-authenticatie

Beperkingen

• Toegang tot gezondheidsgegevens: Apps mogen geen toegang hebben tot gezondheidsgegevens terwijl de iPhone vergrendeld is. Automatiseringen worden alleen uitgevoerd tijdens perioden waarin uw apparaat ontgrendeld is. Dit kan de actualiteit van gegevens beïnvloeden. Zie instructies voor handmatige synchronisatie om gegevens up-to-date te houden.

• Achtergrondverwerking: iOS beperkt achtergrondverwerking om de batterijduur te behouden. Automatiseringen zijn afhankelijk van App-achtergrondverversing en worden mogelijk niet onmiddellijk uitgevoerd als:

  • App-achtergrondverversing is uitgeschakeld voor de app
  • Het apparaat is in Energiespaarmodus
  • Het apparaat gedurende langere perioden inactief is geweest
  • Systeembronnen beperkt zijn
  • Meerdere apps concurreren om achtergronduitvoeringstijd

• Alleen JSON-formaat (kan niet worden gewijzigd)

• Vereist een MQTT-broker (lokaal of cloudgebaseerd)

Vereisten

• Een MQTT-broker (bijv. Mosquitto, HiveMQ, AWS IoT Core, etc.)
• Netwerkverbinding met uw MQTT-broker
• Broker IP-adres of hostnaam
• Poortnummer
• Optioneel: Gebruikersnaam en wachtwoord als uw broker authenticatie vereist

Configuratie

Navigeer naar het scherm Geautomatiseerde Exports vanuit de hoofdnavigatie, tik vervolgens op "Nieuwe Automatisering" en selecteer "MQTT" als Automatiseringstype.

Automatiseringsnaam

Voer een beschrijvende naam in voor uw automatisering (bijv. "Home Assistant MQTT", "Cloud MQTT Broker").

Meldingen

Configureer wanneer u meldingen wilt ontvangen:

• Melden bij cache-update - Ontvang een melding wanneer gecachte gegevens worden bijgewerkt
• Melden bij uitvoering - Ontvang een melding elke keer dat de automatisering gegevens publiceert

Brokerconfiguratie

IP-adres

Voer het IP-adres of de hostnaam van uw MQTT-broker in.

Voorbeelden:

• 192.168.1.100 (lokaal IP-adres)
• mqtt.example.com (hostnaam)
• broker.hivemq.com (cloud MQTT-broker)
• localhost (indien uitgevoerd op hetzelfde apparaat, niet aanbevolen voor iOS)

Opmerking: Gebruik IP-adressen voor lokale brokers op uw netwerk, of hostnamen voor cloudgebaseerde brokers. Zorg ervoor dat de broker toegankelijk is vanaf uw apparaat.

Poort

Voer het poortnummer voor uw MQTT-broker in.

Opmerking: De standaardpoort is 1883.

Onderwerp

Voer het MQTT-onderwerp in waar gezondheidsgegevens worden gepubliceerd. Dit is het onderwerp dat abonnees zullen gebruiken om uw gezondheidsgegevens te ontvangen.

Onderwerpvoorbeelden:

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

Beste praktijken voor onderwerpen:

• Gebruik forward slashes (/) om onderwerphiërarchieën te maken
• Gebruik beschrijvende namen die het gegevenstype aangeven
• Vermijd spaties en speciale tekens
• Overweeg de automatiseringsnaam op te nemen voor meerdere automatiseringen

Opmerking: De onderwerpnaam is hoofdlettergevoelig. Zorg ervoor dat abonnees exact dezelfde onderwerpnaam gebruiken.

Client-ID

Voer een unieke client-ID in voor deze MQTT-verbinding. Dit identificeert uw apparaat bij de MQTT-broker.

Client-ID-voorbeelden:

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

Gebruikersnaam (Optioneel)

Voer de gebruikersnaam in voor MQTT-broker-authenticatie. Laat leeg als uw broker geen authenticatie vereist.

Wachtwoord (Optioneel)

Voer het wachtwoord in voor MQTT-broker-authenticatie. Laat leeg als uw broker geen authenticatie vereist.

Gegevenstype-instellingen

Gegevenstype

Selecteer welk type gezondheidsgegevens u wilt exporteren:

• Gezondheidsmetrieken - Stappen, hartslag, slaap en andere gezondheidsmetingen
• Trainingen - Oefen- en fitnessactiviteiten
• Symptomen - Gezondheidssymptomen en -condities
• ECG - Elektrocardiogrammetingen
• Hartslagmeldingen - Hoge/lage hartslaggebeurtenissen
• Gemoedstoestand - Stemmings- en mentale toestandsinvoeren (iOS 18.0+)
• Cyclusvolging - Menstruele cyclus- en reproductieve gezondheidsgegevens
• Medicijnen - Medicijnlogboeken en naleving (iOS 26.0+)

Configuratie gezondheidsmetrieken

Wanneer Gezondheidsmetrieken is geselecteerd:

Selecteer gezondheidsmetrieken - Kies welke specifieke metrieken u wilt opnemen. U kunt alle beschikbare metrieken selecteren of specifieke kiezen.

Tip: Alleen de metrieken selecteren die u nodig heeft, vermindert de berichtgrootte en verwerkingstijd.

Voorkeursbronnen - Configureer welke gegevensbronnen prioriteit hebben wanneer meerdere bronnen dezelfde metriek leveren.

Configuratie trainingen

Wanneer Trainingen is geselecteerd:

Routegegevens opnemen - Schakel AAN om routes op te nemen voor trainingen die locatiegegevens hebben.

Trainingsmetrieken opnemen - Schakel AAN om gezondheidsmetrieken op te nemen die tijdens trainingen zijn verzameld (hartslag, calorieën, etc.).

Tijdsgroepering (Trainingsmetrieken) - Bij gebruik van Exportversie 2 en Trainingsmetrieken opnemen is ingeschakeld:

• Minuten - Groepeert trainingsmetrieken per minuut
• Seconden - Groepeert trainingsmetrieken per seconde

Exportinstellingen

Exportformaat

Opmerking: MQTT-automatiseringen ondersteunen alleen JSON-formaat. Deze instelling kan niet worden gewijzigd en wordt automatisch ingesteld op JSON.

Exportversie

Selecteer een Exportversie voor trainingsgegevens:

• Versie 1 - Legacy-formaat
• Versie 2 - Huidig formaat met verbeterde trainingsgegevens

Opmerking: Exportversie heeft voornamelijk invloed op de trainingsgegevensstructuur als u trainingen exporteert.

Datumbereik

Selecteer wanneer gegevens moeten worden geëxporteerd:

• Standaard - Synchroniseert gegevens voor de volledige vorige dag plus gegevens tot de huidige datum en tijd
• Sinds laatste synchronisatie - Bij elke synchronisatie exporteert alle gegevens sinds de laatste keer dat de export werd uitgevoerd tot de huidige datum en tijd
• Vandaag - Synchroniseert alle gegevens voor de huidige datum tot de huidige tijd
• Gisteren - Synchroniseert alle gegevens voor de volledige vorige dag
• Vorige 7 dagen - Synchroniseert gegevens voor de volledige vorige zeven dagen

Gegevens samenvatten

Bij gebruik van JSON-formaat met gegevenstype Gezondheidsmetrieken, schakel Gegevens samenvatten AAN of UIT.

• AAN - Biedt geaggregeerde gegevenssamenvattingen (standaard)
• UIT - Biedt gedisaggregeerde gegevens waar mogelijk, toont individuele gegevenspunten

Tijdsgroepering

Wanneer Gegevens samenvatten is ingeschakeld, selecteer hoe gegevens moeten worden geaggregeerd.

Gegevens samenvatten

Schakel Gegevens samenvatten AAN of UIT voor Gezondheidsmetrieken.

• AAN - Biedt geaggregeerde gegevenssamenvattingen (standaard)
• UIT - Biedt gedisaggregeerde gegevens waar mogelijk

Opmerking: Deze instelling is alleen van toepassing op het gegevenstype Gezondheidsmetrieken.

Synchronisatiefrequentie

Configureer hoe vaak de automatisering gegevens naar MQTT moet publiceren:

Selecteer een nummer en interval.

Testen en verificatie

Handmatig testen

1. Tik op "Handmatige export" in het automatiseringsconfiguratiescherm
2. Selecteer een datumbereik
3. Tik op "Exporteren" om een bericht te publiceren
4. Gebruik een MQTT-client om u te abonneren op uw onderwerp en verifieer dat het bericht is ontvangen

Een MQTT-client gebruiken

Om te verifiëren dat berichten worden gepubliceerd:

1. Stel een MQTT-client in
2. Verbind met uw MQTT-broker met dezelfde referenties
3. Abonneer u op uw onderwerp
4. Activeer een handmatige export vanuit de app
5. Verifieer dat het bericht verschijnt in uw MQTT-client

Activiteitenlogboeken bekijken

1. Tik op "Activiteitenlogboeken bekijken" in het automatiseringsconfiguratiescherm
2. Bekijk recente automatiseringsuitvoeringen
3. Controleer op verbindingsfouten of publicatiefouten
4. Verifieer publicatietijdstempels

Berichtformaat

MQTT-berichten worden gepubliceerd als JSON. De berichtpayload volgt het standaard export JSON-formaat:

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

Het bericht wordt gepubliceerd met:

• Onderwerp: Zoals geconfigureerd in de automatisering
• QoS: Levering hoogstens één keer
• Behouden: Berichten worden niet behouden
• Payload: JSON-tekenreeks met gezondheidsgegevens

Probleemoplossing

Veelvoorkomende problemen

Verbindingsfouten

• Verifieer dat het broker IP-adres/hostnaam correct is
• Controleer of de poort correct is en de broker op die poort luistert
• Zorg voor netwerkverbinding met de broker
• Verifieer dat firewallregels verbindingen met de broker toestaan
• Controleer of de broker TLS/SSL vereist

Authenticatiefouten

• Verifieer dat gebruikersnaam en wachtwoord correct zijn
• Controleer of authenticatie is ingeschakeld op uw broker als referenties zijn opgegeven
• Zorg ervoor dat de gebruiker toestemming heeft om te publiceren naar het opgegeven onderwerp

Berichten niet ontvangen

• Verifieer dat de onderwerpnaam exact overeenkomt (hoofdlettergevoelig)
• Controleer of abonnees verbonden zijn met dezelfde broker
• Zorg ervoor dat abonnees geabonneerd zijn op het juiste onderwerp
• Verifieer dat de automatisering is ingeschakeld en wordt uitgevoerd
• Controleer Activiteitenlogboeken op publicatiefouten

Grote berichtgrootte

• Verminder het aantal geselecteerde gezondheidsmetrieken
• Gebruik minder gedetailleerde aggregatie-opties
• Overweeg te splitsen in meerdere automatiseringen voor verschillende gegevenstypen

Tips en beste praktijken

1. Onderwerporganisatie:

   • Gebruik hiërarchische onderwerpstructuren (bijv. health/metrics, health/workouts)
   • Neem apparaat- of automatiseringsidentificatoren op in onderwerpen
   • Documenteer uw onderwerpstructuur voor eenvoudige referentie

2. Berichtgrootte:

   • Houd berichten redelijk groot om MQTT-brokerlimieten te vermijden
   • Gebruik minder gedetailleerde aggregatie om het gegevensvolume te verminderen
   • Overweeg grote datasets te splitsen over meerdere berichten

3. Monitoring:

   • Gebruik Activiteitenlogboeken in de app om publicatiesucces bij te houden

4. Cloud-brokers:

   • Bij gebruik van cloud MQTT-brokers (AWS IoT, HiveMQ Cloud, etc.):
     • Volg hun specifieke verbindingsvereisten
     • Controleer hun berichtgrootte- en snelheidslimieten
     • Verifieer onderwerpnaamgevingsconventies