Índice

wrapper.use_system_time

Compatibilidad :3.1.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

ADVERTENCIA

NO modifique ninguno de estos parámetros a menos que haya leído esta descripción de la propiedad. Una configuración incorrecta puede hacer que el Wrapper no funcione como se espera.

Esta propiedad controla cómo el Wrapper gestiona internamente el paso del tiempo y la programación de eventos. El valor predeterminado es "FALSE".

  • Si es TRUE, el Wrapper utilizará la hora del sistema para todas las funciones internas de medición del tiempo.

  • Establecerlo en FALSE hará que el Wrapper utilice un hilo de temporizador en segundo plano que mide el tiempo incrementando un contador de "ticks".

Ejemplo:
wrapper.use_system_time=FALSE

Cada valor de esta propiedad tiene ventajas en determinadas situaciones.

NOTA

Los cambios en el valor de esta propiedad no tendrán ningún efecto en el Wrapper si se recarga la configuración. El Wrapper debe reiniciarse para que los cambios surtan efecto. Las propiedades de umbral descritas a continuación se pueden actualizar.

wrapper.use_system_time=TRUE (Hora del sistema)

Históricamente, el Wrapper siempre ha utilizado la hora del sistema para la medición interna del tiempo. En la mayoría de los casos, esto funciona perfectamente. Sin embargo, hay algunos casos en los que fallará o el Wrapper no hará lo que se espera:

  • Si el Wrapper se encuentra en una situación en la que compite por la CPU con otros procesos que operan a una prioridad más alta, es posible que el Wrapper y/o su JVM no obtengan ciclos de CPU durante largos períodos de tiempo. El Wrapper siempre ha gestionado estos casos mediante una lógica que detecta dichas situaciones y amplía los tiempos de espera afectados de forma adecuada. Sin embargo, en casos excepcionales, el Wrapper pensará erróneamente que la JVM se ha congelado y la reiniciará.

  • Cambios en la hora del sistema. Si la hora del sistema se adelanta o se retrasa más de unos pocos segundos mientras el Wrapper está en ejecución, uno o más de sus tiempos de espera podrían activarse, lo que provocaría un reinicio no deseado de la JVM. En la mayoría de los casos, el Wrapper gestionará los cambios de hora como si el proceso se hubiera quedado sin CPU. Pero hay casos en los que esto fallará.

    En general, adelantar el reloj del sistema funciona correctamente. Se mostrará un mensaje en la consola notificando al usuario que el Wrapper no recibió CPU durante x segundos. Pero el Wrapper seguirá funcionando correctamente.

    Sin embargo, retrasar la hora del sistema puede causar varios problemas dependiendo del estado exacto en el que se encuentre el Wrapper cuando ocurra. Internamente, el Wrapper programa eventos en puntos futuros específicos en el tiempo en los que deberían realizarse operaciones como el ping o el lanzamiento de una nueva JVM. Si la hora se retrasa una hora, una operación que estaba programada para realizarse después de 5 segundos no ocurrirá hasta una hora y 5 segundos después. Si el momento es el adecuado, el Wrapper podría dejar de enviar pings a la JVM y la JVM responderá a la falta de pings iniciando un reinicio de la JVM.

    NOTA

    Horario de verano

    El Wrapper no funcionará correctamente durante el horario de verano. Si vive en un país que cambia la hora cada primavera y otoño, se recomienda utilizar el temporizador de ticks para evitar tiempos de espera.

    Como se ha descrito anteriormente, es posible que se produzca un único reinicio de la JVM en primavera o en otoño cuando se ajuste la hora del sistema. Sin embargo, una vez que la JVM se haya reiniciado, su aplicación debería seguir funcionando correctamente.

  • Suspensión y reanudación del sistema. Si el Wrapper se utiliza en un sistema que puede suspenderse en disco o en RAM durante largos períodos de tiempo, la hora del sistema parecerá haber saltado hacia adelante cuando se reanude la máquina. Aparte de un mensaje en la consola, esto funciona correctamente.

wrapper.use_system_time=FALSE (Hilo de temporizador)

A partir de la versión 3.1.0 del Wrapper, se añadió un nuevo mecanismo de temporizador al Wrapper. Este nuevo temporizador se convirtió en el predeterminado en la versión 3.2.0 del Wrapper. En lugar de medir el tiempo consultando el reloj del sistema, el Wrapper crea un hilo en segundo plano que entra en un bucle ligero e incrementa un contador interno de "ticks". Internamente, toda la medición del tiempo se ha modificado para basarse en estos "ticks". (Si se utiliza la hora del sistema, el recuento de ticks en cualquier momento concreto se calcula a partir de la hora del sistema en lugar del contador.)

Esto ha resultado tener varias ventajas:

  • El Wrapper ya no se ve afectado por los cambios en la hora del sistema, ni hacia adelante ni hacia atrás. Esto garantiza que el Wrapper se comportará correctamente siempre que se ajuste la hora del sistema por el horario de verano u otros ajustes.

  • Cuando se reanuda un sistema suspendido, el Wrapper continúa desde donde lo dejó sin ningún problema.

  • El Wrapper gestiona de forma fiable los casos en los que se ejecuta en un estado de escasez de CPU porque el recuento de ticks se incrementa a un ritmo que refleja la cantidad de CPU que se recibe, en lugar de ser absoluto. Esto significa que es muy improbable que se produzcan tiempos de espera debido a cargas altas.

    En casos extremos, si el Wrapper recibe algo de CPU pero la JVM está completamente privada de ella, o viceversa, los tiempos de espera seguirán siendo posibles. Sin embargo, ambos procesos siempre operan exactamente con la misma prioridad, por lo que esto es muy improbable.

Sin embargo, hay algunas desventajas al utilizar un contador de "ticks" para la medición del tiempo:

  • El temporizador de ticks requiere que se asigne un hilo adicional dentro del Wrapper nativo. Esto se traduce en un ligero aumento de los recursos necesarios para ejecutar el Wrapper.

    El lado Java del Wrapper utiliza un hilo que ya se estaba usando para comprobar las señales del sistema, por lo que no hay aumento de recursos en el lado Java.

  • Con cualquier carga de CPU inferior al 100 %, los hilos del temporizador siempre obtendrán suficiente CPU para incrementar sus recuentos y ser temporalmente precisos. Pero cuando el sistema se ejecuta al 100 % de CPU, el hilo no podrá iterar a máxima velocidad, lo que hará que el recuento se incremente más lentamente. En la mayoría de los casos, esto es en realidad algo positivo. Sin embargo, hará que operaciones como el intervalo de ping sean inconsistentes en ocasiones, por lo que este hecho debe tenerse en cuenta.

Propiedades de depuración del temporizador

El Wrapper también implementa un par de propiedades que resultan útiles para supervisar cuándo los hilos del temporizador de la JVM o del Wrapper ganan o pierden tiempo en relación con el reloj del sistema. Se implementaron principalmente con fines de depuración, pero pueden proporcionar información muy útil sobre el estado del sistema. Se describen aquí en lugar de en su propia página, ya que no tienen sentido fuera de este contexto.

wrapper.timer_slow_threshold

Compatibilidad :3.1.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

La propiedad wrapper.timer_slow_threshold mostrará un mensaje en el registro siempre que el temporizador de "ticks" se retrase respecto a la hora del sistema más de un número umbral de segundos, dentro de un único bucle del hilo del temporizador. El valor predeterminado de esta propiedad es muy alto para desactivarla de forma efectiva.

Ejemplo:
wrapper.timer_slow_threshold=10

Establecer el umbral lento en un valor bajo como 1 segundo proporcionará información útil sobre cuándo durante el día el sistema está bajo carga.

Un valor de "0" (cero) mostrará cada mínimo desfase de tiempo y, en general, no es muy útil. Incluso con una carga muy ligera, el temporizador se retrasará ligeramente respecto al reloj del sistema simplemente porque el propio bucle tarda un tiempo finito en completarse.

Valores ligeramente más altos, como 10 segundos, pueden resultar bastante útiles, ya que señalarán cualquier período importante de alta carga en el sistema, sin molestarse en registrar cada pequeño tropiezo de la CPU.

Cualquier ajuste hacia adelante del reloj del sistema se interpretará como un período de alta carga de CPU que duró el tiempo que se adelantó el reloj.

Si, por ejemplo, ha establecido esta propiedad en un valor bajo y el reloj del sistema se adelanta un minuto, o está bajo una carga extremadamente alta durante un minuto, verá una salida en sus registros como la siguiente:

Ejemplo de registro:
INFO   | wrapper  | 2004/07/21 08:52:01 | The timer fell behind the system clock by 60000ms.
INFO   | jvm 1    | 2004/07/21 08:52:15 | The timer fell behind the system clock by 60000ms.

El par de mensajes indica que tanto el proceso del Wrapper como el de la JVM detectaron el cambio en la hora del sistema. Es bastante habitual que los números notificados por los dos procesos difieran ligeramente cuando el salto se debe a una carga alta.

wrapper.timer_fast_threshold

Compatibilidad :3.1.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

La propiedad wrapper.timer_fast_threshold mostrará un mensaje en el registro siempre que la hora del sistema se retrase respecto al temporizador de "ticks" más de un número umbral de segundos, dentro de un único bucle del hilo del temporizador. El valor predeterminado de esta propiedad es muy alto para desactivarla de forma efectiva.

Ejemplo:
wrapper.timer_fast_threshold=0

Establecer el umbral rápido en un valor bajo no suele ser tan útil como la propiedad de umbral lento anterior. En funcionamiento normal, el temporizador de "ticks" nunca avanzará más allá de la hora del sistema. La única excepción es el caso en que el reloj del sistema se haya retrasado. Establecer el valor de la propiedad en "0" (cero) detectará cualquier ajuste hacia atrás del reloj del sistema.

Si, por ejemplo, ha establecido esta propiedad en un valor bajo y el reloj del sistema se retrasa un minuto, verá una salida en sus registros como la siguiente:

Ejemplo de registro:
INFO   | wrapper  | 2004/07/21 08:52:01 | The system clock fell behind the timer by 60000ms.
INFO   | jvm 1    | 2004/07/21 08:52:15 | The system clock fell behind the timer by 60000ms.

El par de mensajes indica que tanto el proceso del Wrapper como el de la JVM detectaron el cambio en la hora del sistema.

Referencia: Archivo de Comandos