Dans certaines situations, un processus s'exécutant sur votre système peut être soudainement terminé et vous n'avez peut-être pas beaucoup d'indices sur la cause. Le processus lui-même n'a pas l'opportunité d'afficher une erreur dans le terminal ou dans son fichier journal.

Cela peut se produire si le processus a planté, mais aussi s'il est tué par un autre processus s'exécutant sur le système. Par exemple, certains logiciels antivirus prennent parfois l'initiative de tuer un processus considéré comme présentant des menaces potentielles. Lorsque votre programme est tué, vous aimeriez certainement savoir quel processus en est responsable. Habituellement, vous utiliseriez un outil de débogage comme gFlags pour tracer quel processus a envoyé le signal d'arrêt. Cependant, vous pourriez ne pas l'avoir installé sur votre machine, ou vous pourriez ne pas vouloir utiliser un tel outil en production.

À partir de la version 3.5.42, le Wrapper peut être configuré pour enregistrer une sortie dans le Journal des événements Windows chaque fois qu'il se termine de manière inattendue. Il est également possible de configurer le même comportement pour le processus Java qu'il surveille.

Cette fonctionnalité peut être activée ou désactivée en changeant simplement les valeurs des propriétés ci-dessous.

• Surveiller la sortie du processus Wrapper :
  • wrapper.monitor_exit
• Surveiller la sortie du processus Java :
  • wrapper.java.monitor_exit

Pour que les propriétés ci-dessus prennent effet, vous devrez exécuter le Wrapper avec '--setup'. Les identifiants d'administrateur seront demandés s'ils n'ont pas déjà été accordés.

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

Un fichier batch modèle appelé 'SetupApp.bat.in' est également fourni dans le dossier src/bin où le Wrapper est installé. Veuillez consulter la page suivante pour des explications sur la personnalisation des fichiers batch modèles. Une fois votre fichier batch prêt, vous pourrez exécuter le setup en l'exécutant simplement.

> .\SetupTestWrapper.bat
wrapperm | Registering to the Event Log system...
...

Une fois la surveillance activée, chaque sortie du Wrapper générera une sortie dans le Journal des événements Windows. Si vous ouvrez l'Observateur d'événements (sous 'Panneau de configuration > Outils d'administration'), vous verrez la sortie suivante dans la section 'Application' :

Comme vous pouvez le voir, cette sortie indique quel processus a tué le Wrapper (dans notre exemple Taskmgr.exe) et indique également le code de terminaison du processus Wrapper.

Pour désactiver la surveillance de la sortie, vous pouvez définir wrapper.monitor_exit (ou wrapper.java.monitor_exit) sur DISABLED et relancer le Wrapper avec la commande '--setup'. Vous pouvez également laisser la propriété telle quelle, et exécuter le Wrapper avec la commande '--teardown' ou exécuter le fichier batch de teardown.

Si vous souhaitez que seule une instance spécifique du Wrapper soit surveillée, vous pouvez renommer wrapper.exe et lui donner un nom unique sur la machine.

Si une autre instance du Wrapper avec le même nom de binaire est démarrée alors que la surveillance est activée mais que wrapper.monitor_exit n'est pas défini sur ENABLED dans son fichier de configuration, le Wrapper enregistrera l'avertissement suivant :

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.