Overview
Wann brauche ich das?
Wenn Primuse abstürzt, nicht mehr reagiert, beim Scannen Titel auslässt, keine Verbindung zu einer Musikquelle bekommt oder die Wiedergabe abbricht, braucht der Entwickler meist eine Aufzeichnung genau dieses Moments. Diagnosedaten bleiben auf Ihrem Gerät und werden nie automatisch gesendet; sie verlassen das Gerät nur, wenn Sie sie selbst senden.
Bevor Sie beginnen
- App-Version prüfen: Unter Einstellungen → Über sehen Sie Version und Build. Geben Sie beides in Ihrer Meldung an.
- Zum Hochladen brauchen Sie eine Internetverbindung. Pro Gerät sind 5 Uploads pro Tag möglich, jedes Paket darf höchstens 8 MB groß sein.
Schritt 1: Diagnosemodus einschalten (empfohlen)
- Öffnen Sie Einstellungen → Über → „Diagnoseberichte“.
- Mac: Einstellungen → Über → „Diagnoseprotokolle…“, dann im geöffneten Fenster auf „Diagnoseberichte“ klicken.
- Apple TV: „Diagnoseberichte“ in Einstellungen öffnen.
- Schalten Sie „Ausführliche Protokolle aufzeichnen“ ein. In den nächsten 24 Stunden zeichnet die App zusätzliche Details zur Fehlersuche auf und schaltet die Option danach selbst aus.
- Stellen Sie das Problem nach (z. B. erneut scannen, den Titel erneut abspielen oder die Quelle neu verbinden) und notieren Sie die ungefähre Uhrzeit.
Was vor dem Einschalten passiert ist, steht nur im normalen Protokoll und ist eventuell zu wenig detailliert. Stellen Sie das Problem deshalb am besten einmal mit eingeschaltetem Diagnosemodus nach.
Schritt 2: An den Entwickler hochladen
- Tippen Sie in der Ansicht „Diagnoseberichte“ in der Symbolleiste auf „An den Autor senden“.
- Wählen Sie unter „Anhänge (optional)“, was mitgeschickt wird: „Diagnoseberichte“ (Absturz- und Hängeberichte, Laufzeitmetriken) und „Protokolle“.
- Fügen Sie bei Bedarf unter „Bilder (optional)“ Bildschirmfotos hinzu (bis zu 6, werden automatisch verkleinert) und beschreiben Sie unter „Wünsche oder Vorschläge“, was Sie getan haben, was Sie erwartet haben, was tatsächlich passiert ist und ungefähr wann.
- Tippen Sie unten auf „An den Autor hochladen“. Nacheinander erscheinen „Wird gepackt…“, „Wird hochgeladen: … %“ und „Wird bestätigt…“.
- Wenn „An den Autor hochgeladen“ erscheint, tippen Sie auf „Code kopieren“ und nennen Sie den Code in Ihrer Meldung auf GitHub oder per E-Mail.
Erwartetes Ergebnis: Ein Berichtscode wird angezeigt. Nach einem erfolgreichen Upload werden die hochgeladenen Berichte und Protokolle vom Gerät entfernt.
Apple TV hat keine System-Absturzberichte; hochgeladen werden nur Protokoll und Nachricht. Nachdem der Code erscheint, können Sie mit „Weiteren Bericht senden“ ein weiteres senden.
Wenn Hochladen nicht geht: E-Mail oder Teilen
- Unter der Upload-Schaltfläche finden Sie „Stattdessen per E-Mail senden“ bzw. „Stattdessen teilen“. Die E-Mail enthält die ausgewählten Berichte oder Protokolle als Anhang; Sie prüfen sie vor dem Senden.
- Ist der Upload-Dienst nicht verfügbar, fehlt die Upload-Schaltfläche; die Symbolleiste zeigt dann „Mail öffnen“ oder „Teilen“, und die E-Mail-Adresse des Entwicklers wird angezeigt.
- Versionen vor 1.12.2 haben keinen Upload; nutzen Sie „An den Autor senden“ für E-Mail oder Teilen.
Einen einzelnen Bericht teilen
Tippen Sie in „Diagnoseberichte“ auf einen Bericht, um nur diesen zu teilen. Auf dem Mac zeigt „Protokolle exportieren“ die Protokolldatei im Finder.
Bedeutung der Optionen
| Option | Bedeutung |
|---|---|
| Absturz- und Hängerberichte | Berichte, die das System nach einem Absturz oder längerem Hängen hinterlässt; erscheinen meist erst nach dem nächsten Öffnen der App |
| Laufzeitmetriken | Regelmäßige Laufzeitdaten des Systems, etwa Spitzen-Arbeitsspeicher und Beendigungsgründe |
| Protokolle | Eigene Aufzeichnungen der App zu Wiedergabe, Scannen und Synchronisierung; Uploads und Teilen enthalten nur den neuesten Teil |
| Ausführliche Protokolle aufzeichnen | Zeichnet 24 Stunden lang mehr Details auf und schaltet sich dann aus |
| Protokolle löschen | Löscht die Protokolle auf diesem Gerät; nicht rückgängig zu machen |
Datenschutz
Protokolle enthalten Titelnamen und Dateipfade; Adressen und Konten von Musikquellen werden zu kurzen Kennungen verkürzt. Passwörter, Tokens und andere Zugangsdaten werden vor dem Schreiben entfernt. Hochgeladene Daten dienen nur der Fehlersuche und werden nach 30 Tagen vom Server des Entwicklers gelöscht (bei Platzmangel eventuell früher). Vor dem Senden können Sie „Protokolle“ abwählen oder Bildschirmfotos weglassen.
Einschränkungen
- Ein Upload ist nach dem Packen höchstens 8 MB groß; pro Gerät 5 Uploads am Tag, auch nicht abgeschlossene Versuche zählen.
- Berichte und Protokolle bleiben etwa 7 Tage auf dem Gerät.
- Apple TV hat keine Absturz- und Hängeberichte; die Apple Watch hat keine Diagnoseansicht – melden Sie Probleme über das gekoppelte iPhone.