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:

  • PHP-Errorlog

  • MySQL-Log

  • System-Log