Debugging
Debug-Modus einschalten
GRIS kann im Debug-Betrieb alle PHP-Meldungen ausgeben, statt nur der Fehler. Dazu kann der Errorlevel im Browser per Parameter für die Dauer der Session umgeschaltet werden. Auch die Ausgabe nur im Log ist möglich. Dadurch ergeben sich drei mögliche Werte für den errorlevel:
// E_ALL + display on
http(s)://[GRIS-SERVER]/index.php?errorlevel=all
// E_ALL + display off
http(s)://[GRIS-SERVER]/index.php?errorlevel=log
// E_ERROR + display on
http(s)://[GRIS-SERVER]/index.php?errorlevel=error
Daneben sind noch die Parameter reload zum erneuten einlesen der Settings aus der /init/gris_init.inc-Datei möglich und der Parameter debug für die Anzeige von Debug-Informationen.
URL-Parameter
| Parameter | Werte | Funktion |
|---|---|---|
| errorlevel | all | log | error | Schaltet nur, wenn das System auf localhost läuft. Schaltet das Error-Reporting von PHP komplett (E_ALL) bzw. nur bei Fehlern (E_ERROR) ein. Ohne Parameter gilt E_ERROR. Die jeweilige Auswahl wird in der Session gespeichert und bleibt solange an, bis der Parameter neu gesetzt wird. |
| reload | true | Lädt die Settings erneut in die Datenbank. |
| debug | on|off | Schaltet die Debug-Anzeige ein bzw. aus. |
Logging Optionen
In der initialen Konfiguration gris_init.inc kann der Loglevel von GRIS angepasst werden:
$loglevel = "debug"; // low, medium, full
Je nach Level werden folgende Ereignisse aufgezeichnet:
| Level | Aufgezeichnete Ereignisse |
|---|---|
| debug | DEBUG | LDAP STATE | ERROR | CHECK RIGHTS |
| low | ERROR | DB INSERT | LDAP STATE | NEW NAME | DEBUG |
| medium | ERROR | DB INSERT | DB UPDATE | LDAP STATE | ldap special chars | NEW NAME |
| full | Alle Ereignisse |
Das aktuelle GRIS-Log kann über den Browser
http://localhost/master/gris/tools/log_view.php?key=my_s3cr3t
Hinweis
Der passende Schlüssel muss vorher in den Settings in der Gruppe security als key hinterlegt werden. Der Standardeintrag lautet my_s3cr3t.
Der Ablageort und die Größe der Logdatei kann über die folgenden Variablen festgelegt werden
- $gris_init_errorlog: Pfad und Name der Datei
- $gris_init_errorlog_suffix: Dateiendung
- $gris_init_max_log_size: Maximale Größe der Datei (bei Überschreitung wird eine neue Datei angelegt, die alte jedoch gespeichert)
Damit die alten Logfiles nicht zu viel Speicherplatz einnehmen, sollten sie regelmäßig gelöscht werden. Eine mögliche Vorgehenseweise wird auf dieser Seite gezeigt.
Generelle Fehlersuche
Einige Fehler sind in den GRIS-Logfiles nicht erkennbar, weil sie nicht direkt in der Anwendung auftreten. In solchen Fällen empfiehlt sich ein Blick in die Logfiles des Servers:
- Apache Access- und Errorlogs
- PHP-Errorlogs
- MySQL-Logs
- System-Logs
Die Pfade der Logs hängen dabei von der verwendeten Systemumgebung ab. Auf Linux-Systemen sind die Logs in der Regel im Ordner /etc/logs zu finden.