¡Hola!

¿Necesitas ayuda? ¡Estamos aquí!

Icono de soporte
Soporte por correo electrónico de miniOrange
comercial

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:

×

Configurar la rotación de registros en miniOrange IAM En la premisa


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:

  • IAM Servidor (Tomcat / log4j2) — controla el principal catalina-moas.out Registro. Variables: LOG_FILE_SIZE, LOG_RETENTION_DAYS, LOG_RETENTION_SIZE.
  • Servicios (aplicaciones, proveedor de identidad, directorio y otros) — cada servicio escribe su propio registro rotativo. Variables: 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.


1. Dónde configurar las variables de entorno

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
  • Este archivo es obtenido por el proceso de servicio miniOrange al iniciarse. Las variables configuradas en cualquier otro lugar (como en una sesión de shell o en Tomcat) setenv.sh) no se detectará de forma fiable en todos los componentes.
  • Como editar

    • Abra el archivo con un editor de texto (se requiere sudo):
    • sudo nano /etc/mo-idp-server.env
    • Agregue o actualice las líneas de variables relevantes que se muestran en el IAM A continuación se muestran las secciones de Servidores y Servicios.
    • Guarda el archivo y luego reinicia el miniOrange. IAM servicio para que los cambios entren en vigor.

2. IAM Rotación de registros del servidor

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.


  • Archivo de registro activo (siempre se reciben nuevas entradas):
  • $CATALINA_HOME/logs/catalina-moas.out
  • Patrón de archivo de registro archivado (rolled):
  • $CATALINA_HOME/logs/catalina-moas.<MM-dd-yyyy>.<index>.log
  • Ejemplo: catalina-moas.06-06-2026.1.log (Primera rotación el 6 de junio de 2026)

    2.1 Variables de entorno

    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.

    2.2 Cuándo se activa la rotación

    La rotación se activa cuando se cumple cualquiera de estas condiciones, la que ocurra primero:

    • Condición de tiempo: La fecha del calendario cambia (diariamente a medianoche).
    • Condición de tamaño: catalina-moas.out alcanza el tamaño establecido por LOG_FILE_SIZE.
    • Lógica OR:

    • Ambas condiciones se comprueban de forma independiente. Si se alcanza el límite de tamaño en cualquier momento del día, se activa una rotación inmediata sin esperar a medianoche. A medianoche, se activa una rotación incluso si el archivo es pequeño.
    • Un archivo enrollado también se elimina si YA SEA La condición de retención es verdadera (edad O tamaño total), no ambas.

    2.3 Limitación conocida: máximo 7 archivos enrollados por día (IAM Servidor)

    • El IAM La configuración del servidor log4j2 admite un máximo de 7 archivos enrollados por día calendario. Si 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.
    • Esta es una limitación de la DefaultRolloverStrategy utilizado en el paquete log4j2.xml y no es configurable sin modificar el XML.
    • Para evitar alcanzar este límite: asegúrese 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.

    2.4 Configuración en /etc/mo-idp-server.env

    • Agregue o actualice estas líneas en /etc/mo-idp-server.env:
    • # IAM Server (Tomcat) log rotation
              LOG_FILE_SIZE=20MB
              LOG_RETENTION_DAYS=7d
              LOG_RETENTION_SIZE=2GB
    • Reinicia el miniOrange IAM servicio después del ahorro.

3. Rotación de registros de servicios (aplicaciones, IDP, directorio, etc.)

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.

  • La rotación de registros está disponible para todas las versiones de miniOrange. IAM Servicios en las instalaciones del cliente.
  • Archivo de registro activo por servicio:
  • $MO_LOGS_PATH/<service-name>/<service-name>.out
  • Patrón de archivo de registro rotativo por servicio:
  • $MO_LOGS_PATH/<service-name>/<service-name>.<MM-dd-yyyy>-<index>.log

    3.1 Variables de entorno

    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.

    3.2 Importante: MO_LOGS_PATH debe estar configurado.

      El registro de archivos está deshabilitado sin MO_LOGS_PATH.

    • If 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.
    • Establecer MO_LOGS_PATH a una ruta absoluta en una partición con suficiente espacio libre.

    3.3 Efecto del nivel de registro en el uso del disco

    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.

    3.4 Configuración en /etc/mo-idp-server.env

    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
    • Diferencia de formato para MO_MAX_FILE_SIZE: Para los servicios, el valor del tamaño debe incluir un espacio entre el número y la unidad: '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.
    • Para el IAM servidor (LOG_FILE_SIZE), no se necesita espacio: '20MB'.

4. Verificación de que la rotación de registros funciona correctamente.

    4.1 IAM Server

    • Confirme que el archivo de registro activo existe y está recibiendo entradas:
    • ls -lh $CATALINA_HOME/logs/catalina-moas.out
      tail -20 $CATALINA_HOME/logs/catalina-moas.out
    • Compruebe si hay archivos rotados (se espera una lista vacía en una instalación nueva antes de la primera rotación):
    • ls -lh $CATALINA_HOME/logs/catalina-moas.*.log
    • Confirme que las variables estén configuradas correctamente:
    • grep -E 'LOG_FILE_SIZE|LOG_RETENTION' /etc/mo-idp-server.env
    • Compruebe el uso total del disco del directorio de registros:
    • 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.

    Servicios 4.2

    • Confirmar MO_LOGS_PATH Está establecido:
    • grep MO_LOGS_PATH /etc/mo-idp-server.env
    • Enumerar el directorio de registros para un servicio específico (reemplazar con el nombre real del servicio):
    • ls -lh $MO_LOGS_PATH/<service-name>/
    • Confirme que el registro activo existe y que los archivos rotados aparecen después de la primera rotación:
    • ls -lh $MO_LOGS_PATH/<service-name>/<service-name>.out
      ls -lh $MO_LOGS_PATH/<service-name>/<service-name>.*.log

5. Solución de problemas

    5.1 Errores comunes y soluciones

    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.

    5.2 Emergencia: Disco lleno en este momento

      Precaución: no elimine el archivo de registro activo.

    • Do eliminar catalina-moas.out Mientras Tomcat está en ejecución, log4j2 mantiene un identificador de archivo abierto.
    • Al eliminar el archivo activo, el registro de eventos se detiene silenciosamente hasta que se reinicia el servicio.
    • Solo elimina los dados .log archivos — archivos que incluyen una fecha en su nombre.

    • Ejecute estos comandos para identificar y liberar espacio de forma segura:
    • 
          # 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/
    • Después de liberar espacio, revise y actualice. /etc/mo-idp-server.env Con los valores de tamaño y retención adecuados, reinicie el miniOrange. IAM .

6. Guía de referencia rápida

    6.1 Todas las variables de entorno

    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

    6.2 Ubicaciones de los archivos de registro

    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

    6.3 Archivo de entorno

    /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.




¿Quiere programar una demostración?

Solicitar una demo
  




Nuestros otros productos de gestión de identidad y acceso