7.6. Log-Dateien und Log-Rotation#
Auf dieser Seite erfahren Sie, welche Log-Dateien Nubus für UCS speichert und wie das System sie rotiert. Sie behandelt außerdem separate Einstellungen für die Log-Rotation von Univention Directory Listener-Modulen.
7.6.1. Speicherorte von Log-Dateien#
Nubus für UCS speichert seine produktspezifischen Log-Dateien im Verzeichnis /var/log/univention/, zum Beispiel Log-Dateien für die Replikation von Listener und Notifier. Dienste schreiben ihre Log-Meldungen in ihre eigenen Standard-Log-Dateien. Apache schreibt zum Beispiel Log-Meldungen in die Datei /var/log/apache2/error.log.
7.6.2. Log-Rotation#
logrotate verwaltet die Log-Dateien. Es erstellt in konfigurierten Intervallen nummerierte Log-Datei-Archive und löscht ältere Archive. Die UCR-Variablen logrotate/rotate und logrotate/rotate/count steuern die Log-Rotation. Die Variable logrotate/rotate gibt das Rotationskriterium an, zum Beispiel weekly oder size 50M. Die Variable logrotate/rotate/count gibt an, wie viele rotierte Log-Datei-Archive das System aufbewahrt. Standardmäßig rotiert das System Log-Dateien wöchentlich und bewahrt 12 Archive auf.
Zum Beispiel ist die aktuelle Log-Datei für Univention Directory Listener die Datei listener.log. Das Archiv der vorherigen Rotation ist die Datei listener.log.1.
Verwenden Sie die UCR-Variable logrotate/compress, um zu steuern, ob gzip ältere Log-Dateien komprimiert.
7.6.3. Log-Dateien von Listener-Modulen#
Jede Log-Datei im Verzeichnis /var/log/univention/listener_modules hat ihre eigene logrotate-Konfiguration. Log-Dateien von Listener-Modulen verwenden standardmäßig globale Einstellungen und können auch pro Log-Datei abweichende Einstellungen verwenden. Die UCR-Variable logrotate/listener-modules/DIRECTIVE konfiguriert die globalen Einstellungen. Eine vollständige Liste der unterstützten Direktiven finden Sie in der logrotate-Handbuchseite.
7.6.3.1. Globale Einstellungen von logrotate für Listener-Module#
Verwenden Sie diese Einstellungen, wenn Sie dasselbe Rotationsverhalten auf alle Log-Dateien von Listener-Modulen anwenden möchten. Nubus für UCS unterstützt die folgenden Direktiven für Log-Dateien von Listener-Modulen:
- logrotate/listener-modules/rotate#
Legt fest, wie oft das System Log-Dateien von Listener-Modulen rotiert.
- Standardwert:
weekly
- logrotate/listener-modules/rotate/count#
Legt fest, wie viele rotierte Log-Dateien das System behält.
- Standardwert:
12
- logrotate/listener-modules/create#
Legt Berechtigungen und Eigentümer für neu erstellte Log-Dateien fest.
- Standardwert:
640 listener adm
- logrotate/listener-modules/missingok#
Legt fest, ob logrotate fortfährt, wenn eine Log-Datei fehlt.
- Standardwert:
missingok
- logrotate/listener-modules/compress#
Legt fest, ob logrotate rotierte Log-Dateien komprimiert.
- Standardwert:
compress
- logrotate/listener-modules/notifempty#
Legt fest, ob logrotate leere Log-Dateien überspringt.
- Standardwert:
notifempty
7.6.3.2. Abweichende Einstellungen pro Log-Datei#
Verwenden Sie das folgende Muster für UCR-Variablen, um Einstellungen für eine bestimmte Log-Datei zu konfigurieren: logrotate/listener-modules/LOG_FILE_NAME/DIRECTIVE. Verwenden Sie den Namen der Log-Datei ohne die Dateiendung .log. Sie können dieselben Direktiven überschreiben, die im Abschnitt über globale Einstellungen aufgeführt sind. Um zum Beispiel das Rotationsintervall für example.log zu konfigurieren, verwenden Sie logrotate/listener-modules/example/rotate.