Nextcloud Logging: Welche Logs gibt es und wie öffnet man sie?

Nextcloud Logging erfasst und do­ku­men­tiert alle re­le­van­ten Er­eig­nis­se und Prozesse innerhalb Ihrer Cloud-Umgebung, um den Status des Systems zu kon­trol­lie­ren und mögliche Fehler früh­zei­tig zu erkennen. Wo die In­for­ma­tio­nen ab­ge­spei­chert werden oder sich ab­spei­chern lassen und wie man Nextcloud-Logs ausliest, hängt von der gewählten Log-Variante ab.

Was versteht man unter Nextcloud Logging?

Nextcloud Logging be­zeich­net die Erfassung und Do­ku­men­ta­ti­on sys­tem­re­le­van­ter In­for­ma­tio­nen innerhalb einer Nextcloud-Instanz. Die Funktion dient vor allem dazu, den Status des Systems zu über­wa­chen und po­ten­zi­el­le Feh­ler­quel­len früh­zei­tig zu iden­ti­fi­zie­ren. Das Logging er­mög­licht es aber ebenso, un­ge­wöhn­li­che Ak­ti­vi­tä­ten und si­cher­heits­re­le­van­te Er­eig­nis­se wie unbefugte Zu­griffs­ver­su­che nach­zu­ver­fol­gen. Die ge­sam­mel­ten In­for­ma­tio­nen werden in Logs ge­spei­chert, die von Ad­mi­nis­tra­to­rin­nen und Ad­mi­nis­tra­to­ren ana­ly­siert werden können, um den rei­bungs­lo­sen Betrieb der Cloud si­cher­zu­stel­len oder Probleme zu beheben.

Welche Nextcloud Log Level gibt es?

Nextcloud un­ter­schei­det zwischen fünf Pro­to­kol­lie­rungs­stu­fen, die angeben, in welchem Umfang In­for­ma­tio­nen pro­to­kol­liert werden. Diese sog. Nextcloud Log Level sehen fol­gen­der­ma­ßen aus:

0 – DEBUG: Auf dieser Stufe werden alle Ak­ti­vi­tä­ten erfasst, es handelt sich also um die aus­führ­lichs­te Pro­to­kol­lie­rung innerhalb von einer Nextcloud-Instanz. 1 – INFO: Hier werden sowohl Da­tei­ak­ti­vi­tä­ten und An­mel­dun­gen von Be­nut­ze­rin­nen be­zie­hungs­wei­se Benutzern als auch Warnungen, Fehler und schwer­wie­gen­de Fehler pro­to­kol­liert. 2 – WARN: Neben Fehlern und schwer­wie­gen­den Fehlern erfasst das Nextcloud Logging auf Level 2 lediglich er­folg­rei­che Ope­ra­tio­nen, die zu einer Warnung vor po­ten­zi­el­len Problemen geführt haben. 3 – ERROR: Es werden aus­schließ­lich schwer­wie­gen­de Fehler und fehl­ge­schla­ge­ne Vorgänge, die sich jedoch nicht negativ auf andere Dienste und Vorgänge auswirken, erfasst. 4 – FATAL: Eine Pro­to­kol­lie­rung erfolgt in diesem Fall nur dann, wenn der Server an­ge­hal­ten wird.

Die Parameter für die Pro­to­kol­lie­rungs­stu­fe werden in der Datei config/config.php definiert. In der Nextcloud config.php ist stan­dard­mä­ßig Log Level 2 (WARN) ein­ge­stellt. Für die Pro­blem­dia­gno­se empfiehlt es sich, DEBUG zu ak­ti­vie­ren. Al­ler­dings sollte die Pro­to­koll­ebe­ne nach der Feh­ler­ana­ly­se wieder auf eine weniger aus­führ­li­che Ebene zu­rück­ge­setzt werden. Da DEBUG eine Vielzahl an In­for­ma­tio­nen pro­to­kol­liert, leidet die Per­for­mance des Servers unter Umständen.

Welche Nextcloud-Logs gibt es und wo findet man sie?

Nextcloud stellt Nut­ze­rin­nen und Nutzern ver­schie­de­ne Log-Typen zur Verfügung, um Ak­ti­vi­tä­ten und Prozesse zu do­ku­men­tie­ren. Mit errorlog, file, syslog und systemd gibt es vier ver­schie­de­ne Logging-Optionen, auf die wir im Folgenden näher eingehen.

errorlog

Bei diesem Verfahren werden alle Log-In­for­ma­tio­nen an error_log() gesendet – also an die Error-Log-Datei des Web­ser­vers. Der Spei­cher­ort hängt von der Wahl und der Kon­fi­gu­ra­ti­on des Servers ab. Wird bei­spiels­wei­se Apache verwendet, sollten Sie die Datei in der Regel unter dem Pfad /var/log/apache2/error.log finden. Sie können den Spei­cher­ort aber grund­sätz­lich auch jederzeit manuell abändern.

file

Alle Nextcloud-Logs landen in einer separaten Datei, die stan­dard­mä­ßig nextcloud.log heißt und sich im Dateipfad /var/www/nextcloud/data/ befindet. Der Name der Datei lässt sich durch den Parameter logfile festlegen, das ge­wünsch­te Da­tums­for­mat optional über den Parameter logdateformat in config/config.php.

syslog

Alle Log-In­for­ma­tio­nen werden an das zentrale Daemon-Programm der Cloud-Software gesendet. Dabei handelt es sich um einen kon­ti­nu­ier­lich aus­ge­führ­ten Hin­ter­grund­pro­zess, der pe­ri­odisch auf­tre­ten­de Ser­vice­an­for­de­run­gen be­ar­bei­tet.

systemd

Bei dieser Art von Nextcloud-Logging werden die Logs im systemd-Journal ge­spei­chert, das sich um die Ver­wal­tung der auf dem System laufenden Dienste kümmert. Vor­aus­set­zung ist, dass die PHP-Er­wei­te­rung php-systemd in­stal­liert ist.

Wie öffnet man Nextcloud-Logs?

Wenn Sie auf da­tei­ba­sier­tes Nextcloud Logging zu­rück­grei­fen, haben Sie die Mög­lich­keit, sämtliche Log-Daten un­kom­pli­ziert über die Ver­wal­tungs­ein­stel­lun­gen (unter „Pro­to­kol­lie­rung“) ein­zu­se­hen. Diese Funktion wird von der Log-Reader-App be­reit­ge­stellt, die Ihnen unter anderem auch erlaubt, Log-Dateien her­un­ter­zu­la­den. Bei den anderen Logging-Optionen lassen sich die Logs per Text­edi­tor und/oder über die Kom­man­do­zei­le öffnen.

Close