¿Necesitas ayuda? ¡Estamos aquí!
Gracias por su encuesta. Nuestro equipo pronto se comunicará con usted.
Si no recibe noticias nuestras dentro de las 24 horas, no dude en enviar un correo electrónico de seguimiento a info@xecurify.com
Resultados de la búsqueda:
×Sin rotación de registros, miniOrange IAM Los archivos de registro crecen continuamente y pueden llenar el disco, lo que provoca interrupciones en el servicio. Esta guía explica cómo se configura la rotación de registros para ambos. IAM Servicios del servidor y de miniOrange: dónde deben configurarse las variables de entorno y cómo verificar y solucionar problemas de configuración.
mininaranja IAM La instalación local cuenta con dos sistemas de registro distintos:
catalina-moas.out Registro. Variables: LOG_FILE_SIZE, LOG_RETENTION_DAYS, LOG_RETENTION_SIZE.MO_LOGS_PATH, MO_MAX_FILE_SIZE, MO_LOGS_PERSIST_DAYS, ROOT_LOG_LEVEL, MO_LOGS_LEVEL.Todas las variables para ambos sistemas se configuran en el mismo archivo de entorno. IAM Las secciones de Servidores y Servicios que aparecen a continuación describen cada sistema en detalle.
La rotación de registros es compatible con IAM versión 5.2.1 y más tarde. Para todos los demás servicios, la compatibilidad con la rotación de registros está disponible a partir de IAM versión 4.8.
Todas las variables de entorno relacionadas con el registro se configuran en el siguiente archivo, que se crea automáticamente durante miniOrange. IAM instalación:
/etc/mo-idp-server.env
setenv.sh) no se detectará de forma fiable en todos los componentes.sudo nano /etc/mo-idp-server.env
El IAM El servidor (Tomcat) utiliza log4j2 para la gestión de registros. La configuración se define en log4j2.xml dentro del despliegue.
Nota: Rotación de troncos para el IAM El servidor está disponible en miniOrange. IAM En la premisa v5.2.1 y por encima.
$CATALINA_HOME/logs/catalina-moas.out
$CATALINA_HOME/logs/catalina-moas.<MM-dd-yyyy>.<index>.log
catalina-moas.06-06-2026.1.log (Primera rotación el 6 de junio de 2026)| Variable | Predeterminado | Formato | Lo que controla |
|---|---|---|---|
LOG_FILE_SIZE |
20MB | p. ej. 10 MB, 50 MB | Tamaño máximo de catalina-moas.out antes de que se active la rotación. Cuando se alcanza este tamaño, el archivo se rota inmediatamente, independientemente de la hora del día. |
LOG_RETENTION_DAYS |
7d | p. ej. 3d, 14d, 30d | Los archivos rotados cuya marca de tiempo de última modificación sea anterior a este valor se eliminan durante la siguiente rotación. Aumente este valor para conservar los registros durante más tiempo; disminúyalo para ahorrar espacio en disco. |
LOG_RETENTION_SIZE |
2GB | p. ej. 500 MB, 5 GB | Si el tamaño combinado de todos los enrollados .log Si el número de archivos supera este valor, los archivos más antiguos se eliminan uno por uno durante la siguiente rotación hasta que el total caiga por debajo del límite. El activo catalina-moas.out Nunca se cuenta ni se elimina. |
La rotación se activa cuando se cumple cualquiera de estas condiciones, la que ocurra primero:
catalina-moas.out alcanza el tamaño establecido por LOG_FILE_SIZE.Lógica OR:
catalina-moas.out rota más de 7 veces en un solo día (porque LOG_FILE_SIZE si se establece un valor muy pequeño en relación con el volumen de registro diario), log4j2 no creará un octavo archivo para ese día.DefaultRolloverStrategy utilizado en el paquete log4j2.xml y no es configurable sin modificar el XML.LOG_FILE_SIZE es lo suficientemente grande como para que la salida de registros diarios no cause más de 7 rotaciones. Por ejemplo, si el servidor produce aproximadamente 700 MB de registros por día, configure LOG_FILE_SIZE a por lo menos 100MB./etc/mo-idp-server.env:# IAM Server (Tomcat) log rotation
LOG_FILE_SIZE=20MB
LOG_RETENTION_DAYS=7d
LOG_RETENTION_SIZE=2GB
Todos los servicios de miniOrange comparten una única configuración de log4j2. Cada servicio escribe su propio registro en un subdirectorio bajo MO_LOGS_PATH.
$MO_LOGS_PATH/<service-name>/<service-name>.out
$MO_LOGS_PATH/<service-name>/<service-name>.<MM-dd-yyyy>-<index>.log
| Variable | Predeterminado | Formato | Lo que controla |
|---|---|---|---|
MO_LOGS_PATH |
(requerido) | Ruta de directorio absoluta | Directorio base bajo el cual cada servicio crea su propio subdirectorio de registro. Si esta variable no está definida o está vacía, el registro en archivos se desactiva para todos los servicios; los registros se envían únicamente a la consola. |
MO_MAX_FILE_SIZE |
100 MB | p. ej. 50 MB, 200 MB (espacio requerido) | Tamaño máximo de cada archivo de registro activo del servicio antes de que se active la rotación. El mismo límite se aplica a todos los servicios. El valor predeterminado es 100 MB; tenga en cuenta que esto es mayor que el IAM Valor predeterminado del servidor: 20 MB. |
MO_LOGS_PERSIST_DAYS |
30 | Número entero (cantidad de archivos) | Número de archivos rotados que se conservarán por servicio. Este límite se basa en la cantidad de archivos, no en el tiempo. Log4j2 conserva esta cantidad de archivos rotados y elimina el más antiguo cuando se crea uno nuevo. El valor predeterminado es de 30 archivos por servicio. |
ROOT_LOG_LEVEL |
WARN | SEGUIMIENTO, DEPURACIÓN, INFORMACIÓN, ADVERTENCIA, ERROR, DESACTIVADO | Nivel de detalle del registro para el registrador raíz (todos los paquetes no configurados de otra manera). Los niveles inferiores generan muchos más datos de registro. Recomendado: WARN para producción. |
MO_LOGS_LEVEL |
INFO | SEGUIMIENTO, DEPURACIÓN, INFORMACIÓN, ADVERTENCIA, ERROR, DESACTIVADO | Nivel de detalle del registro específicamente para el com.miniorange Paquete. Establézcalo en DEBUG al solucionar problemas específicos de miniOrange. Recomendado: INFO para producción. |
El registro de archivos está deshabilitado sin MO_LOGS_PATH.
MO_LOGS_PATH no está configurado en /etc/mo-idp-server.env, EnvironmentArbiter En la configuración del servicio log4j2, se desactiva por completo el appender RollingFile. Toda la salida del registro del servicio se envía únicamente a la consola (stdout); no se escriben archivos de registro ni se produce ninguna rotación.MO_LOGS_PATH a una ruta absoluta en una partición con suficiente espacio libre.Configuración
ROOT_LOG_LEVEL or MO_LOGS_LEVEL usar DEBUG o TRACE produce una cantidad significativamente mayor de salida de registro, lo que hace que los archivos de registro crezcan más rápido y que la rotación se active con mayor frecuencia. En producción, use WARN para ROOT_LOG_LEVEL e INFORMACIÓN para MO_LOGS_LEVEL a menos que esté depurando activamente un problema. Regrese a estos niveles una vez que haya finalizado la depuración.
Agregue o actualice estas líneas en /etc/mo-idp-server.env:
# Service log configuration
MO_MAX_FILE_SIZE=100 MB
MO_LOGS_PERSIST_DAYS=30
ROOT_LOG_LEVEL=WARN
MO_LOGS_LEVEL=INFO
'100 MB' No '100MB'Esto coincide con el formato de la configuración del servicio log4j2. Si no se utilizan espacios, es posible que no se lea correctamente.LOG_FILE_SIZE), no se necesita espacio: '20MB'.ls -lh $CATALINA_HOME/logs/catalina-moas.out
tail -20 $CATALINA_HOME/logs/catalina-moas.out
ls -lh $CATALINA_HOME/logs/catalina-moas.*.log
grep -E 'LOG_FILE_SIZE|LOG_RETENTION' /etc/mo-idp-server.env
du -sh $CATALINA_HOME/logs/
Para activar una rotación de prueba sin esperar a la medianoche o al tráfico intenso: configurar temporalmente LOG_FILE_SIZE=1MB in /etc/mo-idp-server.envReinicie el servicio, realice un intento de inicio de sesión o cualquier llamada a la API y, a continuación, compruebe si se ha generado un nuevo archivo. Restaure el valor original y reinicie de nuevo.
MO_LOGS_PATH Está establecido:grep MO_LOGS_PATH /etc/mo-idp-server.env
ls -lh $MO_LOGS_PATH/<service-name>/
ls -lh $MO_LOGS_PATH/<service-name>/<service-name>.out
ls -lh $MO_LOGS_PATH/<service-name>/<service-name>.*.log
| Síntoma / Error | Causa y solución |
|---|---|
| IAM Los registros del servidor nunca se rotan. | Las variables no se están leyendo. Asegúrese LOG_FILE_SIZE y LOG_RETENTION_DAYS se establecen en /etc/mo-idp-server.env — no en una sesión de shell o Tomcat setenv.shVerifique que el servicio miniOrange se haya reiniciado por completo después de editar el archivo. |
| Los archivos de registro del servicio no se crean en absoluto. | MO_LOGS_PATH no está configurada o está vacía. Sin esta variable, el registro de archivos está deshabilitado para todos los servicios. Configurar MO_LOGS_PATH a una ruta de directorio absoluta válida en /etc/mo-idp-server.env y reiniciar |
| IAM El servidor rota casi inmediatamente después del inicio. | LOG_FILE_SIZE Le falta el sufijo de unidad. Ejemplo: LOG_FILE_SIZE=20 (sin unidad) se interpreta como 20 bytes, lo que provoca una rotación casi continua. Incluya siempre la unidad: LOG_FILE_SIZE=20MB. |
MO_MAX_FILE_SIZE no respetados por los servicios |
La configuración del servicio log4j2 requiere un espacio entre el número y la unidad. Utilice MO_MAX_FILE_SIZE=100 MB (con espacio), no 100MBSin el espacio, es posible que el valor no se analice correctamente. |
| Los archivos antiguos no se están eliminando. | La eliminación solo se ejecuta durante un evento de rotación, no según un cronograma. Si no se ha producido ninguna rotación recientemente (el archivo activo es pequeño y aún no ha pasado la medianoche), los archivos obsoletos permanecen. Inicie una rotación manualmente para forzar una limpieza. |
Archivo de registro activo (catalina-moas.out) desaparece |
No elimine el archivo de registro activo mientras Tomcat esté en ejecución. log4j2 mantiene un identificador de archivo abierto; eliminar el archivo mientras el proceso está en ejecución provoca que el registro se detenga silenciosamente. Reinicie el servicio miniOrange para recrear el archivo. |
| El disco sigue lleno después de configurar los límites de retención. | La limpieza solo se ejecuta en el siguiente ciclo de rotación. Si el disco ya está lleno, no se puede activar la rotación. Elimine manualmente los archivos rotados antiguos mediante los comandos de limpieza de emergencia que se indican a continuación y, a continuación, configure los valores de retención adecuados. |
| IAM El servidor deja de crear archivos rotados a mitad del día. | El máximo es de 7 archivos enrollados por día calendario (ver Limitación conocida más arriba). Si LOG_FILE_SIZE El valor configurado es demasiado pequeño para el volumen de registro diario, por lo que se alcanza este límite. Aumentar LOG_FILE_SIZE de manera que no se produzcan más de 7 rotaciones por día. |
| El cambio de nivel de registro no tiene efecto. | ROOT_LOG_LEVEL y MO_LOGS_LEVEL se leen al iniciar el servicio. Cambios en /etc/mo-idp-server.env Se requiere un reinicio completo del servicio para que surta efecto. Un simple SIGHUP o recarga no es suficiente. |
Precaución: no elimine el archivo de registro activo.
catalina-moas.out Mientras Tomcat está en ejecución, log4j2 mantiene un identificador de archivo abierto..log archivos — archivos que incluyen una fecha en su nombre.
# Total log directory size
du -sh $CATALINA_HOME/logs/
# List IAM rolled files, largest first
ls -lhS $CATALINA_HOME/logs/catalina-moas.*.log
# Delete IAM rolled files older than 3 days
find $CATALINA_HOME/logs/ -name 'catalina-moas.*.log' -mtime +3 -delete
# Delete service rolled files older than 3 days
find $MO_LOGS_PATH/ -name '*.log' -mtime +3 -delete
# Confirm disk space recovered
df -h $CATALINA_HOME/logs/
/etc/mo-idp-server.env Con los valores de tamaño y retención adecuados, reinicie el miniOrange. IAM .| Variable | Predeterminado | Se aplica a | Propósito |
|---|---|---|---|
LOG_FILE_SIZE |
20MB | IAM Server | Gire el registro activo cuando alcance este tamaño. |
LOG_RETENTION_DAYS |
7d | IAM Server | Eliminar archivos rotados con una antigüedad superior a esta. |
LOG_RETENTION_SIZE |
2GB | IAM Server | Elimine los archivos rotados más antiguos si el total combinado supera este |
MO_LOGS_PATH |
(requerido) | Servicios | Directorio base para los registros de servicio (necesario para el registro de archivos) |
MO_MAX_FILE_SIZE |
100 MB | Servicios | Rotar el registro activo por servicio a este tamaño (espacio incluido: 100 MB) |
MO_LOGS_PERSIST_DAYS |
30 | Servicios | Número de archivos rotados que se conservarán por servicio (cantidad, no días) |
ROOT_LOG_LEVEL |
WARN | Servicios | Nivel de detalle del registro para todos los paquetes (registrador raíz) |
MO_LOGS_LEVEL |
INFO | Servicios | Nivel de detalle del registro para com.miniorange solo paquetes |
| Componente | Archivo de registro activo | Patrón de archivo enrollado |
|---|---|---|
| IAM Server | $CATALINA_HOME/logs/catalina-moas.out |
catalina-moas.MM-dd-yyyy.N.log |
| Servicios | $MO_LOGS_PATH/<svc>/<svc>.out |
<svc>.MM-dd-yyyy-N.log |
/etc/mo-idp-server.env
Creado automáticamente durante miniOrange IAM Instalación. Edite este archivo para configurar todas las variables de registro. Reinicie siempre el miniOrange. IAM Servicio después de los cambios.