Sincronizzare i dati di Apple Health con MQTT
Pubblica dati di salute su un broker MQTT.
Ultimo aggiornamento: 31 ottobre 2026
In questa pagina
Impostazioni di esportazione
Impostazioni di esportazione Versione di esportazioneIntervallo di dateRiepiloga dati e raggruppamento temporalePubblica esportazioni di salute come JSON su un topic del tuo broker MQTT.
Importante — limitazioni delle automazioni: Il dispositivo deve essere sbloccato per leggere i dati di salute, e iOS non garantisce esecuzioni in background alla frequenza che scegli. Rivedi le limitazioni delle automazioni prima di affidarti alle esportazioni automatiche.
Aprire l’automazione
Apri Esporta → Automatico su iPhone, oppure Automazioni nella barra laterale dell’iPad. Seleziona Nuova automazione, oppure apri una esistente per modificarla.
Nome, stato e notifiche
Inserisci un nome che identifichi questa automazione. Attivato consente le esecuzioni automatiche; lascialo disattivato finché non sei pronto.
Scegli le notifiche di esecuzione che vuoi:
- Notifica all’aggiornamento della cache indica che sono stati preparati i dati di esportazione.
- Notifica all’esecuzione indica una pubblicazione corretta sul broker.
Consenti le notifiche quando richiesto. Queste notifiche informano sull’attività; non programmano un’esecuzione.
Configurare la connessione
- Scegli MQTT come Tipo di automazione.
- Inserisci il nome host o l’indirizzo IP del broker e la porta. La porta predefinita è 1883.
- Inserisci il Topic, ad esempio
health/metrics. - Imposta un ID client univoco per ciascuna automazione e inserisci un nome utente e una password se il broker lo richiede.
Il broker deve essere accessibile dal tuo dispositivo. Gli iscritti devono usare il topic esatto, incluse le maiuscole. Riutilizzare un ID client può far sì che le connessioni del broker si sostituiscano a vicenda.
Impostazioni del tipo di dati
Seleziona un Tipo di dati per questa automazione: Metriche di salute, Allenamenti, Sintomi, ECG, Notifiche della frequenza cardiaca, Stato d’animo, Monitoraggio del ciclo o Farmaci. Stato d’animo richiede iOS 18 o successivo; Farmaci richiede iOS 26 o successivo e accesso separato ai farmaci.
Metriche di salute
Scegli Metriche di salute, apri Seleziona metriche di salute e seleziona le misurazioni di cui hai bisogno.
Per limitare le letture ad app o dispositivi specifici, apri Origini preferite, scegli una metrica e seleziona le sue origini. Tutte consente tutte le origini non escluse. Usa Origini escluse per ignorare un’origine nelle metriche di salute di questa automazione. Le esclusioni hanno priorità; non viene sostituita un’origine non selezionata quando quella preferita non ha dati. Seleziona Salva per applicare le opzioni di origine oppure Annulla per scartarle.
Allenamenti
Scegli Allenamenti per esportare i record di allenamento. Includi dati del percorso aggiunge i punti del percorso disponibili ai dati JSON dell’allenamento. Non crea file GPX indipendenti.
Per la Versione 2, attiva Includi metriche dell’allenamento per aggiungere letture come frequenza cardiaca, energia attiva e passi. Scegli Minuti o Secondi per il Raggruppamento temporale delle metriche dell’allenamento; i secondi producono più dettaglio ed esportazioni più grandi. La Versione 1 include sempre le metriche dell’allenamento.
Impostazioni di esportazione
MQTT pubblica solo JSON. I messaggi usano QoS 0 per la pubblicazione in primo piano e QoS 1 per la pubblicazione in background. I messaggi non vengono trattenuti.
Versione di esportazione
Scegli Versione 2 per la struttura dati attuale. Usa Versione 1 quando un flusso esistente dipende dal formato precedente.
Intervallo di date
| Selezione | Dati inclusi |
|---|---|
| Predefinito | Il giorno precedente e oggi fino all’ora dell’esecuzione |
| Dall’ultima sincronizzazione | Dalla sincronizzazione precedente fino all’ora dell’esecuzione |
| Oggi | Oggi fino all’ora dell’esecuzione |
| Ieri | L’intero giorno precedente |
| Ultimi 7 giorni | I sette giorni interi precedenti |
Riepiloga dati e raggruppamento temporale
Per JSON + Metriche di salute, attiva Riepiloga dati per combinare le letture in gruppi temporali, oppure disattivalo per letture individuali quando disponibili. Il riepilogo dipende dalla metrica—ad esempio, i passi vengono sommati e le letture del peso vengono mediate. Le esportazioni CSV delle metriche di salute usano dati riepilogati.
Quando è disponibile Raggruppamento temporale, scegli quanto dettaglio conservare. I gruppi per ora o per giorno producono meno righe di quelli per minuto o secondo. Le opzioni disponibili dipendono dall’intervallo di date e dal formato. Il raggruppamento temporale degli allenamenti si configura separatamente in Allenamenti.
Programma promemoria
Se vuoi un avviso per sbloccare e aprire l’app, attiva Attiva promemoria. Scegli Ogni ora, Tutti i giorni o Giorni selezionati e configura il minuto, l’ora e i giorni come appropriato. Consenti l’accesso alle notifiche quando richiesto; se viene rifiutato, usa Apri le impostazioni delle notifiche.
Un promemoria non esegue l’automazione né conferma una sincronizzazione corretta. Toccalo per aprire l’automazione, oppure usa Apri e sincronizza nella notifica per richiedere un’esecuzione. L’automazione deve essere abilitata; un promemoria può comparire anche dopo un’esecuzione in background corretta. Le modifiche ai promemoria si applicano al salvataggio.
Frequenza di sincronizzazione e salvataggio
Scegli un numero e Minuti, Ore, Giorni o Settimane in Frequenza di sincronizzazione—ad esempio, ogni 15 minuti. È una cadenza desiderata in background, non una pianificazione garantita.
Il dispositivo deve essere sbloccato quando vengono letti i dati di salute. Attiva Aggiornamento in background per Health Auto Export e disattiva la modalità Risparmio energetico per le esecuzioni automatiche. iOS può ritardare le esecuzioni se il dispositivo è rimasto inattivo o le risorse di sistema sono limitate.
Attiva Attivato quando sei pronto per le esecuzioni automatiche e seleziona Aggiorna per salvare l’automazione. Puoi caricare subito un intervallo di date con i passaggi seguenti.
Esportare dati storici o mancati
Usa Caricamento manuale quando configuri per la prima volta l’automazione per esportare dati storici, oppure più avanti per coprire date che la sincronizzazione automatica non ha raggiunto. Puoi anche usarla per verificare la configurazione.
- Collega un iscritto MQTT al tuo broker e iscriviti al topic configurato.
- In Health Auto Export, apri l’automazione e seleziona Caricamento manuale in Esporta dati esistenti.
- Imposta le date di Inizio e Fine e seleziona Avvia esportazione.
- Controlla il JSON ricevuto e le sue date.
Il payload segue il formato di esportazione JSON. Ad esempio:
{
"data": {
"metrics": [
{
"name": "step_count",
"units": "count",
"data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
}
]
}
}
Risoluzione dei problemi
- Errore di connessione: Controlla host, porta, accesso alla rete e requisiti di connessione del broker.
- Errore di autenticazione: Controlla le credenziali e il permesso di pubblicare sul topic.
- Nessun messaggio: Conferma che l’iscritto usa lo stesso broker e il topic esatto, e rivedi i registri attività.
- Messaggio troppo grande: Seleziona meno metriche, un intervallo più breve o un raggruppamento temporale più grossolano.
Apri l’automazione e seleziona Visualizza registri attività per rivedere un’esecuzione. Le avvertenze segnalano possibili problemi come un recupero dati lento; gli errori identificano passaggi non riusciti. Per aiuto nella segnalazione di un problema, consulta Ottenere aiuto.