Guida ai log eventi dell'app

I log eventi dell'app aiutano a risolvere i problemi quando un'automazione o un'esportazione non si comporta come previsto. Puoi esportare i log dall'app e condividerli con l'assistenza per l'analisi.

Log attività vs log eventi dell'app

I log attività sono la cronologia di esecuzione visibile all'utente per una singola automazione. Aprili dalla schermata di configurazione dell'automazione (Visualizza log attività). Mostrano le esecuzioni raggruppate per ora, con eventi informativi, di avviso e di errore solo per quell'automazione. Li controlli nell'app; sono memorizzati per automazione.

I log eventi dell'app sono log diagnostici tecnici per l'intera app (automazioni, esportazione manuale, query HealthKit, caricamenti e flussi correlati). Sono memorizzati come JSONL ed esportati come ZIP per l'assistenza. Esportare i log eventi dell'app non sostituisce la lettura dei log attività nell'app: usa entrambi quando segnali un problema.

Cosa includono i log eventi dell'app

I log eventi dell'app includono eventi diagnostici generati da flussi dell'app come:

• Esecuzioni delle automazioni
• Esportazioni manuali
• Attività del server
• Errori di elaborazione e validazione dell'esportazione
• Diagnostica di query e caricamenti HealthKit

Lo ZIP esportato è pensato per la risoluzione dei problemi. Può includere timestamp, nomi degli eventi e contesto diagnostico senza dati sanitari. Il pacchetto può includere anche:

• Un manifest con metadati dell'app e dell'ambiente
• Un'istantanea automazioni redatta (configurazione senza credenziali o segreti)
• Campi IAP per installazione originale e grandfathering per la diagnostica degli acquisti

I log esportati non includono campioni HealthKit grezzi né i valori dei tuoi dati sanitari.

Dove esportare

Esistono tre modi per esportare i log diagnostici. Scegli in base al livello di dettaglio necessario.

ZIP diagnostico completo (consigliato per l'assistenza via chat)

Il bundle completo include events.jsonl a livello di app (e un segmento ruotato se presente), manifest.json e automations.json redatto.

Esporta da:

1. Impostazioni → Avanzate → Esporta log eventi
2. Automazione → Visualizza log attività → condividi (barra degli strumenti) — esporta lo stesso ZIP completo di Avanzate, non un file solo per un'automazione

Condividi lo ZIP tramite Mail, AirDrop o un altro destinatario di condivisione.

Solo log del dominio automazioni

Impostazioni automazione → Esporta log automazione esporta solo le righe relative alle automazioni dal log eventi dell'app (filtrate per subsystem). Usalo quando vuoi un bundle più piccolo incentrato sulle automazioni. Nella maggior parte dei casi di assistenza, usa lo ZIP diagnostico completo da Avanzate o dalla condivisione nei log attività.

Quando esportare i log eventi dell'app

Esporta i log quando riesci a riprodurre un problema, ad esempio:

• Le automazioni non si eseguono in modo affidabile
• Errori ripetuti di caricamento verso destinazioni cloud
• Errori di esportazione imprevisti
• Comportamento di connessione al server che non riesci a spiegare
• Esecuzioni lente delle automazioni (controlla anche i log attività per avvisi di query lente)

Come esportare i log eventi dell'app (passo dopo passo)

ZIP diagnostico completo:

1. Apri Health Auto Export.
2. Vai su Impostazioni → Avanzate → Esporta log eventi, oppure apri un'automazione → Visualizza log attività → tocca condividi nella barra degli strumenti.
3. Condividi lo ZIP generato tramite Mail, AirDrop o un altro destinatario di condivisione.

Solo dominio automazioni:

1. Apri Impostazioni automazione (dall'area Automazioni).
2. Tocca Esporta log automazione.
3. Condividi lo ZIP generato.

Prima di condividere i log

Includi quanto segue con l'esportazione dei log:

• Cosa ti aspettavi che accadesse
• Cosa è accaduto invece
• Orario approssimativo del problema
• Tipo di automazione o esportazione coinvolto
• Versione iOS e modello del dispositivo
• Screenshot dei log attività dell'automazione interessata, se pertinenti

Questo contesto aiuta l'assistenza a correlare la segnalazione con gli eventi esportati.

Guide correlate

• Guida alla risoluzione dei problemi
• Guida all'esportazione manuale
• Panoramica delle automazioni