wrapper.cpu.timeout
Compatibilité :2.2.8
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

AVERTISSEMENT

NE MODIFIEZ AUCUN de ces paramètres à moins d'avoir lu la description de cette propriété. Des paramètres incorrects peuvent empêcher le Wrapper de fonctionner comme prévu.

NOTE

Cette propriété est ignorée sauf si wrapper.use_system_time=TRUE.

Lorsque wrapper.use_system_time=FALSE, des notifications similaires concernant les changements d'heure système et les retards dus à une charge élevée peuvent être consignées à l'aide des propriétés wrapper.timer_fast_threshold et wrapper.timer_slow_threshold.

Cette propriété définit le nombre de secondes sans CPU avant que la JVM n'émette un avertissement et n'étende les timeouts. Pour que cette propriété ait un effet, sa valeur doit être inférieure à celle des autres propriétés de timeout (wrapper.startup.timeout, wrapper.ping.timeout et wrapper.shutdown.timeout). Définir la valeur de cette propriété à « 0 » (zéro) signifie ne jamais étendre le timeout.

La valeur par défaut est « 10 secondes ».

Exemple : (10 secondes) 
wrapper.cpu.timeout=10

Si le Wrapper détecte qu'il s'est vu refuser le CPU pendant une période prolongée, vous pourrez voir des messages comme les suivants provenant du Wrapper, de la JVM, ou des deux.

Exemple de journal : 
INFO   | wrapper  | Wrapper Process has not received any CPU time for 27 seconds.
                    Extending timeouts.
INFO   | jvm 1    | JVM Process has not received any CPU time for 27 seconds.
                    Extending timeouts.

Ces messages sont des avertissements indiquant que, dans ce cas, le Wrapper et son processus JVM se sont tous deux vu refuser l'accès au CPU pendant une période de 27 secondes. Selon l'état actuel du Wrapper, le timeout de démarrage, de ping ou d'arrêt est étendu afin d'éviter un faux timeout causé par le manque de puissance de traitement.

Il existe deux cas où le Wrapper ou la JVM qu'il contrôle pourraient se voir refuser l'accès au CPU pendant une période prolongée. L'un ou l'autre pourrait amener le Wrapper à penser que la JVM est bloquée, entraînant son redémarrage ou son arrêt parce qu'un ou plusieurs timeouts ont expiré.

La première façon dont cela peut se produire est lorsque le Wrapper rivalise pour les ressources système avec un autre processus qui a l'habitude de consommer 100 % du CPU pendant de longues périodes sans céder la place aux autres processus. La plupart des systèmes d'exploitation modernes gèrent assez bien le multitâche, mais il existe encore des cas où cela peut échouer. Un exemple de cela sous Windows est lorsque la machine manque fortement de mémoire, ce qui entraîne beaucoup d'échanges disque (swapping). Si la mémoire totale n'est pas suffisante, le système entier peut se figer pendant une minute entière avant que les applications ne reçoivent à nouveau des cycles CPU.

Dans la plupart des cas, lorsque vous rencontrez des problèmes de timeouts CPU, vous devriez réellement chercher un moyen de résoudre le problème du Wrapper qui ne reçoit pas de CPU plutôt que d'étendre les timeouts. Si l'application exécutée par le Wrapper ne reçoit pas de CPU, elle ne pourra pas traiter de manière fiable les requêtes des clients.

Une deuxième façon est si le système est mis en veille puis repris. C'est une chose courante sur les ordinateurs portables. Lorsque le système reprend, il semblera avoir été soudainement avancé de potentiellement plusieurs heures.

Par défaut, des messages d'avertissement s'afficheront après 10 secondes, ce qui est en réalité assez long. Le déclenchement du timeout CPU n'aura aucun effet indésirable sur une application autre que l'affichage du message dans les journaux. Pour éviter que ce message ne soit enregistré, le timeout peut être défini à une valeur plus élevée ou désactivé complètement.

AVERTISSEMENT

Bien que cette possibilité existe, soyez conscient que définir la valeur de cette propriété à « 0 » (zéro) (= désactiver le Timeout) ou à une valeur supérieure à un autre timeout pourrait entraîner le déclenchement erroné de ce timeout en cas de charge élevée. Cela peut conduire au redémarrage de la JVM alors qu'un redémarrage n'est pas vraiment nécessaire.

Référence : Délai d'attente
  • wrapper.cpu.timeout (2.2.8)

    Configure le nombre de secondes sans CPU avant que la JVM n'envoie un avertissement et n'étende les délais d'attente.

  • wrapper.max_hostid_timeout (3.4.0) ( Standard/Professionnel )

  • wrapper.logfile.close.timeout (3.5.21)

    Contrôle le nombre de secondes au bout desquelles le fichier journal doit se fermer après la dernière entrée de journal.

  • wrapper.logfile.flush.timeout (3.5.21)

    Configure l'intervalle en secondes auquel le Wrapper vide toutes les sorties vers le fichier journal.

  • wrapper.logfile.inactivity.timeout (3.2.0, obsolète depuis 3.5.21)

    Contrôle le nombre de secondes au bout desquelles le fichier journal doit se fermer après la dernière entrée de journal.

  • wrapper.ping.timeout (1.0.0)

    Configure le nombre de secondes autorisées entre deux réponses de ping provenant de la JVM.

  • wrapper.startup_thread.timeout (3.5.11)

    Configure le nombre de secondes accordées pour que les opérations de démarrage asynchrones se terminent.

  • wrapper.startup.timeout (1.0.0)

    Configure le nombre de secondes autorisées entre le moment où le Wrapper lance la JVM et le moment où la JVM répond que l'application a démarré.

  • wrapper.shutdown.timeout (2.2.7)

    Configure le nombre de secondes autorisées entre le moment où le Wrapper demande à la JVM de s'arrêter et le moment où la JVM répond qu'elle est en train de s'arrêter.

  • wrapper.jvm_exit.timeout (2.2.8)

    Configure le nombre de secondes autorisées entre le moment où la JVM signale qu'elle est arrêtée et le moment où le processus JVM se termine réellement.

  • wrapper.jvm_cleanup.timeout (3.4.0)

    Configure le nombre de secondes accordées au Wrapper pour nettoyer les processus enfants après l'arrêt de la JVM.

  • wrapper.jvm_terminate.timeout (3.5.18)

    Configure le nombre de secondes autorisées à partir du moment où le Wrapper demande au système de terminer de force la JVM jusqu'à ce qu'il confirme que le processus s'est réellement arrêté.