Leitfaden zu App-Ereignisprotokollen
Diagnose-App-Ereignisprotokolle exportieren, um Automatisierungen und Exporte zu beheben.
Last updated: May 20, 2026
Auf dieser Seite
- Aktivitätsprotokolle vs. App-Ereignisprotokolle
- Was App-Ereignisprotokolle enthalten
- Wo exportieren
- Vollständiges Diagnose-ZIP (empfohlen für Chat-Support)
- Nur Automatisierungsdomäne
- Wann App-Ereignisprotokolle exportieren
- App-Ereignisprotokolle exportieren (Schritt für Schritt)
- Vor dem Teilen der Protokolle
- Verwandte Leitfäden
Leitfaden zu App-Ereignisprotokollen
App-Ereignisprotokolle helfen bei der Fehlerbehebung, wenn eine Automatisierung oder ein Export nicht wie erwartet funktioniert. Sie können Protokolle aus der App exportieren und sie zur Untersuchung an den Support senden.
Aktivitätsprotokolle vs. App-Ereignisprotokolle
Aktivitätsprotokolle sind der nutzerorientierte Ausführungsverlauf einer einzelnen Automatisierung. Öffnen Sie sie über den Konfigurationsbildschirm der Automatisierung (Aktivitätsprotokolle anzeigen). Sie zeigen Ausführungen nach Zeit gruppiert mit Info-, Warn- und Fehlerereignissen nur für diese Automatisierung. Sie prüfen sie in der App; sie werden pro Automatisierung gespeichert.
App-Ereignisprotokolle sind technische Diagnoseprotokolle für die gesamte App (Automatisierungen, manueller Export, HealthKit-Abfragen, Uploads und zugehörige Abläufe). Sie werden als JSONL gespeichert und als ZIP für den Support exportiert. Das Exportieren von App-Ereignisprotokollen ersetzt nicht das Lesen der Aktivitätsprotokolle in der App – verwenden Sie beides bei einer Meldung.
Was App-Ereignisprotokolle enthalten
App-Ereignisprotokolle umfassen Diagnoseereignisse aus App-Abläufen wie:
- Automatisierungsausführungen
- Manuelle Exporte
- Serveraktivität
- Fehler bei Exportverarbeitung und -validierung
- Diagnosen zu HealthKit-Abfragen und Uploads
Das exportierte ZIP dient der Fehlerbehebung. Es kann Zeitstempel, Ereignisnamen und diagnostischen Kontext ohne Gesundheitsdaten enthalten. Das Paket kann außerdem enthalten:
- Ein Manifest mit App- und Umgebungsmetadaten
- Einen redigierten Automatisierungs-Snapshot (Konfiguration ohne Anmeldedaten oder Geheimnisse)
- IAP-Felder zur Erstinstallation und Grandfathering für Kaufunterstützungsdiagnosen
Exportierte Protokolle enthalten keine rohen HealthKit-Stichproben oder Ihre Gesundheitsdatenwerte.
Wo exportieren
Es gibt drei Wege, Diagnoseprotokolle zu exportieren. Wählen Sie je nach benötigtem Detailgrad.
Vollständiges Diagnose-ZIP (empfohlen für Chat-Support)
Das vollständige Paket enthält app-weites events.jsonl (und ggf. einen rotierten Abschnitt), manifest.json und redigiertes automations.json.
Export von:
- Einstellungen → Erweitert → Ereignisprotokolle exportieren
- Automatisierung → Aktivitätsprotokolle anzeigen → Teilen (Symbolleiste) – exportiert dasselbe vollständige ZIP wie Erweitert, keine reine Einzelautomatisierungsdatei
Teilen Sie das ZIP per Mail, AirDrop oder einem anderen Ziel.
Nur Automatisierungsdomäne
Automatisierungseinstellungen → Automatisierungsprotokolle exportieren exportiert nur automatisierungsbezogene Zeilen aus dem App-Ereignisprotokoll (nach Subsystem gefiltert). Nutzen Sie dies für ein kleineres automatisierungsfokussiertes Paket. In den meisten Supportfällen verwenden Sie das vollständige Diagnose-ZIP aus Erweitert oder Teilen in den Aktivitätsprotokollen.
Wann App-Ereignisprotokolle exportieren
Exportieren Sie Protokolle, wenn Sie ein Problem reproduzieren können, z. B.:
- Automatisierungen laufen nicht zuverlässig
- Wiederholte Upload-Fehler zu Cloud-Zielen
- Unerwartete Exportfehler
- Serververbindungsverhalten, das Sie nicht erklären können
- Langsame Automatisierungsläufe (prüfen Sie auch Aktivitätsprotokolle auf Warnungen zu langsamen Abfragen)
App-Ereignisprotokolle exportieren (Schritt für Schritt)
Vollständiges Diagnose-ZIP:
- Öffnen Sie Health Auto Export.
- Gehen Sie zu Einstellungen → Erweitert → Ereignisprotokolle exportieren, oder öffnen Sie eine Automatisierung → Aktivitätsprotokolle anzeigen → Teilen in der Symbolleiste.
- Teilen Sie das erzeugte ZIP per Mail, AirDrop oder einem anderen Ziel.
Nur Automatisierungsdomäne:
- Öffnen Sie Automatisierungseinstellungen (im Automatisierungsbereich).
- Tippen Sie auf Automatisierungsprotokolle exportieren.
- Teilen Sie das erzeugte ZIP.
Vor dem Teilen der Protokolle
Fügen Sie der Exportdatei Folgendes bei:
- Was Sie erwartet haben
- Was stattdessen passiert ist
- Ungefähre Uhrzeit des Problems
- Betroffener Automatisierungs- oder Exporttyp
- iOS-Version und Gerätemodell
- Screenshots der Aktivitätsprotokolle der betroffenen Automatisierung, wenn relevant
Dieser Kontext hilft dem Support, Ihre Meldung den exportierten Ereignissen zuzuordnen.