Hilfezentrum HealthyApps
Deutsch
Hilfezentrum
Hauptwebsite ↗

Hilfethemen suchen

Apple-Health-Daten mit MQTT synchronisieren

Veröffentliche Gesundheitsdaten an einen MQTT-Broker.

Zuletzt aktualisiert: 31. Oktober 2026

Auf dieser Seite
Automation öffnenName, Status und BenachrichtigungenVerbindung einrichten
Einstellungen zum Datentyp Einstellungen zum Datentyp GesundheitsmetrikenWorkouts
Exporteinstellungen Exporteinstellungen ExportversionDatumsbereichDaten zusammenfassen und Zeitgruppierung
Erinnerungen planenSynchronisierungsfrequenz und speichernHistorische oder verpasste Daten exportierenFehlerbehebung

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

  1. Wähle MQTT als Automationstyp.
  2. Gib den Hostnamen oder die IP-Adresse des Brokers und den Port ein. Der Standardport ist 1883.
  3. Gib das Topic ein, z. B. health/metrics.
  4. 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.

  1. Verbinde einen MQTT-Abonnenten mit deinem Broker und abonniere das konfigurierte Topic.
  2. Öffne in Health Auto Export die Automation und wähle Manueller Upload unter Vorhandene Daten exportieren.
  3. Lege die Daten für Start und Ende fest und wähle Export starten.
  4. 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.