Apple-Health-Daten mit MQTT synchronisieren
Veröffentliche Gesundheitsdaten an einen MQTT-Broker.
Zuletzt aktualisiert: 31. Oktober 2026
Auf dieser Seite
Veröffentliche Gesundheitsexporte als JSON an ein Topic deines MQTT-Brokers.
Wichtig — Einschränkungen der Automationen: Das Gerät muss entsperrt sein, um Gesundheitsdaten zu lesen, und iOS garantiert keine Hintergrundausführungen mit der von dir gewählten Frequenz. Lies die Einschränkungen der Automationen, bevor du dich auf automatische Exporte verlässt.
Automation öffnen
Öffne Exportieren → Automatisiert auf dem iPhone oder Automationen in der Seitenleiste des iPad. Wähle Neue Automation oder öffne eine bestehende zum Bearbeiten.
Name, Status und Benachrichtigungen
Gib einen Namen ein, der diese Automation identifiziert. Aktiviert erlaubt automatische Ausführungen; lasse es ausgeschaltet, bis du bereit bist.
Wähle die Ausführungsbenachrichtigungen, die du möchtest:
- Bei Cache-Aktualisierung benachrichtigen zeigt an, dass Exportdaten vorbereitet wurden.
- Bei Ausführung benachrichtigen zeigt eine erfolgreiche Veröffentlichung am Broker an.
Erlaube Benachrichtigungen, wenn du dazu aufgefordert wirst. Diese Benachrichtigungen melden Aktivität; sie planen keine Ausführung.
Verbindung einrichten
- Wähle MQTT als Automationstyp.
- Gib den Hostnamen oder die IP-Adresse des Brokers und den Port ein. Der Standardport ist 1883.
- Gib das Topic ein, z. B.
health/metrics. - Lege eine eindeutige Client-ID für jede Automation fest und gib Benutzername und Passwort ein, wenn der Broker das erfordert.
Der Broker muss von deinem Gerät erreichbar sein. Abonnenten müssen das genaue Topic einschließlich Groß-/Kleinschreibung verwenden. Das Wiederverwenden einer Client-ID kann dazu führen, dass Broker-Verbindungen einander ersetzen.
Einstellungen zum Datentyp
Wähle einen Datentyp für diese Automation: Gesundheitsmetriken, Workouts, Symptome, ECG, Herzfrequenzbenachrichtigungen, Gemütszustand, Zyklusverfolgung oder Medikamente. Gemütszustand erfordert iOS 18 oder neuer; Medikamente erfordern iOS 26 oder neuer und separaten Medikamentenzugriff.
Gesundheitsmetriken
Wähle Gesundheitsmetriken, öffne Gesundheitsmetriken auswählen und wähle die benötigten Messungen.
Um Messwerte auf bestimmte Apps oder Geräte zu beschränken, öffne Bevorzugte Quellen, wähle eine Metrik und ihre Quellen. Alle erlaubt alle Quellen, die nicht ausgeschlossen wurden. Verwende Ausgeschlossene Quellen, um eine Quelle für die Gesundheitsmetriken dieser Automation zu ignorieren. Ausschlüsse haben Vorrang; eine nicht ausgewählte Quelle wird nicht ersetzt, wenn die bevorzugte keine Daten hat. Wähle Sichern, um die Quellenoptionen anzuwenden, oder Abbrechen, um sie zu verwerfen.
Workouts
Wähle Workouts, um Workout-Datensätze zu exportieren. Routendaten einbeziehen fügt verfügbare Routenpunkte zu den JSON-Workout-Daten hinzu. Es erstellt keine separaten GPX-Dateien.
Für Version 2 aktiviere Workout-Metriken einbeziehen, um Messwerte wie Herzfrequenz, aktive Energie und Schritte hinzuzufügen. Wähle Minuten oder Sekunden für die Zeitgruppierung der Workout-Metriken; Sekunden erzeugen mehr Detail und größere Exporte. Version 1 enthält immer Workout-Metriken.
Exporteinstellungen
MQTT veröffentlicht nur JSON. Nachrichten verwenden QoS 0 für die Vordergrundveröffentlichung und QoS 1 für die Hintergrundveröffentlichung. Nachrichten werden nicht zurückgehalten.
Exportversion
Wähle Version 2 für die aktuelle Datenstruktur. Verwende Version 1, wenn ein bestehender Workflow vom älteren Format abhängt.
Datumsbereich
| Auswahl | Enthaltene Daten |
|---|---|
| Standard | Der Vortag und heute bis zur Ausführungszeit |
| Seit letzter Synchronisierung | Von der vorherigen Synchronisierung bis zur Ausführungszeit |
| Heute | Heute bis zur Ausführungszeit |
| Gestern | Der vollständige Vortag |
| Letzte 7 Tage | Die sieben vollständigen vorherigen Tage |
Daten zusammenfassen und Zeitgruppierung
Für JSON + Gesundheitsmetriken aktiviere Daten zusammenfassen, um Messwerte in Zeitgruppen zu kombinieren, oder deaktiviere es für einzelne Messwerte, wenn verfügbar. Die Zusammenfassung hängt von der Metrik ab—zum Beispiel werden Schritte addiert und Gewichtsmesswerte gemittelt. CSV-Exporte von Gesundheitsmetriken verwenden zusammengefasste Daten.
Wenn Zeitgruppierung verfügbar ist, wähle, wie viel Detail erhalten bleiben soll. Gruppen nach Stunde oder Tag erzeugen weniger Zeilen als Minuten oder Sekunden. Die verfügbaren Optionen hängen vom Datumsbereich und Format ab. Die Zeitgruppierung von Workouts wird separat unter Workouts konfiguriert.
Erinnerungen planen
Wenn du einen Hinweis zum Entsperren und Öffnen der App möchtest, aktiviere Erinnerungen aktivieren. Wähle Stündlich, Täglich oder Ausgewählte Tage und konfiguriere Minute, Uhrzeit und Tage entsprechend. Erlaube Benachrichtigungszugriff, wenn du dazu aufgefordert wirst; bei Ablehnung verwende Benachrichtigungseinstellungen öffnen.
Eine Erinnerung führt die Automation nicht aus und bestätigt keine erfolgreiche Synchronisierung. Tippe darauf, um die Automation zu öffnen, oder verwende Öffnen und synchronisieren in der Benachrichtigung, um eine Ausführung anzufordern. Die Automation muss aktiviert sein; eine Erinnerung kann auch nach einer erfolgreichen Hintergrundausführung erscheinen. Erinnerungsänderungen gelten beim Speichern.
Synchronisierungsfrequenz und speichern
Wähle eine Zahl und Minuten, Stunden, Tage oder Wochen unter Synchronisierungsfrequenz—zum Beispiel alle 15 Minuten. Das ist eine gewünschte Hintergrundkadenz, kein garantierter Zeitplan.
Das Gerät muss entsperrt sein, wenn Gesundheitsdaten gelesen werden. Aktiviere die Hintergrundaktualisierung für Health Auto Export und deaktiviere den Energiesparmodus für automatische Ausführungen. iOS kann Ausführungen verzögern, wenn das Gerät inaktiv war oder Systemressourcen begrenzt sind.
Aktiviere Aktiviert, wenn du für automatische Ausführungen bereit bist, und wähle Aktualisieren, um die Automation zu speichern. Du kannst sofort einen Datumsbereich mit den folgenden Schritten hochladen.
Historische oder verpasste Daten exportieren
Verwende Manueller Upload bei der ersten Einrichtung der Automation, um historische Daten zu exportieren, oder später, um Daten abzudecken, die die automatische Synchronisierung nicht erreicht hat. Du kannst ihn auch verwenden, um die Konfiguration zu prüfen.
- Verbinde einen MQTT-Abonnenten mit deinem Broker und abonniere das konfigurierte Topic.
- Öffne in Health Auto Export die Automation und wähle Manueller Upload unter Vorhandene Daten exportieren.
- Lege die Daten für Start und Ende fest und wähle Export starten.
- Prüfe das empfangene JSON und seine Daten.
Die Nutzlast folgt dem JSON-Exportformat. Zum Beispiel:
{
"data": {
"metrics": [
{
"name": "step_count",
"units": "count",
"data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
}
]
}
}
Fehlerbehebung
- Verbindungsfehler: Prüfe Host, Port, Netzwerkzugriff und die Verbindungsanforderungen des Brokers.
- Authentifizierungsfehler: Prüfe die Anmeldedaten und die Berechtigung zum Veröffentlichen am Topic.
- Keine Nachricht: Bestätige, dass der Abonnent denselben Broker und das genaue Topic verwendet, und prüfe die Aktivitätsprotokolle.
- Nachricht zu groß: Wähle weniger Metriken, einen kürzeren Bereich oder eine gröbere Zeitgruppierung.
Öffne die Automation und wähle Aktivitätsprotokolle anzeigen, um eine Ausführung zu prüfen. Warnungen weisen auf mögliche Probleme wie langsame Datenabfrage hin; Fehler identifizieren fehlgeschlagene Schritte. Hilfe beim Melden eines Problems unter Hilfe erhalten.