Geschätzte NVDA-Anwenderinnen und -Anwender sowie jene, die es noch werden möchten,

Erklärbär - Fehler aufspüren mit der NVDA-Protokollierung

Kennen Sie das? NVDA verhält sich plötzlich unerwartet oder eine neu installierte Erweiterung funktioniert nicht richtig. Wenn Sie in Foren, in Mailinglisten oder bei Entwicklern nach Hilfe fragen, lautet die allererste Gegenfrage meistens: „Was steht denn dazu im NVDA-Protokoll?“ Heute schauen wir uns an, wofür diese Protokollierung gedacht ist, wie Sie sie einstellen und wie Sie die gesammelten Informationen ganz einfach weitergeben können.

Wofür ist die Protokollierung überhaupt gut?

NVDA hat die Möglichkeit, im Hintergrund aufzuzeichnen, was das Programm intern gerade abarbeitet. Wenn ein Fehler auftritt, wird dieser in einer sogenannten Protokolldatei (Log-Datei) notiert. Für die Entwickler von NVDA oder von speziellen Add-ons sind diese detaillierten Informationen extrem wichtig, um die genaue Ursache eines Problems nachvollziehen und es schnell beheben zu können.

Wo finde ich die Einstellungen und welche Stufen gibt es?

Sie können in NVDA genau einstellen, wie detailliert diese Aufzeichnungen sein sollen.

1. Öffnen Sie das NVDA-Menü mit NVDA + N.
2. Navigieren Sie zu Optionen, dann auf Einstellungen und betätigen Sie die Eingabetaste.
3. Wählen Sie in der Kategorienliste nun den Punkt Datenschutz und Sicherheit aus und navigieren Sie mit der Tab-Taste bis zum Kombinationsfeld Protokollierungsstufe.

Hier können Sie aus den folgenden Stufen wählen:

• Ausgeschaltet / Keine: NVDA zeichnet keine Meldungen auf.
• Informationen: NVDA protokolliert grundlegende Infos, die für Entwickler nützlich sind.
• Debug-Warnmeldungen: Es werden Warnmeldungen notiert, die noch keine ganz schweren Fehler sind.
• Ein- und Ausgaben: Diese Stufe protokolliert wirklich alles – jede Eingabe über die Tastatur oder Braillezeile und jede Ausgabe über die Sprache. Achtung Datenschutz: Nutzen Sie diese Stufe nur gezielt zur Fehlersuche und geben Sie in dieser Zeit niemals Passwörter oder sensible Daten ein!
• Debug-Meldungen: Die detaillierteste Stufe. Zusätzlich zu allen Warnungen werden sehr tiefe System-Meldungen protokolliert. Auch hier gilt absolute Vorsicht beim Thema Datenschutz.

Wie kann ich das Protokoll anzeigen lassen und speichern?

Um in Echtzeit zu sehen, was NVDA aufgezeichnet hat, gibt es den Protokoll-Betrachter.

• Sie finden ihn im NVDA-Menü unter Werkzeuge -> Protokoll-Betrachter.
• Noch schneller öffnen Sie ihn mit der Tastenkombination NVDA + F1.

Wichtiger Hinweis: Wenn Ihre Protokollierungsstufe auf „Ausgeschaltet“ bzw. „Keine“ eingestellt ist, wird logischerweise nichts aufgezeichnet. In diesem Fall bleibt der Protokoll-Betrachter komplett leer und auch die Tastenkombination NVDA + F1 zeigt dann keinerlei Wirkung!

Wenn Sie das Protokoll geöffnet haben, können Sie den Text ganz normal lesen. Hier sind noch zwei sehr nützliche Tastenbefehle direkt für den Betrachter:

• F5 drücken: Damit können Sie den Inhalt jederzeit aktualisieren. So sehen Sie sofort, wenn im Hintergrund neue Meldungen dazugekommen sind.
• Strg + S drücken: Damit speichern Sie den gesamten Text des Protokolls bequem als Datei auf Ihrem Computer ab. Diese Datei können Sie dann ganz einfach als E-Mail-Anhang an Entwickler oder Foren-Mitglieder weitergeben.

Der Erklärbär-Trick: Nur das Wichtigste in die Zwischenablage kopieren

Oft ist so eine Protokolldatei riesig lang und Sie möchten eigentlich nur genau die paar Sekunden festhalten, in denen das Problem aufgetreten ist. Dafür gibt es einen genialen Kurzbefehl, ganz ohne den Betrachter öffnen zu müssen: Drücken Sie NVDA + Strg + Umschalt + F1. Wenn Sie diese Tastenkombination einmal drücken, setzt NVDA intern eine unsichtbare Startmarke im Protokoll. Wenn Sie nun den Fehler auslösen und die Tastenkombination direkt ein zweites Mal drücken, wird exakt der Teil des Protokolls ab Ihrer Startmarke in Ihre Windows-Zwischenablage kopiert. Sie können diesen Text dann einfach mit Strg + V in eine E-Mail oder einen Forumsbeitrag einfügen!

Probieren Sie es ruhig einmal aus! Viel Spaß beim Entdecken wünscht Ihnen Ihr Erklärbär-Team!