Sin categoría

LOGROTATE- (8) Página manual

LOGROTATE- (8) Página manual

Nombre

LOGROTATE: gira, comprime y envía registros del sistema

Sinopsis

logrotato [-dv] [-F|-fuerza] [-s|-estado archivo estatal] archivo de configuración…

Descripción

logrotato está diseñado para facilitar la administración de sistemas que generan grandes cantidades de archivos de registro. Permite la rotación automática, la compresión, la eliminación y el correo de los archivos de registro. Cada archivo de registro se puede manejar diariamente, semanalmente, mensualmente o cuando crezca demasiado grande.

Normalmente, logrotato se ejecuta como un trabajo diario cron. No modificará un registro más de una vez en un día a menos que el criterio para ese registro se base en el tamaño del registro y logrotato se ejecuta más de una vez cada día, o a menos que el -F o -fuerza Se usa la opción.

Se puede dar cualquier número de archivos de configuración en la línea de comando. Los archivos de configuración posteriores pueden anular las opciones dadas en archivos anteriores, por lo que el orden en el que el logrotato Los archivos de configuración se enumeran es importante. Normalmente, se debe utilizar un solo archivo de configuración que incluya cualquier otro archivo de configuración. Consulte a continuación para obtener más información sobre cómo usar el incluir directiva para lograr esto. Si se da un directorio en la línea de comandos, cada archivo en ese directorio se usa como un archivo de configuración.

Si no se dan argumentos de línea de comando, logrotato Imprimirá información de versión e derechos de autor, junto con un breve resumen de uso. Si ocurren errores mientras se rotan registros, logrotato saldrá con un estado distinto de cero.

Opción

-d
Enciende el modo de depuración e implica -V. En modo de depuración, no se realizarán cambios en los registros o en el logrotato archivo estatal.
-F, -fuerza
Contado logrotato para forzar la rotación, incluso si no cree que esto sea necesario. A veces esto es útil después de agregar nuevas entradas a un logrotato Archivo de configuración, o si los archivos de registro antiguos se han eliminado a mano, ya que se crearán los nuevos archivos, y el registro continuará correctamente.
-metro, -correo
Contado logrotato qué comando usar al enviar registros de correo. Este comando debe aceptar dos argumentos: 1) el tema del mensaje, y 2) el destinatario. El comando debe leer un mensaje sobre la entrada estándar y enviarlo por correo al destinatario. El comando de correo predeterminado es /usr/bin/mail -s.
-s, -estado
Contado logrotato Para usar un archivo de estado alternativo. Esto es útil si el logrotate se está ejecutando como un usuario diferente para varios conjuntos de archivos de registro. El archivo de estado predeterminado es /var/lib/logrotate/status.
-uso
Imprime un breve mensaje de uso.
-V, -verboso
Mostrar mensajes durante la rotación.

Archivo de configuración

logrotato Lee todo sobre los archivos de registro que debería manejar desde la serie de archivos de configuración especificados en la línea de comando. Cada archivo de configuración puede establecer opciones globales (las definiciones locales anulan las globales, y las definiciones posteriores anulan las anteriores) y especifiquen los archivos de registro para rotar. Un archivo de configuración simple se ve así:

 # Ejemplo de archivo de configuración de logrotato compress/var/log/mensajes rotar 5 postrotado semanal/usr/bin/killall -hup syslogd endscript "/var/log/httpd/access.log "/var/log/httpd/error.registrar rotar 5 correo [email protected] Size 100k SharedScripts Postrotate/usr/bin/killall -hup httpd extralscript/var/log/news/* rotar mensual 2 olddir/var/log/news/Old faltsok postrotate kill -hup 'cat/var/run/inn/inn/inn.PID 'Endscript nocompress ~/log/*.registro

Las primeras líneas establecen opciones globales; En el ejemplo, los registros se comprimen después de que se giran. Tenga en cuenta que los comentarios pueden aparecer en cualquier parte del archivo de configuración siempre que el primer personaje que no sea Whitespace en la línea sea un #.

La siguiente sección del archivo de configuración define cómo manejar el archivo de registro /var/log/mensajes. El registro pasará por cinco rotaciones semanales antes de ser retirado. Después de que el archivo de registro se ha girado (pero antes de que se haya comprimido la versión anterior del registro), el comando /sbin/killall -hup syslogd será ejecutado.

La siguiente sección define los parámetros para ambos /var/log/httpd/access.registro y /var/log/httpd/error.registro. Cada uno se gira cada vez que crece más de 100k de tamaño, y los archivos de registros antiguos se envían por correo (sin comprimir) a [email protected] después de pasar por 5 rotaciones, en lugar de ser eliminadas. El Compañeros compartidos significa que el postrotar El script solo se ejecutará una vez (después de que los registros antiguos se hayan comprimido), no una vez para cada registro que se gira. Tenga en cuenta que los nombres de los archivos de registro pueden adquirirse en cotizaciones (y que se requieren citas si el nombre contiene espacios). Se aplican reglas normales de cotización de shell, con ', ", y \ personajes apoyados.

La última sección define los parámetros para todos los archivos en /var/log/News. Cada archivo se gira mensualmente. Esto se considera una sola directiva de rotación y si se producen errores para más de un archivo, los archivos de registro no están comprimidos.

Utilice los comodines con precaución. Si especifica *, logrotato girará todos los archivos, incluidos los rotados previamente. Una forma de evitar esto es usar el Olddir directiva o un comodín más exacto (como *.registro).

Si el directorio /var/log/News no existe, esto causará logrotato Para informar un error. Este error no se puede detener con el desaparecido directiva.

Aquí hay más información sobre las directivas que pueden incluirse en un logrotato archivo de configuración:

comprimir
Las versiones antiguas de los archivos de registro están comprimidos con gzip(1) Por defecto. Ver también nocompresión.
compresscmd
Especifica qué comando usar para comprimir archivos de registro. El valor predeterminado es gzip(1) . Ver también comprimir.
sin compresión
Especifica qué comando utilizar en los archivos de registro sin compresión. El valor predeterminado es gunzip(1) .
compresión
Especifica qué extensión usar en archivos de registro comprimidos, si la compresión está habilitada. El valor predeterminado sigue el del comando de compresión predeterminado (.Gz).
compresión
Las opciones de línea de comando se pueden pasar al programa de compresión, si uno está en uso. El valor predeterminado, para gzip, es "-9" (compresión máxima).
Copiar
Hacer una copia del archivo de registro, pero no cambie el original en absoluto. Esta opción se puede usar, por ejemplo, para hacer una instantánea del archivo de registro actual, o cuando alguna otra utilidad necesita truncar o analizar el archivo. Cuando se usa esta opción, el crear La opción no tendrá efecto, ya que el archivo de registro anterior permanece en su lugar.
CopyTruncado
Truncar el archivo de registro original al tamaño cero en su lugar después de crear una copia, en lugar de mover el archivo de registro anterior y crear opcionalmente uno nuevo. Se puede usar cuando no se puede decir que algún programa cierre su archivo de registro y, por lo tanto, podría continuar escribiendo (agregar) al archivo de registro anterior para siempre. Tenga en cuenta que hay una porción de tiempo muy pequeña entre copiar el archivo y truncarlo, por lo que se pueden perder algunos datos de registro. Cuando se usa esta opción, el crear La opción no tendrá efecto, ya que el archivo de registro anterior permanece en su lugar.
crear modo dueño grupo
Inmediatamente después de la rotación (antes del postrotar Se ejecuta el script) el archivo de registro se crea (con el mismo nombre que el archivo de registro acaba de girar). modo Especifica el modo para el archivo de registro en Octal (lo mismo que chmod(2)), dueño Especifica el nombre de usuario que posee el archivo de registro y grupo Especifica el grupo que pertenecerá el archivo de registro. Se puede omitir cualquiera de los atributos del archivo de registro, en cuyo caso esos atributos para el nuevo archivo utilizarán los mismos valores que el archivo de registro original para los atributos omitidos. Esta opción se puede deshabilitar utilizando el nocrar opción.
a diario
Los archivos de registro se giran todos los días.
text
Archive versiones antiguas de archivos de registro agregando una extensión diaria como yyyymmdd en lugar de simplemente agregar un número.
formato de fecha
Especificar la extensión para text usando la notación similar a Strftime (3) función. Solo se permiten %y %my %d especificadores. El valor predeterminado es -%y%m%D. Tenga en cuenta que también el nombre del registro de separación de caracteres de la extensión es parte de la cadena DateFormat.
retrasar compress
Postpone la compresión del archivo de registro anterior al siguiente ciclo de rotación. Esto solo tiene efecto cuando se usa en combinación con comprimir. Se puede usar cuando no se puede decir que algún programa cierre su archivo de registro y, por lo tanto, podría continuar escribiendo en el archivo de registro anterior durante algún tiempo.
extensión extendido
Registro de archivos con extendido La extensión puede mantenerlo después de la rotación. Si se usa compresión, la extensión de compresión (normalmente .GZ) aparece después extendido. Por ejemplo, tienes un archivo de registro llamado mylog.foo y quiero rotarlo a mylog.1.foo.gz en lugar de mylog.foo.1.GZ.
singoso
Gire el archivo de registro incluso si está vacío, anulando el notorgoso opción (singoso es el valor predeterminado).
incluir file_or_directory
Lee el archivo dado como un argumento como si se incluyó en línea donde el incluir Aparece la directiva. Si se proporciona un directorio, la mayoría de los archivos en ese directorio se leen en orden alfabético antes de que continúe el procesamiento del archivo incluido el archivo. Los únicos archivos que se ignoran son archivos que no son archivos regulares (como directorios y tuberías con nombre) y archivos cuyos nombres terminan con una de las extensiones tabú, según lo especificado por el tabú directiva. El incluir La directiva puede no aparecer dentro de una definición de archivo de registro.
correo DIRECCIÓN
Cuando un registro se gira fuera de existencia, se envía por correo a DIRECCIÓN. Si un registro en particular no debe generar el correo, el registro, el nomar se puede usar directiva.
primero
Al usar el correo Comando, envíe el archivo recién rotado, en lugar del archivo de exceder.
maillast
Al usar el correo Comando, envíe el archivo de excepción del archivo, en lugar del archivo recién rotado (este es el valor predeterminado).
maxage contar
Retire los registros girados más antiguos que los días. La edad solo se verifica si el archivo de registro se va a girar. Los archivos se envían por correo a la dirección configurada si maillast y correo están configurados.
mínimo tamaño
Los archivos de registro se giran cuando crecen más que tamaño bytes, pero no antes del intervalo de tiempo especificado (a diario, semanalmente, mensual, o anual). El relacionado tamaño La opción es similar, excepto que es mutuamente excluyente con las opciones de intervalo de tiempo, y hace que los archivos de registro se rompan sin tener en cuenta el último tiempo de rotación. Cuando mínimo se usa, se consideran tanto el tamaño como la marca de tiempo de un archivo de registro.
desaparecido
Si falta el archivo de registro, continúe con el siguiente sin emitir un mensaje de error. Ver también nomisingok.
mensual
Los archivos de registro se giran la primera vez logrotato se ejecuta en un mes (esto normalmente es el primer día del mes).
nocompresión
Las versiones antiguas de los archivos de registro no están comprimidos. Ver también comprimir.
nocopia
No copie el archivo de registro original y lo deje en su lugar. (Esto anula el Copiar opción).
nocopytruncado
No trunce el archivo de registro original en su lugar después de crear una copia (esto anula el CopyTruncado opción).
nocrar
No se crean nuevos archivos de registro (esto anula el crear opción).
nodelaycompress
No posponga la compresión del archivo de registro anterior al siguiente ciclo de rotación (esto anula el retrasar compress opción).
nodoxt
No archive las versiones antiguas de los archivos de registro con la extensión de la fecha (esto anula el text opción).
nomar
No envíe archivos de registro antiguos a ninguna dirección.
nomisingok
Si un archivo de registro no existe, emita un error. Este es el valor predeterminado.
Noolddir
Los registros se giran en el directorio en el que normalmente residen (esto anula el Olddir opción).
nosharedScripts
Correr prerrotar y postrotar Scripts para cada archivo de registro que se gira (este es el valor predeterminado, y anula el Compañeros compartidos opción). Si los scripts salen con error, las acciones restantes no se ejecutarán solo para el registro afectado.
malhred
No utilice desgarrar Al eliminar archivos de registro antiguos. Ver también desgarrar.
notorgoso
No gire el registro si está vacío (esto anula el singoso opción).
Olddir directorio
Los registros se mueven a directorio para la rotación. El directorio debe estar en el mismo dispositivo físico que el archivo de registro que se está girando, y se supone que es relativo al directorio que contiene el archivo de registro a menos que se especifique un nombre de ruta absoluta. Cuando se usa esta opción, todas las versiones antiguas del registro terminan en directorio. Esta opción puede ser anulada por el Noolddir opción.
postrotar/Endscript
Las líneas entre postrotar y Endscript (que deben aparecer en líneas por sí mismas) se ejecutan después de girar el archivo de registro. Estas directivas solo pueden aparecer dentro de una definición de archivo de registro. Ver también prerrotar. Ver Compañeros compartidos y nosharedScripts Para el manejo de errores.
prerrotar/Endscript
Las líneas entre prerrotar y Endscript (que deben aparecer en líneas por sí mismas) se ejecutan antes de girar el archivo de registro y solo si el registro realmente se girará. Estas directivas solo pueden aparecer dentro de una definición de archivo de registro. Ver también postrotar. Ver Compañeros compartidos y nosharedScripts Para el manejo de errores.
primero/Endscript
Las líneas entre primero y Endscript (Los cuales deben aparecer en líneas por sí mismas) se generan una vez antes de que se giren todos los archivos de registro que coincidan con el patrón comodín, antes de que se ejecute el script prerotate y solo si al menos un registro se girará realmente. Estas directivas pueden aparecer dentro de una definición de archivo de registro. Si el script sale con error, no se realiza un procesamiento adicional. Ver última acción también.
última acción/Endscript
Las líneas entre última acción y Endscript (Ambas que deben aparecer en líneas por sí mismas) se ejecutan después de que todos los archivos de registro que coincidan con el patrón comodificado se giren, después de que se ejecuta el script postrotado y solo si se gira al menos un registro. Estas directivas solo pueden aparecer dentro de una definición de archivo de registro. Si el script sale con error, solo se muestra un mensaje de error (ya que esta es la última acción).

Ver también primero.

girar contar
Los archivos de registro se giran contar tiempos antes de ser retirado o enviado por correo a la dirección especificada en un correo directiva. Si contar es 0, las versiones antiguas se eliminan en lugar de rotarse.
tamaño tamaño
Los archivos de registro se giran cuando crecen más que tamaño bytes. Si tamaño es seguido por METRO, el tamaño si se supone que está en megabytes. Si el GRAMO Se usa sufijo, el tamaño está en gigabytes. Si el k se usa, el tamaño está en kilobytes. Entonces tamaño 100, tamaño 100k, y tamaño 100m son todos válidos.
Compañeros compartidos
Normalmente, prerrotar y postrotar Los scripts se ejecutan para cada registro que se gira, lo que significa que un solo script se puede ejecutar varias veces para las entradas de archivo de registro que coinciden con múltiples archivos (como el /var/log/news/* ejemplo). Si reclutamiento compartido se especifica, los scripts solo se ejecutan una vez, sin importar cuántos registros coincidan con el patrón comodín. Sin embargo, si ninguno de los registros en el patrón requiere girar, los scripts no se ejecutarán en absoluto. Si los scripts salen con error, las acciones restantes no se ejecutarán para ningún registro. Esta opción anula el nosharedScripts opción e implica crear opción.
desgarrar
Eliminar archivos de registro usando desgarrar -u en lugar de unlink (). Esto debería garantizar que los registros no sean legibles después de su eliminación programada; Esto está desactivada por defecto. Ver también malhred.
triturarse contar
Pregunta GNU desgarrar a los archivos de registro de sobrewite contar veces antes de la eliminación. Sin esta opción, desgarrarEl valor predeterminado se utilizará.
comenzar contar
Este es el número a usar como base para la rotación. Por ejemplo, si especifica 0, los registros se crearán con un .0 Extensión A medida que se giran desde los archivos de registro originales. Si especifica 9, los archivos de registro se crearán con un .9, saltando 0-8. Los archivos se girarán el número de veces especificado con el girar directiva.
tabú [+] lista
Se cambia la lista actual de extensión de tabú (consulte el incluir Directiva para obtener información sobre las extensiones Taboo). Si A + precede a la lista de extensiones, la lista actual de extensión Taboo se aumenta, de lo contrario se reemplaza. Al inicio, la lista de extensión Taboo contiene .rpmorig, .rpmsave, v, .SWP, .rpmnew, ~, .cfsavado, .RHN-CFG-TMP-*, .DPKG-DIST, .viejo dpkg, .dpkg-nuevo, .desactivado.
semanalmente
Los archivos de registro se giran si el día laborable actual es menor que el día de la semana de la última rotación o si ha pasado más de una semana desde la última rotación. Esto normalmente es lo mismo que los registros rotativos el primer día de la semana, pero si logrotato no se ejecuta todas las noches que ocurrirá una rotación de registro en la primera oportunidad válida.
anual
Los archivos de registro se giran si el año actual no es lo mismo que la última rotación.

Archivos

/var/lib/logrotate.estado
Archivo de estado predeterminado.
/etc/logrotate.confusión
Opciones de configuración.

Ver también

gzip(1)

Notas

El Mátalos a todos(1) El programa en Debian se encuentra en el PSMISC paquete.

Autores

Erik Troan Preston Brown Correcciones y cambios para el bypaul de Debian Martin

Tutoriales de Linux relacionados:

  • Cómo crear un trabajo cron en Kubernetes
  • Una introducción a la automatización, herramientas y técnicas de Linux
  • Cómo ejecutar comandos periódicamente con Anacron en Linux
  • Registro avanzado y auditoría en Linux
  • Mastering Bash Script Loops
  • Cosas para instalar en Ubuntu 20.04
  • Mint 20: Mejor que Ubuntu y Microsoft Windows?
  • Cómo administrar y solucionar problemas de Kubernetes
  • Cosas que hacer después de instalar Ubuntu 20.04 fossa focal Linux
  • La mejor herramienta de compresión en Linux