Nicht kategorisiert

lehnrotat- (8) Handbuch Seite

lehnrotat- (8) Handbuch Seite

Name

Lehnrotat - Dreht, komprimiert und mailen Systemprotokolle

Zusammenfassung

Lehnrotat [-dv] [-F|-Gewalt] [-S|-Zustand Statefile] Konfigurationsdatei…

Beschreibung

Lehnrotat wurde entwickelt, um die Verabreichung von Systemen zu erleichtern, die eine große Anzahl von Protokolldateien generieren. Es ermöglicht die automatische Rotation, Komprimierung, Entfernung und Versandung von Protokolldateien. Jede Protokolldatei kann täglich, wöchentlich, monatlich oder wenn sie zu groß wächst.

Normalerweise, Lehnrotat wird als täglicher Cron -Job geleitet. Es wird ein Protokoll nicht mehr als einmal an einem Tag ändern, es sei denn, das Kriterium für dieses Protokoll basiert auf der Größe des Protokolls und basiert Lehnrotat wird mehr als einmal jeden Tag laufen oder nicht die -F oder -Gewalt Option wird verwendet.

Eine beliebige Anzahl von Konfigurationsdateien kann in der Befehlszeile angegeben werden. Spätere Konfigurationsdateien können die in früheren Dateien angegebenen Optionen überschreiben, sodass die Reihenfolge, in der die Lehnrotat Konfigurationsdateien sind aufgelistet, ist wichtig. Normalerweise sollte eine einzelne Konfigurationsdatei verwendet werden, die alle anderen Konfigurationsdateien enthält, die benötigt werden. Weitere Informationen zur Verwendung der Verwendung der Verwendung finden Sie weiter enthalten Richtlinie, um dies zu erreichen. Wenn in der Befehlszeile ein Verzeichnis angegeben ist, wird jede Datei in diesem Verzeichnis als Konfigurationsdatei verwendet.

Wenn keine Befehlszeilenargumente angegeben werden, Lehnrotat Drucken Sie Informationen und Urheberrechtsinformationen zusammen mit einer kurzen Nutzungszusammenfassung. Wenn beim Drehen von Protokollen Fehler auftreten, Lehnrotat wird mit dem Status ungleich Null beenden.

Optionen

-D
Schaltet den Debug -Modus ein und impliziert -v. Im Debug -Modus werden keine Änderungen an den Protokollen oder an der Lehnrotat Statusdatei.
-F, -Gewalt
Erzählt Lehnrotat Um die Rotation zu erzwingen, auch wenn sie nicht der Meinung ist, dass dies notwendig ist. Manchmal ist dies nützlich, nachdem er einen neuen Einträge zu einem hinzugefügt hat Lehnrotat Konfigurationsdatei oder wenn alte Protokolldateien von Hand entfernt wurden, wie die neuen Dateien erstellt werden, und die Protokollierung wird korrekt fortgesetzt.
-M, -Post
Erzählt Lehnrotat Welcher Befehl zum Versenden von Protokollen verwendet werden. Dieser Befehl sollte zwei Argumente akzeptieren: 1) das Thema der Nachricht und 2) des Empfängers. Der Befehl muss dann eine Nachricht auf Standardeingaben lesen und an den Empfänger senden. Der Standard -Mail -Befehl ist /usr/bin/mail -s.
-S, -Zustand
Erzählt Lehnrotat Verwenden einer alternativen Statusdatei. Dies ist nützlich, wenn Logrotate als anderer Benutzer für verschiedene Sätze von Protokolldateien ausgeführt wird. Die Standard -Statusdatei ist /var/lib/logrotate/Status.
-Verwendung
Druckt eine kurze Nutzungsnachricht aus.
-v, -ausführlich
Meldungen während der Rotation anzeigen.

Konfigurationsdatei

Lehnrotat liest alles über die Protokolldateien, die aus der in der Befehlszeile angegebenen Reihe der Konfigurationsdateien behandelt werden sollten. Jede Konfigurationsdatei kann globale Optionen festlegen (lokale Definitionen überschreiben globale und spätere Definitionen über frühere) und geben LogFiles zum Drehen an. Eine einfache Konfigurationsdatei sieht Folgendes aus:

 # Beispiel Logrotate -Konfigurationsdatei Kompress/var/log/messages wöchentlich poTrotate/usr/bin/killall -hup syslogd enden "/var/log/httpd/access.log "/var/log/httpd/fehler.log rotate 5 mail [email protected] -Größe 100K SharedScripts poTrotate/usr/bin/killall -hup httpd/var/log/new.PID 'Endskript nocompress ~/log/*.Protokoll

Die ersten Zeilen setzen globale Optionen. Im Beispiel werden die Protokolle nach dem Drehen komprimiert. Beachten Sie, dass Kommentare überall in der Konfigurationsdatei angezeigt werden können, solange das erste Nicht-Whitespace-Zeichen in der Zeile a ist #.

Im nächsten Abschnitt der Konfigurationsdatei wird festgelegt, wie die Protokolldatei behandelt wird /var/log/messages. Das Protokoll durchläuft fünf wöchentliche Rotationen, bevor er entfernt wird. Nachdem die Protokolldatei gedreht wurde (aber bevor die alte Version des Protokolls komprimiert wurde), ist der Befehl /sbin/Killall -hup syslogd wird durchgeführt.

Der nächste Abschnitt definiert die Parameter für beide /var/log/httpd/access.Protokoll Und /var/log/httpd/fehler.Protokoll. Jedes wird gedreht, wenn es über 100.000 Größe wächst, und die alten Protokolldateien werden an www@my gesendet (unkomprimiert).org nach 5 Rotationen durchlaufen, anstatt entfernt zu werden. Der Sharedscripts bedeutet, dass die postrotat Das Skript wird erst einmal ausgeführt (nachdem die alten Protokolle komprimiert wurden), nicht einmal für jedes gedrehte Protokoll. Beachten Sie, dass Protokoll -Dateinamen in Anführungszeichen beigefügt werden können (und dass Zitate erforderlich sind, wenn der Name Leerzeichen enthält). Normale Shell -Anführungsregeln gelten, mit '', “, Und \ Charaktere unterstützt.

Der letzte Abschnitt definiert die Parameter für alle Dateien in /var/log/News. Jede Datei wird monatlich gedreht. Dies wird als einzelne Rotationsrichtlinie angesehen. Wenn für mehr als eine Datei Fehler auftreten, werden die Protokolldateien nicht komprimiert.

Bitte verwenden Sie Wildcards mit Vorsicht. Wenn Sie angeben *, Lehnrotat dreht alle Dateien, einschließlich zuvor gedrehter. Ein Weg um diese ist, die zu verwenden Olddir Richtlinie oder eine genauere Wildcard (z. B. *.Protokoll).

Wenn das Verzeichnis /var/log/News existiert nicht, dies wird verursachen Lehnrotat einen Fehler melden. Dieser Fehler kann nicht mit dem gestoppt werden vermisstok Richtlinie.

Hier finden Sie weitere Informationen zu den Richtlinien, die in a enthalten sein können Lehnrotat Konfigurationsdatei:

Kompresse
Alte Versionen von Protokolldateien werden mit komprimiert gzip(1) standardmäßig. Siehe auch Nocompress.
compresscmd
Gibt an, welchen Befehl Sie verwenden sollen, um Protokolldateien zu komprimieren. Der Standard ist gzip(1) . Siehe auch Kompresse.
unkompliziert
Gibt an, welchen Befehl Sie verwenden sollen, um Protokolldateien zu unkontrollieren. Der Standard ist Gunzip(1) .
Komprimierterxt
Gibt an, welche Erweiterung für komprimierte Protokolldateien verwendet werden soll, wenn die Komprimierung aktiviert ist. Die Standardeinstellung folgt dem des Standardbefehls für die Standardkomprimierung (.GZ).
Komprimierungen
Befehlszeilenoptionen können an das Komprimierungsprogramm übergeben werden, wenn man verwendet wird. Die Standardeinstellung für gzip, ist "-9" (maximale Komprimierung).
Kopieren
Erstellen Sie eine Kopie der Protokolldatei, ändern Sie aber das Original überhaupt nicht. Diese Option kann beispielsweise verwendet werden, um einen Schnappschuss aus der aktuellen Protokolldatei zu erstellen oder wenn ein anderes Dienstprogramm die Datei abschneiden oder analysieren muss. Wenn diese Option verwendet wird, die erstellen Die Option hat keinen Einfluss, da die alte Protokolldatei an Ort und Stelle bleibt.
CopyTruncate
Schneiden Sie die ursprüngliche Protokolldatei nach dem Erstellen einer Kopie auf Null Größe ab, anstatt die alte Protokolldatei zu verschieben und optional eine neue zu erstellen. Es kann verwendet werden, wenn ein Programm nicht gesagt werden kann, dass er seine Protokolldatei schließen kann, und somit möglicherweise weiterhin für immer zur vorherigen Protokolldatei geschrieben (angehängt) wird. Beachten Sie, dass zwischen dem Kopieren der Datei und dem Abschneiden ein sehr kleiner Zeitschicht besteht, sodass einige Protokollierungsdaten verloren gehen können. Wenn diese Option verwendet wird, die erstellen Die Option hat keinen Einfluss, da die alte Protokolldatei an Ort und Stelle bleibt.
erstellen Modus Eigentümer Gruppe
Unmittelbar nach der Rotation (vor dem postrotat Skript wird ausgeführt) Die Protokolldatei wird erstellt (mit demselben Namen wie die gerade gedrehte Protokolldatei). Modus Gibt den Modus für die Protokolldatei in Octal an (die gleiche wie Chmod(2)), Eigentümer Gibt den Benutzernamen an, der die Protokolldatei besitzt, und Gruppe Gibt die Gruppe an, zu der die Protokolldatei gehört wird. Eine der Attribute der Protokolldatei kann weggelassen werden. In diesem Fall verwenden diese Attribute für die neue Datei die gleichen Werte wie die ursprüngliche Protokolldatei für die ausgelassenen Attribute. Diese Option kann mit dem deaktiviert werden Nocreate Möglichkeit.
täglich
Protokolldateien werden jeden Tag gedreht.
Datumspiegel
Archiv alte Versionen von Protokolldateien addieren eine tägliche Erweiterung wie yyyymmdd, anstatt einfach eine Nummer hinzuzufügen.
Datumsformat
Geben Sie die Erweiterung für an Datumspiegel Verwenden der Notation ähnlich wie Strftime (3) Funktion. Es sind nur %y %m und %D -Spezifizierer zulässig. Der Standardwert ist -%y%m%d. Beachten Sie, dass auch der charaktertrennende Protokollname aus der Erweiterung Teil der DateFormat -Zeichenfolge ist.
Verzögerungskompremen
Verschieben Sie die Komprimierung der vorherigen Protokolldatei in den nächsten Rotationszyklus. Dies hat nur einen Effekt, wenn es in Kombination mit Kompresse. Es kann verwendet werden, wenn ein Programm nicht gesagt werden kann, das Protokolldatei zu schließen, und somit möglicherweise für einige Zeit weiter in die vorherige Protokolldatei schreiben.
Verlängerung ext
Protokolldateien mit ext Die Verlängerung kann es nach der Rotation aufbewahren. Wenn Komprimierung verwendet wird, ist die Kompressionserweiterung (normalerweise normalerweise .gz) erscheint nach ext. Zum Beispiel haben Sie eine Protokolldatei namens MyLog.Foo und möchte es zu MyLog drehen.1.Foo.GZ anstelle von MyLog.Foo.1.gz.
Ifempoy
Drehen Sie die Protokolldatei auch dann, wenn sie leer ist, und überschreiben Sie die NotifeMpty Möglichkeit (Ifempoy ist der Standard).
enthalten Datei_OR_Directory
Liest die als argument angegebene Datei so, als ob sie inline enthalten wäre, wo die enthalten Richtlinie erscheint. Wenn ein Verzeichnis angegeben ist. Die einzigen Dateien, die ignoriert werden, sind Dateien, die keine regulären Dateien (z tabuext Richtlinie. Der enthalten Die Anweisung wird möglicherweise nicht in einer Protokolldateidefinition angezeigt.
Post Adresse
Wenn ein Protokoll aus der Existenz herausgedreht wird, wird es an eine Versandung an gesendet Adresse. Wenn keine E -Mail von einem bestimmten Protokoll generiert werden sollte, ist die Nomail Richtlinie kann verwendet werden.
Mailfirst
Bei Verwendung der Post Befehl, mailen Sie die gerade gekostete Datei anstelle der Datei "Antell-to-Expire".
Maillast
Bei Verwendung der Post Befehl, mailen Sie die Datei "An-to-Expire" anstelle der gerade gerotteten Datei (dies ist der Standard).
Maxage zählen
Entfernen Sie gedrehte Protokolle älter als Tage. Das Alter wird nur überprüft, wenn die Protokolldatei gedreht werden soll. Die Dateien werden an die konfigurierte Adresse gesendet, wenn Maillast Und Post sind konfiguriert.
minsize Größe
Protokolldateien werden gedreht, wenn sie größer werden als Größe Bytes, aber nicht vor dem zusätzlich angegebenen Zeitintervall (täglich, wöchentlich, monatlich, oder jährlich). Die verwandten Größe Die Option ist ähnlich, außer dass sie sich gegenseitig mit den Zeitintervalloptionen ausschließt und dass Protokolldateien ohne Rücksicht auf die letzte Rotationszeit gedreht werden können. Wenn minsize Es wird verwendet, dass sowohl die Größe als auch der Zeitstempel einer Protokolldatei berücksichtigt werden.
vermisstok
Wenn die Protokolldatei fehlt, gehen Sie mit der nächsten, ohne eine Fehlermeldung zu ergeben. Siehe auch nomissingok.
monatlich
Protokolldateien werden zum ersten Mal gedreht Lehnrotat wird in einem Monat ausgeführt (dies ist normalerweise am ersten Tag des Monats).
Nocompress
Alte Versionen von Protokolldateien sind nicht komprimiert. Siehe auch Kompresse.
keine Kopie
Kopieren Sie die ursprüngliche Protokolldatei nicht und lassen Sie sie an Ort und Stelle. (Dies überschreibt die Kopieren Möglichkeit).
NocopyTruncate
Schneiden Sie die ursprüngliche Protokolldatei nach dem Erstellen einer Kopie nicht ab (dadurch überschreiben Sie die CopyTruncate Möglichkeit).
Nocreate
Neue Protokolldateien werden nicht erstellt (dadurch überschreiben Sie die erstellen Möglichkeit).
nodelaycompress
Verschieben Sie die Komprimierung der vorherigen Protokolldatei nicht in den nächsten Rotationszyklus (dadurch überschreiben Sie die Verzögerungskompremen Möglichkeit).
nodateext
Archivieren Sie alte Versionen von Protokolldateien nicht mit Datumserweiterung (dadurch überschreibt die Datumspiegel Möglichkeit).
Nomail
Senden Sie keine alten Protokolldateien an eine Adresse senden.
nomissingok
Wenn keine Protokolldatei vorliegt, geben Sie einen Fehler aus. Dies ist der Standardwert.
Noolddir
Die Protokolle werden im Verzeichnis gedreht, in dem sie normalerweise wohnen (wodurch die Überlieferung ist Olddir Möglichkeit).
Nosharedscripts
Laufen Vorrecht Und postrotat Skripte für jede gedrehte Protokolldatei (dies ist die Standardeinstellung und überschreibt die Sharedscripts Möglichkeit). Wenn die Skripte mit einem Fehler beenden, werden die verbleibenden Aktionen nicht nur für das betroffene Protokoll ausgeführt.
noshed
Verwende nicht Fetzen Beim Löschen alter Protokolldateien. Siehe auch Fetzen.
NotifeMpty
Drehen Sie das Protokoll nicht, wenn es leer ist (dadurch überschreibt die Ifempoy Möglichkeit).
Olddir Verzeichnis
Protokolle werden in verschoben Verzeichnis zur Rotation. Der Verzeichnis muss sich auf demselben physischen Gerät wie die gedrehte Protokolldatei befinden, und es wird angenommen. Wenn diese Option verwendet wird, werden alle alten Versionen des Protokolls endet in Verzeichnis. Diese Option kann von der überschrieben werden Noolddir Möglichkeit.
postrotat/Endschriften
Die Linien zwischen postrotat Und Endschriften (Beide müssen selbst in Zeilen erscheinen) werden ausgeführt, nachdem die Protokolldatei gedreht wurde. Diese Richtlinien erscheinen möglicherweise nur in einer Protokolldateidefinition. Siehe auch Vorrecht. Sehen Sharedscripts Und Nosharedscripts Für Fehlerbehandlung.
Vorrecht/Endschriften
Die Linien zwischen Vorrecht Und Endschriften (Beide müssen selbst in Zeilen erscheinen) werden ausgeführt, bevor die Protokolldatei gedreht wird, und nur, wenn das Protokoll tatsächlich gedreht wird. Diese Richtlinien erscheinen möglicherweise nur in einer Protokolldateidefinition. Siehe auch postrotat. Sehen Sharedscripts Und Nosharedscripts Für Fehlerbehandlung.
FirstAction/Endschriften
Die Linien zwischen FirstAction Und Endschriften (Beide müssen selbst in Zeilen erscheinen) Ich bin einmal vor dem Drehen aller Protokolldateien ausgerichtet, bevor das vorläufige Skript ausgeführt wird, und nur, wenn mindestens ein Protokoll tatsächlich gedreht wird. Diese Richtlinien erscheinen in einer Protokolldateidefinition Mayonly. Wenn das Skript mit einem Fehler beendet ist, wird keine weitere Verarbeitung durchgeführt. Sehen LastAction sowie.
LastAction/Endschriften
Die Linien zwischen LastAction Und Endschriften (Beide müssen selbst in Zeilen erscheinen) werden ausgeführt, nachdem alle Protokolldateien, die mit dem windelerierten Muster übereinstimmen. Diese Richtlinien erscheinen möglicherweise nur in einer Protokolldateidefinition. Wenn das Skript mit einem Fehler beendet ist, wird nur eine Fehlermeldung angezeigt (da dies die letzte Aktion ist).

Siehe auch FirstAction.

drehen zählen
Protokolldateien werden gedreht zählen Zeiten, bevor sie entfernt oder an die in a angegebene Adresse gesendet werden Post Richtlinie. Wenn zählen IS 0, alte Versionen werden eher entfernt als gedreht.
Größe Größe
Protokolldateien werden gedreht, wenn sie größer werden als Größe Bytes. Wenn Größe wird gefolgt von M, Die Größe, wenn angenommen wird, dass sie in Megabyte sind. Wenn der G Suffix wird verwendet, die Größe ist in Gigabyte. Wenn der k wird verwendet, die Größe ist in Kilobyten. So Größe 100, Größe 100k, Und Größe 100m sind alle gültig.
Sharedscripts
Normalerweise, Vorrecht Und postrotat Skripte werden für jedes gedrehte Protokoll ausgeführt. Dies bedeutet, dass ein einzelnes Skript mehrmals für Protokolldateieinträge ausgeführt werden kann, die mehrere Dateien übereinstimmen (z. B. die /var/log/news/* Beispiel). Wenn SharedScript Es wird angegeben, die Skripte werden nur einmal ausgeführt, unabhängig davon, wie viele Protokolle mit dem Wildcarded -Muster übereinstimmen. Wenn jedoch keine der Protokolle im Muster drehen muss, werden die Skripte überhaupt nicht ausgeführt. Wenn die Skripte mit einem Fehler beenden, werden die verbleibenden Aktionen für Protokolle nicht ausgeführt. Diese Option überschreibt die Nosharedscripts Option und impliziert erstellen Möglichkeit.
Fetzen
Löschen Sie Protokolldateien mithilfe Fetzen -u anstelle von unlink (). Dies sollte sicherstellen, dass die Protokolle nach ihrer geplanten Löschung nicht lesbar sind. Dies ist standardmäßig ausgeschaltet. Siehe auch noshed.
Shredcycles zählen
Fragt GNU Fetzen Überwachungsprotokolldateien zählen Zeiten vor Löschen. Ohne diese Option, FetzenDie Standardeinstellung wird verwendet.
Start zählen
Dies ist die Nummer, die als Basis für die Rotation verwendet werden muss. Wenn Sie beispielsweise 0 angeben, werden die Protokolle mit a erstellt .0 Erweiterung, da sie aus den ursprünglichen Protokolldateien gedreht werden. Wenn Sie 9 angeben, werden Protokolldateien mit a erstellt .9, überspringen 0-8. Dateien werden die mit dem angegebene Häufigkeit gedreht drehen Richtlinie.
tabuext [+] Liste
Die aktuelle Tabu -Erweiterungsliste wird geändert (siehe die enthalten Richtlinie für Informationen zu den Tabuerweiterungen). Wenn A + der Liste der Erweiterungen vorausgeht, wird die aktuelle Tabu -Erweiterungsliste erweitert, ansonsten wird sie ersetzt. Beim Start enthält die Tabu -Erweiterungsliste .rpmorig, .rpmsave,, v, .swp, .rpmnew, ~, .CFSAV, .RHN-CFG-TMP-*, .DPKG-DIST, .dpkg-alt, .DPKG-New, .Behinderte.
wöchentlich
Protokolldateien werden gedreht, wenn der aktuelle Wochentag weniger als der Wochentag der letzten Rotation ist oder wenn mehr als eine Woche seit der letzten Rotation vergangen ist. Dies entspricht normalerweise am ersten Tag der Woche, aber wenn Sie Protokolle rotieren, aber wenn Lehnrotat wird nicht jede Nacht laufen, eine Protokollrotation wird bei der ersten gültigen Gelegenheit stattfinden.
jährlich
Protokolldateien werden gedreht, wenn das aktuelle Jahr nicht mit der letzten Rotation übereinstimmt.

Dateien

/var/lib/logrotate.Status
Standard -Statusdatei.
/etc/lwerte.Conf
Einstellmöglichkeiten.

Siehe auch

gzip(1)

Anmerkungen

Der alle töten(1) Programm in Debian findet sich in der PSMISC Paket.

Autoren

Erik Troan Preston Brown Korrekturen und Veränderungen für Debian Bypaul Martin

Verwandte Linux -Tutorials:

  • So erstellen Sie einen Cron -Job in Kubernetes
  • Eine Einführung in Linux -Automatisierung, Tools und Techniken
  • So führen Sie Befehle regelmäßig mit Anacron unter Linux aus
  • Erweiterte Protokollierung und Prüfung unter Linux
  • Mastering -Bash -Skriptschleifen beherrschen
  • Dinge zu installieren auf Ubuntu 20.04
  • Mint 20: Besser als Ubuntu und Microsoft Windows?
  • So verwalten und Fehlerbehebung Kubernetes -Protokolle
  • Dinge zu tun nach der Installation Ubuntu 20.04 fokale Fossa Linux
  • Bestes Komprimierungswerkzeug unter Linux