Descripción general

En algunas situaciones, un proceso en ejecución en su sistema podría ser terminado de forma súbita y es posible que no tenga muchas pistas sobre la causa. El propio proceso no tiene la oportunidad de mostrar ningún error en el terminal o en su archivo de registro.

Esto puede ocurrir si el proceso se ha bloqueado, pero también si otro proceso en ejecución en el sistema lo está matando. Por ejemplo, ciertos programas antivirus a veces toman la iniciativa de matar un proceso que se considera que presenta amenazas potenciales. Cuando están matando su programa, ciertamente le gustaría saber qué proceso es el responsable. Normalmente usaría una herramienta de depuración como gFlags para rastrear qué proceso envió la señal de terminación. Sin embargo, es posible que no la tenga instalada en su máquina, o que no desee usar dicha herramienta en producción.

A partir de la versión 3.5.42, el Wrapper se puede configurar para registrar un mensaje en el Registro de eventos de Windows siempre que termine de forma inesperada. También es posible configurar el mismo comportamiento para su proceso Java supervisado.

Esta función se puede habilitar o deshabilitar simplemente cambiando los valores de las propiedades siguientes.

Para que las propiedades anteriores surtan efecto, deberá ejecutar el Wrapper con el '--setup'. Se solicitarán las credenciales de administrador si aún no se han concedido.

Ejemplo 1 (Ejecutar la configuración con una línea de comandos):
> .\wrapper.exe --setup ../conf/wrapper.conf
wrapperm | Registering to the Event Log system...
wrapperm | Enabling silent exit monitoring for the Wrapper process...
wrapperm | Diabling silent exit monitoring for the Java process...
wrapperm | Setup done successfully.

También se proporciona un archivo por lotes de plantilla llamado 'SetupApp.bat.in' en la carpeta src/bin donde está instalado el Wrapper. Consulte la página siguiente para obtener una explicación sobre cómo personalizar los archivos por lotes de plantilla. Una vez que su archivo por lotes esté listo, podrá ejecutar la configuración simplemente ejecutándolo.

Ejemplo 2 (Ejecutar la configuración con el archivo por lotes):
> .\SetupTestWrapper.bat
wrapperm | Registering to the Event Log system...
...

Una vez habilitada la supervisión, cada salida del Wrapper generará un mensaje en el Registro de eventos de Windows. Si abre el Visor de eventos (en 'Panel de control > Herramientas administrativas'), verá el siguiente mensaje en la sección 'Aplicación':

Como puede ver, este mensaje muestra qué proceso mató al Wrapper (en nuestro ejemplo Taskmgr.exe) y también indica el código de terminación del proceso Wrapper.

Para deshabilitar la supervisión de la salida, puede establecer wrapper.monitor_exit (o wrapper.java.monitor_exit) en DISABLED y volver a ejecutar el Wrapper con el comando '--setup'. Como alternativa, puede dejar la propiedad como está y ejecutar el Wrapper con el comando '--teardown' o ejecutar el archivo por lotes de teardown.

NOTA

Con esta función de supervisión habilitada, se registrará un mensaje en el Registro de eventos cada vez que el Wrapper o el proceso Java termine, independientemente de su código de salida. En situaciones normales, es posible que desee deshabilitar esta función para evitar saturar el Registro de eventos.

ADVERTENCIA

La función de supervisión se habilita por nombre de binario, y no por proceso. Esto significa que si hay otras instancias del Wrapper ejecutándose en la máquina (u otros procesos Java, al supervisar Java) con el mismo nombre de binario, el Registro de eventos también detectará y responderá a esas terminaciones de proceso.

Si desea que solo se supervise una instancia específica del Wrapper, puede cambiar el nombre de wrapper.exe y asignarle un nombre que sea único en la máquina.

Si se inicia otra instancia del Wrapper con el mismo nombre de binario mientras la supervisión está habilitada pero wrapper.monitor_exit no está establecido en ENABLED en su archivo de configuración, el Wrapper registrará la siguiente advertencia:

wrapper  | Exit Monitoring is enabled for the Wrapper process.
wrapper  |  Whenever the process exits, an output indicating the reason/origin of the
wrapper  |  termination will be logged to the Event Log. In normal situations you might
wrapper  |  want disable this feature to avoid cluttering the Event Log.
wrapper  |  If this feature should be enabled set the wrapper.monitor_exit property to 'ENABLED',
wrapper  |  otherwise set it to 'DISABLED' and run the Wrapper with the '--setup' command.

Supervisar la salida del proceso Wrapper

wrapper.monitor_exit

Compatibilidad :3.5.42
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Especifica si el Registro de eventos debe registrar un mensaje cuando el proceso Wrapper termina de forma silenciosa.

Los valores posibles son:

  • ENABLED :

    para activar la función.

  • DISABLED :

    para desactivar la función.

  • UNCHANGED :

    para dejar la función como está.

El valor predeterminado es UNCHANGED.

Ejemplo (supervisar la salida del proceso Wrapper):
wrapper.monitor_exit=ENABLED

Supervisar la salida del proceso Java

wrapper.java.monitor_exit

Compatibilidad :3.5.42
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Especifica si el Registro de eventos debe registrar un mensaje cuando el proceso Java termina de forma silenciosa.

Los valores posibles son:

  • ENABLED :

    para activar la función.

  • DISABLED :

    para desactivar la función.

  • UNCHANGED :

    para dejar la función como está.

El valor predeterminado es UNCHANGED.

Ejemplo (supervisar la salida del proceso Java):
wrapper.java.monitor_exit=ENABLED

NOTA

Cuando el Wrapper se inicia, solicita la versión de Java lanzando Java con el argumento '--version'. Si la supervisión de la salida está habilitada para el proceso Java, esto dará como resultado un mensaje adicional en el Registro de eventos.