Entwicklung

Über das Schnellzugriffsmenü > Entwicklung können Sie eine Reihe von Entwicklungstools zur Feinabstimmung Ihrer Totara-Erfahrung verwenden, einschließlich Debugging und experimentelle Einstellungen. 

Sie könnten auch unsere öffentliche Entwicklerdokumentation hilfreich finden, da sie eine Reihe nützlicher Leitfäden und Ressourcen für Entwickler enthält. 

Unten finden Sie Erläuterungen dazu, was jedes dieser Tools tut (mit Ausnahme von experimentellen Funktionen und Debugging, da diese etwas komplexer sind und daher ihre eigenen dedizierten Seiten haben). 

Webdienst-Testclient

Der Webservice-Test-Client führt die Funktionen für real aus, daher sollten Sie keine Funktionen testen, die Sie nicht kennen.

Alle vorhandenen Webservice-Funktionen sind noch nicht im Testclient implementiert. Um zu überprüfen, ob ein Nutzer auf einige Funktionen nicht zugreifen kann, können Sie einige Funktionen testen, die Sie nicht erlaubt haben. Um klarere Fehlermeldungen zu sehen, stellen Sie das Debugging auf NORMAL: Fehler, Warnungen und Hinweise in Debug-Nachrichten anzeigen.

Cache löschen

Totara kann Themen, Javascript, Sprachzeichenfolgen, gefilterten Text, RSS-Feeds und viele andere berechnete Daten zwischenspeichern. Das Löschen dieser Cache-Speicher löscht diese Daten vom Server und zwingt Browser, Daten erneut abzurufen, damit Sie sicher sein können, dass Sie die aktuellsten Werte sehen, die vom aktuellen Code erzeugt werden. Es besteht keine Gefahr, Caches zu löschen, aber Ihre Website kann eine Weile langsamer erscheinen, bis der Server und die Clients neue Informationen berechnen und sie zwischenspeichern.

Testkurs erstellen

Dieses Tool erstellt Standardtestkurse, die viele Abschnitte, Aktivitäten und Dateien umfassen. Damit soll ein standardisiertes Maß für die Überprüfung der Zuverlässigkeit und Leistung verschiedener Systemkomponenten (z. B. Sicherung und Wiederherstellung) geschaffen werden.

Dieser Test ist wichtig, da es in der Vergangenheit viele Fälle gab, in denen das System mit realen Anwendungsfällen (z. B. einem Kurs mit 1.000 Aktivitäten) nicht funktioniert. Kurse, die mit dieser Funktion erstellt werden, können eine große Menge an Datenbank- und Dateisystemplatz (Zehn Gigabyte) belegen. Sie müssen die Kurse löschen (und auf verschiedene Bereinigungsläufe warten), um diesen Bereich erneut freizugeben.

Jmeter-Testplan erstellen

Dieses Tool erstellt eine JMeter-Testplandatei zusammen mit der Datei mit den Nutzeranmeldeinformationen.

Dieser Testplan ist für die Zusammenarbeit mit https://github.com/moodlehq/moodle-performance-comparison konzipiert, was die Ausführung des Testplans in einer bestimmten Totara-Umgebung erleichtert, Informationen über die Läufe sammelt und die Ergebnisse vergleicht. Sie müssen es herunterladen und das Skript test_runner.sh verwenden oder die Installations- und Nutzungsanweisungen befolgen.

Sie müssen ein Passwort für die Kursnutzer in config.php festlegen (z. B. $CFG->tool_generator_users_password = 'totara';). Es gibt keinen Standardwert für dieses Passwort, um eine unbeabsichtigte Nutzung des Tools zu verhindern. Sie müssen die Option Passwörter aktualisieren verwenden, wenn Ihre Kursnutzer andere Passwörter haben oder sie von tool_generator generiert wurden, aber ohne einen Wert für $CFG->tool_generator_users_password festzulegen.

Es ist Teil des tool_generators, daher funktioniert es gut mit den Kursen, die von den Kursen und den Website-Generatoren generiert werden. Es kann auch mit jedem Kurs verwendet werden, der mindestens Folgendes enthält:

• genügend eingeschriebene Nutzer (abhängig von der gewählten Größe des Testplans) mit der Passwortrücksetzung von Totara

• einer Seitenmodulinstanz

• Eine Forumsmodulinstanz mit mindestens einer Diskussion und einer Antwort

Sie sollten die Kapazität Ihres Servers berücksichtigen, wenn Sie große Testpläne ausführen, da der von JMeter erzeugte Ladebetrag besonders groß sein kann. Die Anlaufzeit wurde entsprechend der Anzahl der Threads (Nutzer) angepasst, um diese Art von Problem zu reduzieren, aber die Last ist immer noch enorm.

Excimer Profiler

In Totara 19.1 ist der Excimer-Profiler als Kernkomponente enthalten, um Leistungsprobleme in Produktionsumgebungen zu diagnostizieren und zu beheben. Dieser Profiler läuft effizient und sicher und erfasst Leistungsdaten für langsame Anfragen, ohne die Systemstabilität zu beeinträchtigen.

Der Profiler ist standardmäßig deaktiviert, auch wenn die PHP-Erweiterung installiert und aktiviert ist.

Anforderungen

Der Excimer-Profiler benötigt die Excimer PHP-Erweiterung. Befolgen Sie die Anweisungen in der Dokumentation von MediaWiki, um die Erweiterung auf Ihrem Server zu installieren und zu aktivieren.

Nach der Installation ist die Profiler-Schnittstelle verfügbar über:

Schnellzugriffsmenü > Entwicklung > Excimer-Profiler.

Aktivieren und Konfigurieren des Profilers

Sie können Excimer konfigurieren über:

Schnellzugriffsmenü > Entwicklung > Excimer-Profiler > Excimer-Einstellungen

Sie können folgende Optionen wählen:

Einstellung	Beschreibung	Standard
Excimer aktivieren	Aktiviert oder deaktiviert den Profiler.	Aus
Automatische Profilerstellung aktivieren	Automatisches Speichern von langsamen Anfrageprofilen.	Aus
Fuzzy-Counting aktivieren	Verwendet die ungefähre Zählung, um die Seitennutzung zu verfolgen.	Aus
Mindestanforderungsdauer (ms)	Nur Profilanfragen sind langsamer als dieser Wert.	5000
Aufgabenmindestdauer(n)	Nur Profil geplante Aufgaben langsamer als dieser Wert.	60
Probenahmezeitraum (ms)	Intervall für Leistungsproben.	10
Verarbeitungsintervall(e)	Häufigkeit der Aufgabenbearbeitung.	10
Stichprobenlimit	Max. Anzahl der zu behaltenden Proben.	1024
Stapellimit	Max. Rekursions-/Stapeltiefe.	1000
Protokollablauf (Tage)	Zeit bis zum Löschen von Profilen.	30
Monate zur Speicherung von ungefähren Zähldaten	Lassen Sie das Feld leer, um Daten auf unbestimmte Zeit zu behalten.	12
Zu bearbeitende Parameter	Entfernt automatisch sensible Parameter (z. B. authtoken, sesskey usw.).	–
Teilweises Speichern aktivieren	Ermöglicht das Speichern von Teilprofilen während lang laufender Prozesse.	Aus
Maximal zu speichern	Maximale Anzahl von langsamen Profilen, die beibehalten werden sollen.	1000
Maximal zu speichern pro Seite	Maximale Anzahl von Profilen pro Skript.	5

Verwenden des Profilers

Wenn die automatische Profilerstellung aktiviert ist, werden Anfragen, die langsamer als der konfigurierte Schwellenwert (Standard: 5 Sekunden) sind, automatisch protokolliert.

Sie können auch manuell ein Profil auslösen:

Web-Beispiel:

/course/view.php?id=2&FLAMEME=1

Wenn keine URL-Parameter vorhanden sind, verwenden Sie ?FLAMEME=1

CLI-Beispiel:

export FLAMEME=1 && php admin/cli/upgrade.php

Interpretation der Ergebnisse

Jedes Profil enthält ein Flammendiagramm, das die Stack-Trace visualisiert:

• X-Achse: Alphabetische Liste aller aufgezeichneten Funktionen (nicht chronologisch)

• Y-Achse: Stapeltiefe (niedriger = früher aufgerufen)

• Breite: Dauer des Funktionsaufrufs

• Farbe: Nur ästhetisch – Farben haben keine Bedeutung

Wenn Sie auf ein Feld klicken, werden diese Funktion und ihr untergeordnetes Element gefiltert, um die Überprüfung zu erleichtern.

Bereinigung und Datenaufbewahrung

Excimerprofile werden automatisch über geplante Aufgaben bereinigt:

• Ablauf Excimer-Protokolle

• Schnellste Excimer-Profile löschen

• Ungefähre Zähldaten der Seitengruppe bereinigen

Sie können festlegen, wie lange Protokolle aufbewahrt werden und wie viele Profile beibehalten werden.

Gesperrte Profile

Einige Profile können gesperrt werden (mit einem „Grund für das Sperrprofil“), um sie vor dem Löschen zu schützen. Gesperrte Profile:

• Sind von der Bereinigung und manuellen Löschung ausgeschlossen

• Kann in Gruppenaktionen nicht gelöscht werden

• Werden für Audits oder Untersuchungen aufbewahrt

Fehler: Gesperrte Profile werden gelöscht, wenn sie zu einem Nutzer gehören, dessen Daten gelöscht werden.

Exportieren und Importieren von Profilen

Exportieren:

Sie können ein Profil als JSON-Datei zur Analyse oder Unterstützung der Berichterstattung exportieren. Verwenden Sie die Schaltfläche Profil exportieren auf der Seite eines Profils.

Überprüfen Sie die exportierten Daten vor der Freigabe, da sie identifizierbare Informationen enthalten können.

Import:

Um ein Profil zu importieren, muss Ihre config.php PHP enthalten:

$CFG->excimer_allow_profile_import = true;

Importierte Profile sind mit einem „Grund“ von gekennzeichnetimport.

Andere Entwicklungstools

Es gibt auch eine Reihe anderer Tools für Entwickler, darunter:

• Bibliotheken von Drittanbietern

• Akzeptanztest

• PHPUnit-Tests

• Vorlagen

• XMLDB-Editor

• Web-API