Présentation

Cette section décrit les propriétés qui peuvent être utilisées pour imprimer des tableaux de statistiques de performance pour le système, le processus Wrapper et la JVM. Ces statistiques ont été ajoutées dans la version 3.5.52 afin d'aider à comprendre les problèmes dans des situations telles que lorsque la JVM est détectée comme bloquée.

Les données sont susceptibles de changer dans les versions futures du Wrapper, mais incluent actuellement l'utilisation de la mémoire et du processeur. Elles sont collectées à intervalles réguliers par le Wrapper, puis imprimées rétrospectivement lorsque certains événements se produisent. Cela permet d'analyser ce qui s'est passé pendant une période donnée avant qu'un problème ne survienne et, lorsqu'elles sont incluses dans les journaux, constituent une information utile pour le support technique.


Déclenchement de l'impression des statistiques :

Le mot-clé « STATS » peut être utilisé dans la valeur de n'importe quelle propriété d'action pour configurer le moment où les statistiques doivent être imprimées.

Exemple : Imprimer les statistiques tous les jours à 1 h 00.
wrapper.timer.1.action=STATS
wrapper.timer.1.interval=hour=1

Il est également possible d'utiliser le mot-clé « STATS » dans le fichier de commandes pour déclencher l'impression des statistiques à tout moment.


Les propriétés suivantes peuvent être utilisées pour configurer la façon dont les statistiques doivent être imprimées :

NOTE

Cette fonctionnalité n'est actuellement disponible que pour Windows, mais peut être ajoutée à d'autres plateformes sur demande.

wrapper.stats.enable

Compatibilité :3.5.52
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Cette propriété peut être utilisée pour activer ou désactiver la possibilité d'imprimer des statistiques de performance. Lorsqu'elle est définie sur FALSE, aucune statistique ne sera collectée.

La collecte des statistiques a été optimisée pour n'avoir qu'un impact négligeable sur les performances pendant l'exécution du Wrapper. Dans la plupart des cas, il est préférable de laisser la valeur de cette propriété à TRUE, sinon les informations ne seront pas disponibles pour analyse en cas de problème. Gardez à l'esprit que les problèmes liés aux performances peuvent être rares mais sont souvent difficiles à reproduire, et la possibilité de consulter a posteriori ce qui s'est passé est précieuse.

La valeur par défaut est TRUE.

Exemple : Désactiver les statistiques.
wrapper.stats.enable=FALSE

wrapper.stats.system.enable

Compatibilité :3.5.52
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Cette propriété peut être utilisée pour activer ou désactiver la possibilité d'imprimer des statistiques de performance pour le système. Actuellement, la mémoire physique, la mémoire validée et le cache sont inclus dans les statistiques système.

La propriété est ignorée si wrapper.stats.enable est défini sur FALSE.

La valeur par défaut est TRUE.

Exemple :
wrapper  | System:
wrapper  |                          Physical         Committed          Cache
wrapper  | -------------------------------------------------------------------
wrapper  | 12:00:44 - 12:00:54 |  13.0 GB (41%)  |  14.4 GB (39%)   |   3.5 GB
wrapper  | 12:00:54 - 12:01:04 |  13.0 GB (41%)  |  14.5 GB (39%)   |   3.5 GB
wrapper  | 12:01:04 - 12:01:14 |  12.9 GB (40%)  |  14.4 GB (39%)   |   3.5 GB
wrapper  | 12:01:14 - 12:01:24 |  12.8 GB (40%)  |  14.2 GB (38%)   |   3.5 GB
wrapper  | 12:01:24 - 12:01:34 |  12.8 GB (40%)  |  14.2 GB (39%)   |   3.5 GB
wrapper  | 12:01:34 - 12:01:44 |  12.8 GB (40%)  |  14.2 GB (38%)   |   3.5 GB
wrapper  | 12:01:44 - 12:01:54 |  12.8 GB (40%)  |  14.2 GB (38%)   |   3.5 GB
wrapper  | 12:01:54 - 12:02:04 |  12.8 GB (40%)  |  14.2 GB (38%)   |   3.5 GB
wrapper  | 12:02:04 - 12:02:14 |  12.7 GB (40%)  |  14.1 GB (38%)   |   3.5 GB
wrapper  | 12:02:14 - 12:02:20 |  12.7 GB (40%)  |  14.1 GB (38%)   |   3.5 GB

wrapper.stats.wrapper.enable

Compatibilité :3.5.52
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Cette propriété peut être utilisée pour activer ou désactiver la possibilité d'imprimer des statistiques de performance pour le processus Wrapper.

La propriété est ignorée si wrapper.stats.enable est défini sur FALSE.

Les données suivantes seront imprimées :

  • L'utilisation du processeur en pourcentage.

  • L'ensemble de travail (Working set), qui est la taille dans l'espace d'adressage virtuel du processus Wrapper actuellement résidente en mémoire physique.

  • Le pool paginé, qui est la quantité de mémoire du noyau et des pilotes de périphériques pouvant déborder de la mémoire physique vers le fichier d'échange (disque).

  • Le pool non paginé, qui est la quantité de mémoire du noyau et des pilotes de périphériques ne pouvant pas déborder de la mémoire physique vers le fichier d'échange.

  • Le pool validé, qui est la quantité de mémoire que le processus Wrapper a demandé à utiliser.

La valeur par défaut est TRUE.

Exemple :
wrapper  | Wrapper process:
wrapper  |                        CPU   Work. set    Paged    Non-paged  Committed
wrapper  | -----------------------------------------------------------------------
wrapper  | 12:00:14 - 12:00:24 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:00:24 - 12:00:34 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:00:34 - 12:00:44 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:00:44 - 12:00:54 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:00:54 - 12:01:04 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:04 - 12:01:14 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:14 - 12:01:24 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:24 - 12:01:34 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:34 - 12:01:44 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:44 - 12:01:45 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB

wrapper.stats.java.enable

Compatibilité :3.5.52
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Cette propriété peut être utilisée pour activer ou désactiver la possibilité d'imprimer des statistiques de performance pour la JVM (processus Java).

La propriété est ignorée si wrapper.stats.enable est défini sur FALSE.

Les données suivantes seront imprimées :

  • L'utilisation du processeur en pourcentage.

  • L'ensemble de travail (Working set), qui est la taille dans l'espace d'adressage virtuel du processus Java actuellement résidente en mémoire physique.

  • Le pool paginé, qui est la quantité de mémoire du noyau et des pilotes de périphériques pouvant déborder de la mémoire physique vers le fichier d'échange (disque).

  • Le pool non paginé, qui est la quantité de mémoire du noyau et des pilotes de périphériques ne pouvant pas déborder de la mémoire physique vers le fichier d'échange.

  • Le pool validé, qui est la quantité de mémoire que le processus Java a demandé à utiliser.

La valeur par défaut est TRUE.

Exemple :
wrapper  | Java process:
wrapper  |                        CPU   Work. set    Paged    Non-paged  Committed     Page Faults
wrapper  | -------------------------------------------------------------------------------------------
wrapper  | 12:00:14 - 12:00:24 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB | ########        38
wrapper  | 12:00:24 - 12:00:34 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB |                  0
wrapper  | 12:00:34 - 12:00:44 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB | #                1
wrapper  | 12:00:44 - 12:00:54 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB | #                1
wrapper  | 12:00:54 - 12:01:04 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB |                  0
wrapper  | 12:01:04 - 12:01:14 |  0.0% |  68.5 MB | 527.5 KB |  29.2 KB | 631.5 MB | #                3
wrapper  | 12:01:14 - 12:01:24 |  0.0% |  68.6 MB | 529.0 KB |  29.2 KB | 631.5 MB | ######          24
wrapper  | 12:01:24 - 12:01:34 |  0.0% |  68.6 MB | 529.0 KB |  29.2 KB | 631.5 MB |                  0
wrapper  | 12:01:34 - 12:01:44 |  0.0% |  68.6 MB | 529.0 KB |  29.2 KB | 631.5 MB | #                1
wrapper  | 12:01:44 - 12:01:45 |  0.0% |  68.6 MB | 529.0 KB |  29.2 KB | 631.5 MB |                  0

wrapper.stats.lines

Compatibilité :3.5.52
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Cette propriété spécifie le nombre maximal de lignes à imprimer par tableau de statistiques.

Sachez que l'augmentation de la valeur de cette propriété entraînera davantage de sorties dans les journaux. La valeur peut être équilibrée avec wrapper.stats.interval afin d'observer les performances sur une période qui vous convient, tout en conservant un nombre raisonnable de lignes par tableau.

Les valeurs valides sont comprises entre "1" et "60".

La valeur par défaut est 10.

Exemple : Limiter à 5 lignes.
wrapper.stats.lines=5

wrapper.stats.interval

Compatibilité :3.5.52
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Cette propriété spécifie l'intervalle, en secondes, auquel les statistiques sont collectées. L'heure de début et l'heure de fin de chaque intervalle peuvent être visualisées dans la première colonne des tableaux.

Les valeurs valides sont comprises dans la plage "1-86400" (1 seconde - 1 jour).

La valeur par défaut est un tiers de la valeur de wrapper.shutdown.timeout (soit 10 secondes par défaut).

NOTE

L'utilisation du processeur est calculée sur la base d'une moyenne sur l'ensemble de l'intervalle.

Le nombre de Page Faults (pour le processus Java) est le nombre total de défauts de page pendant un intervalle.

Exemples :

Exemple 1 : Intervalles d'une minute, pour une durée totale d'une heure.
wrapper.stats.interval=60
wrapper.stats.lines=60

Exemple 2 : Intervalles d'une heure, pour une durée totale d'un jour, et imprimés tous les jours à minuit.
wrapper.stats.interval=3600
wrapper.stats.lines=24
wrapper.timer.1.action=STATS
wrapper.timer.1.interval=hour=0

wrapper.stats_on_failed_jvm_exit

Compatibilité :3.5.52
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Cette propriété contrôle si les statistiques doivent être imprimées dans le cas où la JVM ne se termine pas lorsqu'elle est invitée à le faire. Elle est similaire à wrapper.request_thread_dump_on_failed_jvm_exit, qui provoque un dump de threads dans la même situation, à ceci près que les statistiques sont également imprimées lorsque la JVM est bloquée.

Lorsque cette propriété est définie sur TRUE, les statistiques seront imprimées avant les dumps de threads (si demandés), ce qui se produit lui-même avant que le processus JVM ne soit terminé.

La valeur par défaut est TRUE.

wrapper.stats_on_unexpected_jvm_exit

Compatibilité :3.5.60
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Cette propriété contrôle si les statistiques doivent être imprimées lorsque la JVM se termine de manière inattendue.

La valeur par défaut est TRUE.