Leitfaden zu App-Ereignisprotokollen

Diagnose-App-Ereignisprotokolle exportieren, um Automatisierungen und Exporte zu beheben.

Last updated: May 20, 2026

Auf dieser Seite

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:

  1. Einstellungen → Erweitert → Ereignisprotokolle exportieren
  2. 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:

  1. Öffnen Sie Health Auto Export.
  2. Gehen Sie zu Einstellungen → Erweitert → Ereignisprotokolle exportieren, oder öffnen Sie eine Automatisierung → Aktivitätsprotokolle anzeigenTeilen in der Symbolleiste.
  3. Teilen Sie das erzeugte ZIP per Mail, AirDrop oder einem anderen Ziel.

Nur Automatisierungsdomäne:

  1. Öffnen Sie Automatisierungseinstellungen (im Automatisierungsbereich).
  2. Tippen Sie auf Automatisierungsprotokolle exportieren.
  3. 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.

Verwandte Leitfäden