Diagnose

Die Echo-Einstellungen zeigen unter Diagnose Events & Logs und Über. Soundwave ist zusätzlich im Entwickler- oder Administratormodus vorhanden und gehört nicht zum normalen Supportweg.

Ereignisse und Protokolljournal

Das Panel Events & Logs hält beide Aufzeichnungen hinter einer Registeransicht bereit: Ereignisse (das Ereignisjournal der App), Protokolljournal (die Dateien unter ~/.budgie/echo/logs/) und eine Alle-Ansicht über beides. Eine Auswahl der Benachrichtigungsschwelle entscheidet, welche Ereignisse zusätzlich einen Toast auslösen — Debug, Info, Warning oder Error, Standard ist Error. Die Werkzeugleiste bietet Stufenfilter, Textsuche, eine Protokolldateiauswahl, automatische Aktualisierung und je Register Löschen-Aktionen.

Die Ereignisse sind nach einer fehlgeschlagenen Aufnahme, Modelloperation, Anbieteranfrage oder Workflow-Ausführung der erste Prüfpunkt. Zeilen klappen auf und zeigen die strukturierten Daten, die sie tragen. Das Leeren der Ereignisse löscht keine Protokolldateien. Ereignisdetails können Modellnamen, Aktionsdetails, Kennungen oder Fehler enthalten. Prüfen Sie sie daher vor dem Kopieren.

Protokolle löschen entfernt die Dateien nach einer Bestätigung dauerhaft.

Protokolle können Pfade, Endpunktinformationen, Kontokontext und Aktionseingaben enthalten oder weitere Werte, die bei einem Fehler entstanden sind. Gehen Sie nicht davon aus, dass Diagnoseausgaben automatisch sicher zu teilen sind.

Über

Über zeigt App-Version, Konto- und Tarifstatus, Cloud- und lokales Guthaben sowie das Zurücksetzen des Onboardings. Direkt vertriebene Builds bieten eine Update-Prüfung in der App; Mac App Store-Builds erhalten Aktualisierungen über den Store.

Fehler melden sendet Titel und Beschreibung über das authentifizierte Gateway. Ist Anwendungsprotokolle einschließen ausgewählt, hängt Echo aus dem neuesten Protokoll bis zu den 500 neuesten Zeilen, begrenzt auf etwa 100 KB, an. Die Anfrage kann außerdem Kontokennungen, die App-Version und die Plattform enthalten. Deaktivieren Sie die Option, wenn Sie das Protokoll nicht prüfen und sicher teilen können.

Paket für die Fehlerbehebung

Sammeln Sie für einen hilfreichen Bericht:

1. Echo-Version, Plattform und Vertriebsweg aus Über und der Plattformunterstützung.
2. Den genauen Auslöser oder die verwendete Schaltfläche sowie den kleinsten reproduzierbaren Workflow.
3. Die erste relevante Warnung oder Fehlermeldung unter Ereignisse.
4. Falls nötig, einen kurzen, relevanten Abschnitt aus Protokolle.
5. Erwartetes und tatsächliches Ergebnis sowie die Auswirkung eines einzelnen Wiederholungsversuchs.

Hängen Sie nicht den gesamten Protokollverlauf an, wenn ein kurzer Ausschnitt den Fehler zeigt.

Sicheres Schwärzen

Entfernen Sie vor dem Senden oder Einfügen von Diagnosedaten:

• Transkriptionstext, ausgewählten Text, Prompts, Workflow-Ausgaben und Kundendaten;
• Benutzerverzeichnis-, Datei-, Aufnahme- und private Netzwerkpfade;
• Zugriffstoken, API-Schlüssel, Cookies, Autorisierungsheader und Deep-Link-Werte;
• E-Mail-Adressen, Konto-, Rezept- und Maschinenkennungen sowie nicht benötigte Endpunkt-URLs;
• nicht relevante Zeilen vor und nach dem Fehler.

Die Schwärzung ist Ihre letzte Kontrolle: Ereignisse und Protokolle sind Betriebsdaten und keine Datenschutzgrenze. Bewahren Sie Zeitstempel, Schweregrad, Subsystem, App-Version und den für die Diagnose benötigten Fehlertext.

Fahren Sie mit der Fehlerbehebung für problembezogene Schritte fort.