Können Nextcloud Logs gelöscht werden?

Die Verwaltung einer self-hosted Cloud-Umgebung bringt eine Reihe von Wartungsaufgaben mit sich, und das Kontrollieren der Log-Dateien ist eine davon. Mit der Zeit können Nextcloud Logs erheblich anwachsen, Speicherplatz verbrauchen, die Admin-Oberfläche verlangsamen und es schwieriger machen, relevante Fehler zu erkennen. 

In diesem Artikel erfährst Du, was Nextcloud Logs sind und ob sie gelöscht werden können, wo sich Log-Dateien in verschiedenen Server-Setups befinden, welche unterschiedlichen Arten von Log-Dateien Administratoren kennen sollten, wie Du sie sicher über das Linux-Terminal löschst, wie Du Log Rotation konfigurierst und wie Du das richtige Log Level für eine Produktionsumgebung einstellst.

Was sind Nextcloud Logs und warum sind sie wichtig?

Nextcloud Logging ist der integrierte Mechanismus, der Systemereignisse, Fehler, Warnungen und Benutzeraktivitäten innerhalb einer Nextcloud Instanz aufzeichnet. Es erfüllt drei zentrale Zwecke für Administratoren:

• •Monitoring: Überwachung des allgemeinen Zustands und Verhaltens des Servers.
• •Troubleshooting: Identifikation der Ursachen von Fehlern, fehlgeschlagenen Prozessen oder unerwartetem Verhalten.
• •Security: Erkennung von unautorisierten Zugriffsversuchen, ungewöhnlichen Login-Mustern und verdächtigen Dateiaktivitäten.

Standardmäßig schreibt Nextcloud alle Log-Daten in eine Datei namens nextcloud.log im Datenverzeichnis des Servers, wenn log_type in config.php auf file gesetzt ist. In stark genutzten Instanzen oder wenn das Log Level zu niedrig eingestellt ist, kann diese Datei innerhalb weniger Wochen mehrere Gigabyte groß werden. Die Verwaltung dieser Datei gehört zu den laufenden Aufgaben beim Betrieb einer self-hosted Instanz. 

Administratoren, die Wartung, Sicherheitsupdates und Backups lieber ausgelagert haben möchten, entscheiden sich häufig für eine managed Nextcloud hosting Lösung, bei der die Infrastruktur vollständig verwaltet wird und der technische Aufwand entfällt.

Um die Frage direkt zu beantworten: Ja, Nextcloud Logs können gelöscht werden. Allerdings bietet Nextcloud keinen One-Click-Button in der Admin-Oberfläche dafür. Die Log Reader App, erreichbar unter Administration Settings, dann Logging, ermöglicht es Administratoren, Log-Einträge anzuzeigen und herunterzuladen, bietet jedoch keine Option zum Löschen. Das Entfernen der Logs erfordert direkten Zugriff auf den Server über das Linux-Terminal.

Wo sich Nextcloud Log-Dateien befinden

Standardmäßig schreibt Nextcloud nach [datadirectory]/nextcloud.log, wenn log_type auf file gesetzt ist. Du kannst den datadirectory-Wert überprüfen und optional den Log-Pfad mit dem Parameter logfile in config/config.php überschreiben:

'datadirectory' => '/var/www/nextcloud/data',

'logfile' => '/var/www/nextcloud/data/nextcloud.log',

Die Speicherorte der Log-Dateien variieren je nach Installationsmethode:

• •Standard Linux (Apache/Nginx): Typischerweise /var/www/nextcloud/data/nextcloud.log, aber überprüfe dies immer über config.php
• •Snap Installation: /var/snap/nextcloud/current/logs/nextcloud.log
• •Docker/AIO: Abhängig von Deinem Volume Mapping. Führe docker inspect <container_name> aus, um das gemappte Datenverzeichnis zu finden, und überprüfe dann den logfile-Pfad in config.php

Ein benutzerdefinierter Log-Pfad kann festgelegt werden, indem Du den Parameter logfile in config/config.php hinzufügst oder anpasst. Stelle dabei sicher, dass das Verzeichnis existiert und der Webserver-Benutzer, üblicherweise www-data oder apache, Schreibrechte für diesen Pfad besitzt.

Arten von Nextcloud Log-Dateien

Nextcloud erzeugt zwei native Log-Dateien. Zu wissen, was jede einzelne aufzeichnet, verhindert, dass Administratoren versehentlich die falsche Datei löschen.

nextcloud.log

Dies ist die primäre Log-Datei, in der alle zentralen Systemereignisse, Warnungen und Fehler gespeichert werden. Sie ist die Datei, die in der Admin-Oberfläche unter Administration Settings, dann Logging sichtbar ist und am häufigsten gelöscht wird.

audit.log

Diese Datei wird von der admin_audit App erzeugt und enthält ein vollständiges Audit-Protokoll, einschließlich Benutzer-Sitzungen, Dateioperationen, Benutzerverwaltung, Freigaben und weiteren administrativen Aktionen. Sie ist besonders wichtig für Compliance und Security Monitoring und sollte nicht ohne sorgfältige Überlegung gelöscht werden.

Es ist außerdem wichtig zu wissen, dass Webserver wie Apache und Nginx ihre eigenen Log-Dateien führen, wie zum Beispiel /var/log/apache2/error.log oder /var/log/nginx/error.log. Diese sind unabhängig von Nextcloud und werden vom jeweiligen Webserver selbst verwaltet.

Wie Du Nextcloud Logs löschst

Die folgenden Befehle werden auf Deinem Linux-Server über SSH oder direkten Terminalzugriff ausgeführt. Es gibt zwei zuverlässige Methoden, um die primäre nextcloud.log Datei zu löschen.

Methode 1: Log-Datei truncaten

Beim Truncaten wird die Datei geleert, ohne sie zu löschen. Das bedeutet, dass Nextcloud weiterhin ohne Unterbrechung in denselben Dateipfad schreibt. Dies ist der sicherste und am meisten empfohlene Ansatz:

sudo truncate -s 0 /var/www/nextcloud/data/nextcloud.log

Für Snap Installationen:

sudo truncate -s 0 /var/snap/nextcloud/current/logs/nextcloud.log

Methode 2: Log-Datei löschen

Das Löschen der Datei ist ebenfalls sicher. Nextcloud erstellt die nextcloud.log automatisch neu, sobald das nächste protokollierbare Ereignis eintritt:

sudo rm /var/www/nextcloud/data/nextcloud.log

Nach der Anwendung einer der beiden Methoden zeigt der Log Viewer unter Administration Settings, Logging beim nächsten Neuladen der Seite den geleerten Zustand an. Falls rotierte Log-Dateien vorhanden sind, wie zum Beispiel nextcloud.log.1, sollten diese ebenfalls entfernt werden, wenn eine vollständige Bereinigung gewünscht ist.

Hinweis: Wenn log_type in config.php auf syslog, systemd oder errorlog gesetzt ist, existiert keine nextcloud.log Datei, die Du truncaten kannst. In diesen Fällen erfolgt das Löschen der Logs über das Logging-Backend Deines Systems, wie zum Beispiel journalctl für systemd oder Deinen syslog Daemon.

Log Rotation konfigurieren

Die Konfiguration der Log Rotation stellt sicher, dass die nextcloud.log Datei gar nicht erst unkontrolliert anwächst.

Die integrierte Rotation von Nextcloud wird über den Parameter log_rotate_size in config.php gesteuert. Der Wert wird in Bytes angegeben, zum Beispiel 104857600 für 100 Megabyte. Sobald die Log-Datei diese Größe erreicht, erstellt Nextcloud eine neue rotierte Datei. Wenn bereits eine zuvor rotierte Datei existiert, wird sie überschrieben. Dies kann direkt in config.php gesetzt werden:

php

'log_rotate_size' => 104857600,

Oder über den occ Befehl konfiguriert werden, ohne config.php manuell zu bearbeiten:

sudo -u www-data php occ config:system:set log_rotate_size --value=104857600 --type=integer

```

**Log Rotation auf OS-Ebene** mit `logrotate` gibt Administratoren mehr Kontrolle, einschließlich der Komprimierung alter Logs und der Aufbewahrung mehrerer rotierter Dateien. Eine grundlegende `logrotate` Konfiguration für Nextcloud sieht wie folgt aus:

```

/var/www/nextcloud/data/nextcloud.log {

weekly rotate 4 compress missingok notifempty }

Die integrierte Rotation von Nextcloud basiert ausschließlich auf der Dateigröße und läuft nicht nach einem Zeitplan. Zeitplanung, Komprimierung und das Aufbewahren mehrerer archivierter Log-Dateien erfordern OS-Level Tools wie logrotate.

Das richtige Log Level einstellen

Log Level steuern direkt, wie viele Daten Nextcloud schreibt, und die Wahl des falschen Levels ist einer der häufigsten Gründe dafür, dass Log-Dateien außer Kontrolle geraten. Nextcloud unterstützt fünf Level:

• •0 – DEBUG: Zeichnet alle Aktivitäten auf. Extrem detailliert und erzeugt das höchste Log-Volumen.
• •1 – INFO: Protokolliert Dateiaktivitäten, Benutzer-Logins, Warnungen und Fehler.
• •2 – WARN: Erfasst Warnungen aus erfolgreichen Prozessen sowie Fehler und kritische Probleme.
• •3 – ERROR: Zeichnet nur kritische Fehler und fehlgeschlagene Prozesse auf, die andere Services nicht beeinflussen.
• •4 – FATAL: Protokolliert nur die schwerwiegendsten Systemfehler.

Das Log Level wird in config.php festgelegt:

php 'loglevel' => 2, Oder über occ:

sudo -u www-data php occ config:system:set loglevel --value=2 --type=integer

Für die meisten Produktionsumgebungen sind Level 2 (WARN) oder Level 3 (ERROR) geeignet. Das temporäre Setzen auf Level 0 beim Troubleshooting ist in Ordnung, aber DEBUG dauerhaft aktiv zu lassen, wird nicht empfohlen. Auf diesem Level kann die Menge der geschriebenen Einträge die Serverleistung beeinträchtigen und den Speicher schnell füllen.

Fazit

Nextcloud Logs können sicher und ohne Risiko für das System gelöscht werden. Das Truncaten der nextcloud.log Datei ist der sauberste Ansatz, da die Datei sofort geleert wird, während die Logging-Pipeline intakt bleibt. Über das manuelle Löschen hinaus besteht die eigentliche Lösung für unkontrolliert wachsende Log-Dateien in einer Kombination aus korrekter Log Rotation über log_rotate_size in config.php und einem passenden Log Level für die Produktionsumgebung. Administratoren, die beides richtig konfigurieren, müssen Logs nur selten manuell löschen. Das Verständnis des Unterschieds zwischen nextcloud.log und audit.log stellt außerdem sicher, dass die richtige Datei verwaltet wird und verhindert das versehentliche Löschen von Daten, die für Security oder Compliance benötigt werden.