Apple Health-gegevens synchroniseren met MQTT
Publiceer gezondheidsgegevens naar een MQTT-broker.
Laatst bijgewerkt: 31 oktober 2026
Op deze pagina
Publiceer gezondheidsexporten als JSON naar een onderwerp op je MQTT-broker.
Belangrijk — beperkingen van automatiseringen: Je apparaat moet ontgrendeld zijn om gezondheidsgegevens te lezen, en iOS garandeert geen achtergronduitvoeringen met de door jou gekozen frequentie. Lees de beperkingen van automatiseringen voordat je op automatische exporten vertrouwt.
De automatisering openen
Open Exporteren → Geautomatiseerd op iPhone, of Automatiseringen in de iPad-zijbalk. Selecteer Nieuwe automatisering, of open een bestaande om te bewerken.
Naam, status en meldingen
Voer een naam in die deze automatisering identificeert. Ingeschakeld staat automatische uitvoeringen toe; laat dit uit tot je klaar bent.
Kies de uitvoeringsmeldingen die je wilt:
- Melden bij cache-update meldt dat exportgegevens zijn voorbereid.
- Melden bij uitvoering meldt een geslaagde publicatie naar de broker.
Sta meldingen toe wanneer daarom wordt gevraagd. Deze meldingen rapporteren activiteit; ze plannen geen uitvoering.
De verbinding instellen
- Kies MQTT als Automatiseringstype.
- Voer de hostnaam of het IP-adres en de poort van je broker in. De standaardpoort is 1883.
- Voer het onderwerp in, bijvoorbeeld
health/metrics. - Stel een unieke client-ID in voor elke automatisering en voer een gebruikersnaam en wachtwoord in als de broker dat vereist.
De broker moet bereikbaar zijn vanaf je apparaat. Abonnees moeten het exacte onderwerp gebruiken, inclusief hoofdletters. Een client-ID opnieuw gebruiken kan ervoor zorgen dat brokerverbindingen elkaar vervangen.
Instellingen gegevenstype
Selecteer één gegevenstype voor deze automatisering: Gezondheidsmetrieken, Trainingen, Symptomen, ECG, Hartslagmeldingen, Gemoedstoestand, Cyclustracking of Medicijnen. Gemoedstoestand vereist iOS 18 of nieuwer; Medicijnen vereist iOS 26 of nieuwer en aparte medicijnentoegang.
Gezondheidsmetrieken
Kies Gezondheidsmetrieken, open Gezondheidsmetrieken selecteren en selecteer de metingen die je nodig hebt.
Om metingen te beperken tot bepaalde apps of apparaten, open je Voorkeursbronnen, kies je een metriek en selecteer je de bronnen. Alles staat elke bron toe die niet is uitgesloten. Gebruik Uitgesloten bronnen om een bron voor de gezondheidsmetrieken van deze automatisering te negeren. Uitsluitingen hebben voorrang; een niet-geselecteerde bron wordt niet vervangen wanneer een voorkeursbron geen gegevens heeft. Selecteer Bewaar om de bronkeuzes toe te passen of Annuleer om ze te verwerpen.
Trainingen
Kies Trainingen om trainingsrecords te exporteren. Routgegevens opnemen voegt beschikbare routepunten toe aan JSON-trainingsgegevens. Het maakt geen aparte GPX-uploads.
Voor Versie 2 schakel je Trainingsmetrieken opnemen in om metingen zoals hartslag, actieve energie en stappen toe te voegen. Kies Minuten of Seconden voor de tijdgroepering van trainingsmetrieken; seconden leveren meer detail en grotere exporten. Versie 1 bevat altijd trainingsmetrieken.
Exportinstellingen
MQTT publiceert alleen JSON. Berichten gebruiken QoS 0 voor voorgrondpublicatie en QoS 1 voor achtergrondpublicatie. Berichten worden niet bewaard (retained).
Exportversie
Kies Versie 2 voor de huidige gegevensstructuur. Gebruik Versie 1 wanneer een bestaande workflow van het oudere formaat afhangt.
Datumbereik
| Selectie | Opgenomen gegevens |
|---|---|
| Standaard | De vorige dag en vandaag tot de uitvoeringstijd |
| Sinds laatste synchronisatie | Sinds de vorige synchronisatie tot de uitvoeringstijd |
| Vandaag | Vandaag tot de uitvoeringstijd |
| Gisteren | De volledige vorige dag |
| Vorige 7 dagen | De vorige zeven volledige dagen |
Gegevens samenvatten en tijdgroepering
Voor JSON + Gezondheidsmetrieken schakel je Gegevens samenvatten in om metingen in tijdgroepen te combineren, of uit voor individuele metingen waar beschikbaar. De samenvatting hangt af van de metriek—bijvoorbeeld stappen worden opgeteld en gewichtsmetingen gemiddeld. CSV-exporten van gezondheidsmetrieken gebruiken samengevatte gegevens.
Wanneer Tijdgroepering beschikbaar is, kies je hoeveel detail je wilt behouden. Groepen per uur of dag leveren minder rijen op dan minuut- of secondengroepen. Beschikbare keuzes hangen af van het datumbereik en formaat. Tijdgroepering van trainingen wordt apart geconfigureerd onder Trainingen.
Herinneringen plannen
Als je een melding wilt om te ontgrendelen en de app te openen, schakel dan Herinneringen inschakelen in. Kies Elk uur, Elke dag of Geselecteerde dagen, en stel de minuut, tijd en dagen in. Sta meldingen toe wanneer daarom wordt gevraagd; als toegang is geweigerd, gebruik Meldingsinstellingen openen.
Een herinnering voert de automatisering niet uit en bevestigt geen geslaagde synchronisatie. Tik erop om de automatisering te openen, of gebruik Openen en synchroniseren op de melding om een uitvoering aan te vragen. De automatisering moet ingeschakeld zijn; een herinnering kan nog verschijnen na een geslaagde achtergronduitvoering. Wijzigingen in herinneringen gelden wanneer je opslaat.
Synchronisatiefrequentie en opslaan
Kies een getal en Minuten, Uren, Dagen of Weken onder Synchronisatiefrequentie—bijvoorbeeld elke 15 minuten. Dit is een gewenste achtergrondcadans, geen gegarandeerd schema.
Je apparaat moet ontgrendeld zijn wanneer gezondheidsgegevens worden gelezen. Schakel Achtergrond-app verversen in voor Health Auto Export en schakel de energiebesparingsmodus uit voor automatische uitvoeringen. iOS kan uitvoeringen nog steeds vertragen wanneer het apparaat inactief is geweest of systeembronnen beperkt zijn.
Schakel Ingeschakeld in wanneer je klaar bent voor automatische uitvoeringen, en selecteer Werk bij om de automatisering op te slaan. Je kunt meteen een geselecteerd datumbereik uploaden met de stappen hieronder.
Historische of gemiste gegevens exporteren
Gebruik Handmatige upload wanneer je de automatisering voor het eerst instelt om historische gegevens te exporteren, of later om datums te dekken die de automatische synchronisatie heeft gemist. Je kunt dit ook gebruiken om je installatie te controleren.
- Koppel een MQTT-abonnee aan je broker en abonneer je op het geconfigureerde onderwerp.
- Open in Health Auto Export de automatisering en selecteer Handmatige upload onder Bestaande gegevens exporteren.
- Stel de datums Start en Einde in en selecteer Export starten.
- Controleer de ontvangen JSON en de datums.
De payload volgt het JSON-exportformaat. Bijvoorbeeld:
{
"data": {
"metrics": [
{
"name": "step_count",
"units": "count",
"data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
}
]
}
}
Problemen oplossen
- Verbinding mislukt: Controleer de host, poort, netwerktoegang en verbindingsvereisten van de broker.
- Authenticatie mislukt: Controleer de referenties en de toestemming om naar het onderwerp te publiceren.
- Geen bericht: Bevestig dat de abonnee dezelfde broker en het exacte onderwerp gebruikt, en bekijk daarna de activiteitslogboeken.
- Bericht te groot: Selecteer minder metrieken, een korter bereik of grovere tijdgroepering.
Open de automatisering en selecteer Activiteitslogboeken weergeven om een uitvoering te bekijken. Waarschuwingen markeren mogelijke problemen zoals trage gegevensopvraging; fouten identificeren mislukte stappen. Voor hulp bij het melden van een probleem zie Hulp krijgen.