Débogage de votre application Java à l'aide du Wrapper

Le Wrapper propose quelques fonctionnalités simples qui vous aideront à localiser les problèmes que vous pourriez rencontrer avec votre application.

Demander un Thread Dump

Le Wrapper permet de demander à la JVM de vider son état actuel. Le contenu exact des informations variera selon la JVM utilisée.

Les JVM Oracle affichent les traces de pile de tous les threads en cours d'exécution dans la console.

Les JVM IBM fournissent des informations encore plus utiles. Les traces de pile de tous les threads ainsi que les états des moniteurs d'objets sont vidés vers la console. De plus, un fichier est créé dans le répertoire courant qui, en plus des informations affichées dans la console, contient également des informations utiles sur le système, y compris toutes les variables d'environnement.

Un Thread Dump peut être demandé sur les systèmes Windows en appuyant sur CTRL-BREAK ou sur les systèmes Linux en appuyant sur CTRL-\. L'invocation d'un thread dump n'affecte pas la JVM. Elle continuera de s'exécuter normalement.

Le script de démarrage pour Linux et Solaris fourni avec l'installation du Wrapper lance le Wrapper dans un thread en arrière-plan. Pour demander un thread dump à l'aide de ces scripts, relancez simplement le script en spécifiant le paramètre 'dump'.

Activer la journalisation de débogage

Si la propriété wrapper.debug est définie sur TRUE, cela active rapidement la journalisation de débogage.

De nombreux problèmes de configuration peuvent être rapidement résolus en définissant le niveau de journalisation de la sortie console sur DEBUG. La commande complète utilisée pour lancer Java ainsi que les informations de version de la JVM en cours d'exécution seront alors affichées dans la console. Consultez la section Propriétés de configuration de la journalisation pour plus d'informations.

Lorsque le « fichier include » (style en cascade) est utilisé dans le fichier de configuration, veuillez activer les messages de débogage. Si vous rencontrez des problèmes de licence, veuillez définir la propriété wrapper.license.debug et activer le débogage des fichiers include. Combinés, la plupart des problèmes de configuration deviennent évidents.

Détecter le débogage

Lorsque la propriété wrapper.java.detect_debug_jvm est définie sur TRUE et que la Détection du débogueur fonctionne, le Wrapper ignorera certains timeouts.