Non catégorisé

Page manuelle Logrotate- (8)

Page manuelle Logrotate- (8)

Nom

Logrotate - tourne, comprime et envoie des journaux système

Synopsis

logrotate [-dv] [-F|-force] [-s|-État file d'État]] config_file…

Description

logrotate est conçu pour faciliter l'administration de systèmes qui génèrent un grand nombre de fichiers journaux. Il permet une rotation automatique, une compression, une suppression et un envoi de fichiers journaux. Chaque fichier journal peut être géré quotidiennement, hebdomadaire, mensuel ou quand il se développe trop grand.

Normalement, logrotate est géré comme un travail quotidien cron. Il ne modifiera pas un journal plus d'une fois en une journée à moins que le critère de ce journal soit basé sur la taille du journal et logrotate est exécuté plus d'une fois par jour, ou à moins que le -F ou -force L'option est utilisée.

Un nombre de fichiers de configuration peut être donné sur la ligne de commande. Les fichiers de configuration ultérieurs peuvent remplacer les options données dans les fichiers antérieurs, donc l'ordre dans lequel le logrotate Les fichiers de configuration sont répertoriés est important. Normalement, un seul fichier de configuration qui comprend tout autre fichier de configuration nécessaire doit être utilisé. Voir ci-dessous pour plus d'informations sur la façon d'utiliser le inclure Directive pour accomplir cela. Si un répertoire est donné sur la ligne de commande, chaque fichier de ce répertoire est utilisé comme fichier de configuration.

Si aucun argument de ligne de commande n'est donné, logrotate Imprimera la version et les informations sur le droit d'auteur, ainsi qu'un court résumé d'utilisation. Si des erreurs se produisent pendant les journaux tournants, logrotate sortira avec un statut non nul.

Options

-d
Allume le mode de débogage et implique -V. En mode débogage, aucune modification ne sera apportée aux journaux ou aux logrotate dossier d'état.
-F, -force
Raconte logrotate pour forcer la rotation, même si cela ne pense pas que cela est nécessaire. Parfois, cela est utile après avoir ajouté de nouvelles entrées à un logrotate Fichier de configuration, ou si les anciens fichiers journaux ont été supprimés à la main, car les nouveaux fichiers seront créés, et la journalisation se poursuivra correctement.
-m, -poster
Raconte logrotate quelle commande à utiliser lors des journaux d'envoi. Cette commande doit accepter deux arguments: 1) le sujet du message, et 2) le destinataire. La commande doit ensuite lire un message sur les entrées standard et l'envoyer par la poste au destinataire. La commande de courrier par défaut est / usr / bin / Mail -s.
-s, -État
Raconte logrotate Pour utiliser un autre fichier d'état. Ceci est utile si Logrotate est exécuté en tant qu'utilisateur différent pour divers ensembles de fichiers journaux. Le fichier d'état par défaut est / var / lib / loggrotate / statut.
-usage
Imprime un message d'utilisation courte.
-V, -verbeux
Afficher les messages pendant la rotation.

Fichier de configuration

logrotate lit tout sur les fichiers journaux qu'il devrait gérer à partir de la série de fichiers de configuration spécifiés sur la ligne de commande. Chaque fichier de configuration peut définir des options globales (les définitions locales remplacent celles globales, et des définitions ultérieures remplacent les antérieures) et spécifier les fichiers de journaux pour tourner. Un fichier de configuration simple ressemble à ceci:

 # Exemple de la compresse de fichiers de configuration Logrotate / var / log / messages Rotate 5 hebdomadaire posttrotate / usr / bin / killall -hup syslogd endcript "/ var / log / httpd / accès syslogd.log "/ var / log / httpd / error.Journal Rotation 5 Mail www @ mon.Taille org 100K partageScripts postrotate / usr / bin / killall -hup httpd endcript / var / log / news / * mensuel rotate 2 olddir / var / log / new.pid 'Endscript nocompress ~ / log / *.enregistrer

Les premières lignes définissent les options globales; Dans l'exemple, les journaux sont compressés après leur tournage. Notez que les commentaires peuvent apparaître n'importe où dans le fichier de configuration tant que le premier caractère non-blanc sur la ligne est un #.

La section suivante du fichier de configuration définit comment gérer le fichier journal / var / log / messages. Le journal passera par cinq rotations hebdomadaires avant d'être supprimée. Une fois le fichier journal tourné (mais avant que l'ancienne version du journal n'ait été compressée), la commande / sbin / killall -hup syslogd sera exécuté.

La section suivante définit les paramètres pour les deux / var / log / httpd / access.enregistrer et / var / log / httpd / error.enregistrer. Chacun est tourné chaque fois qu'il augmente de plus de 100 000, et les anciens fichiers de journaux sont envoyés (non compressés) sur www @ mon.org après avoir traversé 5 rotations, plutôt que d'être supprimé. Le Scripts partagés signifie que le postal Le script ne sera exécuté qu'une seule fois (après la compression des anciens journaux), pas une seule fois pour chaque journal qui est tourné. Notez que les noms de fichiers journaux peuvent être joints en citations (et que des citations sont requises si le nom contient des espaces). Les règles de citation de shell normal s'appliquent, avec ', ", et \ personnages pris en charge.

La dernière section définit les paramètres de tous les fichiers dans / var / log / News. Chaque fichier est tourné sur une base mensuelle. Ceci est considéré comme une directive de rotation unique et si des erreurs se produisent pour plus d'un fichier, les fichiers journaux ne sont pas compressés.

Veuillez utiliser les jilèges avec prudence. Si vous spécifiez *, logrotate fera pivoter tous les fichiers, y compris les précédemment tournés. Un moyen de contourner cela est d'utiliser le olddir directive ou un joker plus exact (comme *.enregistrer).

Si le répertoire / var / log / News n'existe pas, cela provoquera logrotate Pour signaler une erreur. Cette erreur ne peut pas être arrêtée avec le Missingok directif.

Voici plus d'informations sur les directives qui peuvent être incluses dans un logrotate fichier de configuration:

compresse
Les anciennes versions des fichiers journaux sont compressées avec gzip(1) par défaut. Voir également nocompress.
compresscmd
Spécifie la commande à utiliser pour compresser les fichiers journaux. La valeur par défaut est gzip(1) . Voir également compresse.
non compressé
Spécifie la commande à utiliser pour débarrasser les fichiers journaux. La valeur par défaut est Gunzip(1) .
compresser
Spécifie quelle extension utiliser sur les fichiers de journaux compressés, si la compression est activée. La valeur par défaut suit celle de la commande de compression par défaut (.gz).
compressoptions
Les options de ligne de commande peuvent être transmises au programme de compression, si l'on est utilisé. La valeur par défaut, pour gzip, est «-9» (compression maximale).
copie
Faites une copie du fichier journal, mais ne modifiez pas du tout l'original. Cette option peut être utilisée, par exemple, pour faire un instantané du fichier journal actuel, ou lorsqu'une autre utilitaire doit tronquer ou analyser le fichier. Lorsque cette option est utilisée, le créer L'option n'aura aucun effet, car l'ancien fichier journal reste en place.
copytruncate
Tronquer le fichier journal d'origine à la taille zéro en place après avoir créé une copie, au lieu de déplacer l'ancien fichier journal et de créer éventuellement un nouveau. Il peut être utilisé lorsqu'un programme ne peut pas être informé de fermer son fichier de journaux et peut donc continuer à écrire (appliquer) au fichier journal précédent pour toujours. Notez qu'il y a une très petite tranche de temps entre la copie du fichier et les tronquer, de sorte que certaines données d'exploitation peuvent être perdues. Lorsque cette option est utilisée, le créer L'option n'aura aucun effet, car l'ancien fichier journal reste en place.
créer mode propriétaire groupe
Immédiatement après la rotation (avant le postal Le script est exécuté) Le fichier journal est créé (avec le même nom que le fichier journal qui vient de tourner). mode Spécifie le mode du fichier journal en octal (le même que chod(2)), propriétaire Spécifie le nom d'utilisateur qui sera propriétaire du fichier journal, et groupe Spécifie le groupe auquel le fichier journal appartiendra. L'une des attributs du fichier journal peut être omise, auquel cas ces attributs pour le nouveau fichier utiliseront les mêmes valeurs que le fichier journal d'origine pour les attributs omis. Cette option peut être désactivée à l'aide du nocereate option.
quotidien
Les fichiers journaux sont tournés tous les jours.
datexe
Archives anciennes versions de fichiers journaux ajoutant une extension quotidienne comme yyyymmdd au lieu d'ajouter simplement un numéro.
format de date
Spécifiez l'extension de datexe en utilisant la notation similaire à stftime (3) fonction. Seuls% y% m et% d spécificateurs sont autorisés. La valeur par défaut est -% y% m% d. Notez que le nom de journal de séparation des caractères de l'extension fait partie de la chaîne DateFormat.
DelayCompress
Postez la compression du fichier journal précédent au cycle de rotation suivant. Cela n'a un effet que lorsqu'il est utilisé en combinaison avec compresse. Il peut être utilisé lorsqu'un programme ne peut pas être informé de fermer son fichier de journaux et peut donc continuer à écrire dans le fichier journal précédent pendant un certain temps.
extension ext
Les fichiers journaliers avec ext L'extension peut le maintenir après la rotation. Si la compression est utilisée, l'extension de compression (normalement .gz) apparaît après ext. Par exemple, vous avez un fichier de journal nommé mylog.foo et je veux le faire pivoter sur mylog.1.foo.gz au lieu de mylog.foo.1.gz.
idiote
Faites pivoter le fichier journal même s'il est vide, en remplaçant le notifier option (idiote est la valeur par défaut).
inclure file_or_directory
Lit le fichier donné comme un argument comme s'il était inclus en ligne où le inclure La directive apparaît. Si un répertoire est donné, la plupart des fichiers de ce répertoire sont lus dans l'ordre alphabétique avant que le traitement du fichier incluse continue. Les seuls fichiers ignorés sont des fichiers qui ne sont pas des fichiers réguliers (tels que des répertoires et des tuyaux nommés) et des fichiers dont les noms se terminent par l'une des extensions taboues, comme spécifié par le tabotoext directif. Le inclure La directive peut ne pas apparaître dans une définition du fichier journal.
poster adresse
Lorsqu'un journal est tourné hors de l'existence, il est envoyé par la poste à adresse. Si aucun courrier ne doit être généré par un journal particulier, le nomail La directive peut être utilisée.
MailFirst
Lorsque vous utilisez le poster commande, envoyez le fichier juste rotatif, au lieu du fichier de surface.
jaillast
Lorsque vous utilisez le poster Commande, envoyez le fichier à parcourir, au lieu du fichier juste rotatif (c'est la valeur par défaut).
maxage compter
Retirez les journaux tournés plus de plus que les jours. L'âge n'est vérifié que si le fichier de journaux doit être tourné. Les fichiers sont envoyés à l'adresse configurée si jaillast et poster sont configurés.
mini-taille taille
Les fichiers journaux sont tournés lorsqu'ils grandissent taille octets, mais pas avant l'intervalle de temps spécifié en plus (quotidien, hebdomadaire, mensuel, ou annuel). Le lié taille L'option est similaire, sauf qu'elle s'exclut mutuellement avec les options d'intervalle de temps, et qu'elle fait tourner les fichiers journaux sans égard pour la dernière heure de rotation. Quand mini-taille est utilisé, la taille et l'horodatage d'un fichier journal sont considérés.
Missingok
Si le fichier journal est manquant, passez à la suivante sans publier de message d'erreur. Voir également Nomissingok.
mensuel
Les fichiers journaux sont tournés la première fois logrotate est géré dans un mois (c'est normalement le premier jour du mois).
nocompress
Les anciennes versions des fichiers journaux ne sont pas compressées. Voir également compresse.
nocopie
Ne copiez pas le fichier journal d'origine et laissez-le en place. (Cela remplace le copie option).
nocopytronce
Ne tronquez pas le fichier journal d'origine en place après avoir créé une copie (cela remplace le copytruncate option).
nocereate
Les nouveaux fichiers journaux ne sont pas créés (cela remplace le créer option).
nodelaycompress
Ne pas reporter la compression du fichier journal précédent au cycle de rotation suivant (cela remplace le DelayCompress option).
nodiner
N'archive pas d'anciennes versions de fichiers journaux avec une extension de date (cela remplace le datexe option).
nomail
Ne postez pas de vieux fichiers journaux à aucune adresse.
Nomissingok
Si un fichier journal n'existe pas, émettez une erreur. C'est la valeur par défaut.
noolddir
Les journaux sont tournés dans le répertoire dans lequel ils résident normalement (cela remplace le olddir option).
NoshareScripts
Courir prérotre et postal scripts pour chaque fichier journal qui est tourné (c'est la valeur par défaut, et remplace le Scripts partagés option). Si les scripts sortent avec erreur, les actions restantes ne seront pas exécutées pour le journal affecté uniquement.
omniprésent
Ne pas utiliser déchiqueter Lors de la suppression d'anciens fichiers journaux. Voir également déchiqueter.
notifier
Ne pas faire pivoter le journal s'il est vide (cela remplace le idiote option).
olddir annuaire
Les journaux sont déplacés dans annuaire pour rotation. Le annuaire Doit être sur le même périphérique physique que le fichier journal tourné et est supposé être relatif au répertoire détenant le fichier journal à moins qu'un nom de chemin absolu n'est spécifié. Lorsque cette option est utilisée, toutes les anciennes versions du journal finissent annuaire. Cette option peut être remplacée par le noolddir option.
postal/ /script
Les lignes entre postal et script (les deux doivent apparaître sur les lignes par eux-mêmes) sont exécutés après la tournure du fichier journal. Ces directives ne peuvent apparaître que dans une définition du fichier journal. Voir également prérotre. Voir Scripts partagés et NoshareScripts pour la gestion des erreurs.
prérotre/ /script
Les lignes entre prérotre et script (qui doivent apparaître sur les lignes par eux-mêmes) sont exécutés avant que le fichier de journal ne soit tourné et uniquement si le journal sera réellement tourné. Ces directives ne peuvent apparaître que dans une définition du fichier journal. Voir également postal. Voir Scripts partagés et NoshareScripts pour la gestion des erreurs.
fidèle/ /script
Les lignes entre fidèle et script (qui doivent apparaître sur les lignes par eux-mêmes) sont exécutés une fois avant que tous les fichiers de journal qui correspondent au motif en caractéristique de nature ne soient tournés, avant que le script prétate ne soit exécuté et que si au moins un journal sera réellement tourné. Ces directives apparaissent à l'intérieur d'une définition du fichier journal. Si le script sort avec erreur, aucun traitement supplémentaire n'est effectué. Voir dernier aussi.
dernier/ /script
Les lignes entre dernier et script (qui doivent apparaître sur les lignes par eux-mêmes) sont exécutés après tous les fichiers journaux qui correspondent au motif en caracté. Ces directives ne peuvent apparaître que dans une définition du fichier journal. Si le script sort avec erreur, un message d'erreur est affiché (car c'est la dernière action).

Voir également fidèle.

tourner compter
Les fichiers journaux sont tournés compter fois avant d'être retiré ou envoyé par la poste à l'adresse spécifiée dans un poster directif. Si compter est 0, les anciennes versions sont supprimées plutôt que tournées.
taille taille
Les fichiers journaux sont tournés lorsqu'ils grandissent taille octets. Si taille est suivi par M, la taille si supposée être dans les mégaoctets. Si la g le suffixe est utilisé, la taille est en gigaoctets. Si la k est utilisé, la taille est en kilobytes. Donc taille 100, taille 100k, et taille 100m sont tous valides.
Scripts partagés
Normalement, prérotre et postal Les scripts sont exécutés pour chaque journal qui est tourné, ce qui signifie qu'un seul script peut être exécuté plusieurs fois pour les entrées de fichiers journaux qui correspondent à plusieurs fichiers (comme le / var / log / news / * exemple). Si partager est spécifié, les scripts ne sont exécutés qu'une seule fois, peu importe le nombre de journaux correspondent au motif de papier générique. Cependant, si aucun des journaux dans le motif ne nécessite de rotation, les scripts ne seront pas du tout exécutés. Si les scripts sortent avec une erreur, les actions restantes ne seront pas exécutées pour les journaux. Cette option remplace le NoshareScripts option et implique créer option.
déchiqueter
Supprimer les fichiers journaux à l'aide déchiqueter -u au lieu de Unlink (). Cela devrait garantir que les journaux ne sont pas lisibles après leur suppression prévue; Ceci est désactivé par défaut. Voir également omniprésent.
râpe compter
Demande GNU déchiqueter Pour Overwite Fichiers journaux compter fois avant la suppression. Sans cette option, déchiqueterLa valeur par défaut sera utilisée.
commencer compter
C'est le nombre à utiliser comme base pour la rotation. Par exemple, si vous spécifiez 0, les journaux seront créés avec un .0 Extension car ils sont tournés à partir des fichiers journaux d'origine. Si vous spécifiez 9, les fichiers journaux seront créés avec un .9, sauter 0-8. Les fichiers seront tournés vers le nombre de fois spécifié avec le tourner directif.
tabotoext [+] liste
La liste des extensions taboues actuelle est modifiée (voir le inclure Directive pour obtenir des informations sur les extensions taboues). Si A + précède la liste des extensions, la liste des extensions taboues actuelle est augmentée, sinon elle est remplacée. Au démarrage, la liste des extensions taboues contient .rpmorig, .RPMSAVE ,, V, .SWP, .rpmnew, ~, .CFSAVED, .RHN-CFG-TMP- *, .DPKG-Dist, .dpkg-vieux, .dpkg-new, .désactivé.
hebdomadaire
Les fichiers journaux sont tournés si le jour de semaine en cours est inférieur à la journée de la dernière rotation ou si plus d'une semaine s'est écoulée depuis la dernière rotation. C'est normalement le même que les journaux rotatifs le premier jour de la semaine, mais si logrotate n'est pas exécuté tous les soirs, une rotation de journaux se produira à la première opportunité valide.
annuel
Les fichiers journaux sont tournés si l'année en cours n'est pas la même que la dernière rotation.

Des dossiers

/ var / lib / loggrotate.statut
Fichier d'état par défaut.
/ etc / Logrotate.confli
Options de configuration.

Voir également

gzip(1)

Remarques

Le tuer tous(1) le programme de Debian se trouve dans le PSMISC emballer.

Auteurs

Erik Troan Preston Brown Corrections and Changes for Debian Bypaul Martin

Tutoriels Linux connexes:

  • Comment créer un travail cron à Kubernetes
  • Une introduction à l'automatisation Linux, des outils et des techniques
  • Comment exécuter les commandes périodiquement avec Anacron sur Linux
  • Journalisation et audit avancés sur Linux
  • Masterring Bash Script Loops
  • Choses à installer sur Ubuntu 20.04
  • Mint 20: Mieux que Ubuntu et Microsoft Windows?
  • Comment gérer et dépanner les journaux Kubernetes
  • Choses à faire après l'installation d'Ubuntu 20.04 Focal Fossa Linux
  • Meilleur outil de compression sur Linux