logRotate (comando de base de datos)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

logRotate

El comando es un comando administrativo que le permite rotar el registro del servidor MongoDB y/o el registro de auditoría para evitar que un solo archivo de registro consuma demasiado espacio en logRotate disco.

Debes emitir el comando contra logRotate el base de datos de administración.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Importante

Este comando no es compatible con los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulta Comandos no compatibles.

Sintaxis

El comando tiene la siguiente sintaxis:

db.adminCommand(
   {
     logRotate: <integer or string>,
     comment: <string>
   }
)

Campos de comandos

El comando toma los siguientes campos:

Campo	Tipo	Descripción
`logRotate`	entero o cadena de texto	El o los troncos a rotar, de acuerdo a lo siguiente: `1` -- Rota tanto los registros del servidor como los de auditoría `"server"` -- Rota solo el registro del servidor `"audit"` -- Rota únicamente el registro de auditoría
`comment`	string	Opcional. Un mensaje registrado por el servidor en el archivo de registro y el archivo de auditoría al momento de la rotación del registro.

También puede rotar los registros enviando una SIGUSR1 señal al mongod proceso.

Por ejemplo, si una instancia de mongod en ejecución tiene un ID de proceso (PID) de 2200, el siguiente comando rota la entrada de registro de esa instancia en Linux:

kill -SIGUSR1 2200

Limitaciones

Su instanciamongoddebe ejecutarse con la opción--logpath [file]para poder usarlogRotate
La auditoría debe estar habilitada para poder rotar el registro de auditoría.

Comportamiento

La systemLog.logRotate configuración o --logRotate la opción especifican logRotate el comportamiento de.

Cuando systemLog.logRotate o se --logRotate establecen rename en, renombra el archivo de registro existente añadiendo la marca de tiempo actual al nombre del archivo. La marca de tiempo añadida tiene el siguientelogRotate formato:

<YYYY>-<mm>-<DD>T<HH>-<MM>-<SS>

Luego, logRotatecrea un nuevo archivo de registro con el mismo nombre que el especificado originalmente por la configuraciónsystemLog.pathenmongodomongos.

Cuando systemLog.logRotate o se --logRotate establecen reopen en, sigue el comportamiento típico de Linux/Unix: simplemente cierra el archivo de registro y luego vuelve a abrir uno con el mismologRotate nombre.reopen Con, mongod espera que otro proceso renombre el archivo antes de la rotación y que la reapertura genere un nuevo archivo.

Ejemplos

El siguiente ejemplo rota tanto el registro del servidor como el registro de auditoría:

db.adminCommand( { logRotate: 1 } )

El siguiente ejemplo rota solo el registro de auditoría y proporciona un mensaje personalizado al archivo de registro en el momento de la rotación:

db.adminCommand( { logRotate: "audit", comment: "Rotating audit log" } )

Volver

listIndexes

reIndex