Debug-Modus für einzelne Personen

Komponente tool_userdebug · Version v5.0.3 (2026081700)

Einsatz und Zielgruppe

Das Plugin ist für die Administration und den technischen Support gedacht. Es hilft, wenn ein Fehler auf der Produktivplattform untersucht werden muss und die Debug-Ausgabe von Moodle dafür nötig ist. Ohne das Plugin müsste man den Debug-Modus für alle einschalten oder die config.php ändern.

Das Plugin stammt von Andreas Grabs und ist auf moodle.org veröffentlicht. eLeDia setzt es unverändert ein.

Einrichtung

1. Installieren Sie das Plugin unter admin/tool/userdebug und schließen Sie die Installation ab.
2. Lassen Sie die Moodle-Einstellung Debug-Meldungen auf Keine. Das Plugin übernimmt die Fehlerausgabe für ausgewählte Personen.
3. Die Verwaltung finden Sie unter Website-Administration → Entwicklung → User related debugmode.

Debugging für ausgewählte Personen

Auf der Verwaltungsseite sehen Sie die aktuellen Debug-Nutzer. So fügen Sie Personen hinzu:

1. Suchen Sie die Person in der Liste der möglichen Nutzer.
2. Fügen Sie sie der Liste Current debug users hinzu.
3. Legen Sie die Debug-Optionen fest: den Debug-Modus selbst und bei Bedarf SMTP- und IMAP-Debugging.
4. Speichern Sie.

Für diese Personen zeigt Moodle nun alle Debug-Meldungen an, für alle anderen nicht. Im Menü erscheint der Hinweis, dass der Debug-Modus aktiv ist. Entfernen Sie Personen aus der Liste, sobald die Untersuchung abgeschlossen ist.

Ad-hoc-Debugging für die eigene Sitzung

Für eine schnelle Prüfung reicht oft die eigene Sitzung:

1. Öffnen Sie das Nutzermenü oder das Menü der Startseite.
2. Wählen Sie Ad hoc debug.
3. Der Debug-Modus gilt nun nur für Ihre Sitzung.

Nach dem Abmelden ist er wieder aus. Sie müssen also nicht daran denken, ihn abzuschalten. Dafür brauchen Sie das Recht tool/userdebug:adhocdebug, das in der Regel nur die Administration hat.

Veraltete Bootstrap-Klassen anzeigen

Eine weitere Option hebt veraltete Bootstrap-Klassen in der Oberfläche hervor. Das hilft bei der Prüfung eigener Themes oder Plugins nach einem Moodle-Update.

Schritt für Schritt: einen Fehler untersuchen

1. Lassen Sie sich von der betroffenen Person genau beschreiben, auf welcher Seite und bei welcher Aktion der Fehler auftritt.
2. Schalten Sie für sich selbst das Ad-hoc-Debugging ein.
3. Wiederholen Sie die Aktion. Tritt der Fehler nur bei der betroffenen Person auf, nehmen Sie diese für kurze Zeit in die Liste der Debug-Nutzer auf und bitten sie, die Aktion zu wiederholen und die Meldung zu kopieren.
4. Sichern Sie die Meldung mit Datum und Seite, etwa im Ticket.
5. Entfernen Sie die Person wieder aus der Liste und melden Sie sich ab.

So bleibt der Debug-Modus nur so lange aktiv, wie Sie ihn brauchen.

Datenschutz

Das Plugin speichert, welche Personen den Debug-Modus erhalten. Weitere personenbezogene Daten speichert es nicht. Beachten Sie: Debug-Meldungen können interne Pfade, Datenbankabfragen und in seltenen Fällen Daten anderer Personen anzeigen. Geben Sie den Debug-Modus nur Personen, die ohnehin Zugriff auf solche Informationen haben.

Grenzen

• Das Plugin zeigt Meldungen an, es sammelt sie nicht. Für eine dauerhafte Fehlererfassung brauchen Sie ein Protokoll- oder Monitoring-System.
• Fehler, die vor dem Laden der Sitzung auftreten, zeigt es nicht.
• Fehler bei geplanten Aufgaben erscheinen weiterhin nur in deren Protokoll.

FAQ und Fehlerbehebung

Ich sehe keine Debug-Meldungen. Prüfen Sie, ob Sie in der Liste der Debug-Nutzer stehen oder das Ad-hoc-Debugging aktiv ist, und laden Sie die Seite neu.

Andere Personen sehen Debug-Meldungen. Prüfen Sie die Moodle-Einstellung Debug-Meldungen. Sie sollte auf Keine stehen.

Muss ich das Plugin vor einem Update deaktivieren? Nein. Entfernen Sie aber alle Personen aus der Liste, wenn keine Untersuchung läuft.

Der Menüeintrag Ad hoc debug fehlt. Ihnen fehlt das Recht tool/userdebug:adhocdebug.