Logging

Warum sollte ich die Moodle Logs überwachen?

Es kann vorkommen, dass durch eine Fehlkonfiguration der Micromate nicht ordnungsgemäss funktioniert. Durch eine Überwachung der Logs können mögliche Probleme frühzeitig aufgespürt und korrigiert werden.

Anleitung

Das Wichtigste in Kürze

Die Micromate Moodle Plugins schreiben wichtige Ereignisse in die Logs von Moodle
Einträge von Micromate in den Logs von Moodle geben wichtige Hinweise auf mögliche Fehler in der Konfiguration des Micromate Plugins.

Wo finde ich die Logeinträge?

Micromate schreibt im Fehlerfall Logeinträge in das Logsystem von Moodle. Du findest diese im Moodle unter “Webseite Administration” → “Berichte” → “Logdaten”:

Beispiel einer Log Nachricht von Micromate in Moodle

Welche Informationen enthält eine Nachricht von Micromate in den Logs?

Micromate versucht die wichtigsten Informationen in die Logs zu schreiben, damit der Fehler schnellstmöglich gefunden werden kann. Eine Nachricht ist dabei wie folgt aufgebaut:

Micromate error [Code XXXX][Course ID: Y][Activity ID: ZZ] Message: NNNNNNN

Name	Platzhalter im Beispiel	Beschreibung

Name	Platzhalter im Beispiel	Beschreibung
Code	XXXX	Error Code, welcher den Fehler eindeutig beschreibt. Details dazu unter Logging \| Welche Error Codes gibt es und was bedeuten diese?
Course ID	Y	Die ID des Kurses, in welchem der Fehler aufgetreten ist. Diese wird nur ausgegeben, wenn sich der Fehler im Kontext von einem Kurs erreignet hat.
Activity ID	ZZ	Die Aktivität, in welcher der Fehler aufgetreten ist. Diese wird nur ausgegeben, wenn sich der Fehler im Kontext von einer Aktivität erreignet hat.
Message	NNNNNNN	Die Nachricht welche den Fehler beschreibt. Dieses kann Fehlerspezifische Informationen wie z.B. die ID des Benutzers enthalten.

Wie gelange ich von einer Course ID auf den passenden Kurs?

Ein Nachricht von Microamte in den Logs kann eine “Course ID” enthalten. Diese beschreibt den Kurs, in welchem der Fehler aufgetreten ist.

Die einfachste Methode um von dieser ID auf den dazu passenden Kurs zu gelangen ist, diesen direkt über die passende URL anzusteuern. Gehe dazu wie folgt vor:

Navigiere in deinem Moodle auf einen Beliebigen Kurs
Ersetze den ID-Parameter in der URL mit der Course-ID aus der Log-Nachricht:

Wie gelange ich von einer Activity ID auf die passende Aktivität?

Ein Nachricht von Microamte in den Logs kann eine “Activity ID” enthalten. Diese beschreibt die Aktivität, in welcher der Fehler aufgetreten ist.

Die einfachste Methode um von dieser ID auf die dazu passende Aktivität zu gelangen ist, diese direkt über die passende URL anzusteuern. Gehe dazu wie folgt vor:

Navigiere in deinem Moodle auf den Kurs in welchem sich die Aktivität befindet
Wechsle in den Bearbeitungsmodus
Öffne die Einstellungen einer beliebigen Aktivität
Ersetze den update-Parameter in der URL mit der Activity-ID aus der Log-Nachricht:

Welche Arten von Error Codes gibt es?

Micromate unterscheidet zwei Arten von Error Codes.

Typ	Beschreibung	Beispiel

Typ	Beschreibung	Beispiel
Konfigurationsfehler	Die Konfiguration des Moodle Plugins ist nicht korrekt. z.B. wurde eine Lerngruppe ausgewählt, welche unterdessen gelöscht wurde.	1002
Systemfehler	Im Micromate Moodle Plugin ist ein unerwarteter Fehler aufgetreten. Dabei kann es sich um einen effektiven Fehler im Plugin selbst handeln, oder das z.B. die Micromate Schnittstelle nicht erreichbar war.	2001

Welche Error Codes gibt es und was bedeuten diese?

Konfigurationsfehler

Konfigurationsfehler sind meist ein Fehler der durch dich gelöst werden kann.

Code	Beschreibung	Lösungshinweise

Code	Beschreibung	Lösungshinweise
1001	Problem mit der Benutzeridentifikation Dieser Fehler kann nur auftreten, wenn der Identifikations Modi auf ID-Nummer oder E-Mail gesetzt ist. In diesem Fall kann das Micromate Moodle Plugin nicht alle benötigten Informationen finden, um den Benutzer zu identifizieren. Die Fehlermeldung beinhaltet die ID des Benutzers, für welchen die Identifikation nicht funktioniert hat.	Überprüfe in den Micromate Plugin Einstellungen, welchen Identifikations Modi du eingestellt hast. Falls E-Mail ausgewählt wurde: Prüfe den Benutzer, ob in seinem Profil eine gültige E-Mail Adresse eingetragen wurde. Falls ID-Nummer ausgewählt wurde: Prüfe den Benutzer, ob in seinem Profil eine gültige ID-Nummer eingetragen wurde.
1002	Problem mit der Tag Konfiguration Dieser Fehler kann auftreten, wenn die Tags für ein Lernpaket nicht abgefragt werden konnten, oder die Aktivierung/Deaktivierung fehlgeschlagen ist. Ursachen können dabei sein: Die auf dem Moodle Kurs konfigurierte Gruppe existiert nicht mehr Das Lernpaket, welches in den Micromate Einstellungen einer Aktivität für die Tag-Aktivierung konfiguriert ist, existiert nicht mehr. Das Lernpaket, welches in den Micromate Einstellungen einer Aktivität für die Tag-Aktivierung konfiguriert ist, ist in der Lerngruppe nicht mit der Einstellung “Manuelle Aktivierung” konfiguriert. Der Tag, welcher in den Micromate Einstellungen einer Moodle Aktivität für die Tag-Aktivierung konfiguriert ist, existiert nicht mehr oder ist nicht mehr als Aktivierungstag konfiguriert.	Überprüfe die Micromate Einstellungen auf dem Kurs Überprüfe die Micromate Einstellungen auf den Aktivitäten
1003	Problem mit der Lerngruppe Dieser Fehler kann auftreten, wenn aufgrund einer fehlerhaften Konfiguration Lernende nicht der passenden Micromate Lerngruppe zugewiesen werden können.	Überprüfe die Micromate Einstellungen auf dem Kurs
1004	Problem mit der Organisation Dieser Fehler kann auftreten, wenn die Organisation im Micromate Moodle Plugin nicht korrekt konfiguriert ist. In diesem Fall kann das Micromate Moodle Plugin keinerlei Operationen über die Schnittstelle von Micromate ausführen.	Überprüfe in den Einstellungen des Micromate Local Plugins, ob die folgenden Eigenschaften korrekt gesetzt sind: Organization ID Zugangsschlüssel
1005	Problem mit einem Lernenden Dieses Problem kann auftreten, wenn die Identifikation von einem Benutzer geändert wurde.	Falls als Identifikations Modi E-Mail oder ID-Nummer ausgewählt wurde, muss Moodle so konfiguriert sein, dass der Lernende diese Felder nicht anpassen kann.

Systemfehler

Systemfehler melden ein Problem, welches durch Micromate angeschaut werden muss. Melde disee Fehler an info@micromate.ai, gerne helfen wir dir weiter um das Problem schnellstmöglich zu beheben.200

Code	Beschreibung	Vorgehen

Code

Beschreibung

Vorgehen

2001

Unbekannter Fehler
Bei diesem Fehler hat das Plugin ein Problem festgestellt, konnte aber die Ursache nicht identifizieren. Dies deutet meist auf ein Bug in dem Plugin selbst hin.

Dieser Fehler sollte in jedem Fall an Micromate gemeldet werden.

2002

Fehler beim laden des Widgets
Beim laden des Micromate Widgets ist ein Fehler aufgetaucht. Dies deutet meist auf ein Bug in dem Plugin selbst hin.

Dieser Fehler sollte in jedem Fall an Micromate gemeldet werden.

2003

Fehler in der Verbindung mit dem Micromate Webservice
Das Micromate Plugin kommuniziert im Hintergrund mit Micromate. Dieser Fehler deutet darauf hin, dass der Webservice von Micromate nicht erreichbar war oder ein Fehler hatte.

Dies könnte ein temporäres Problem sein. Beobachte die Logs weiter, sollte der Fehler auch nach 5 Minuten noch auftauchen, dann solltest du Kontakt mit Micromate aufnehmen.

Gegebenenfalls kann dir Nachricht