Surveillance des déploiements d'AEM forms

Vous pouvez surveiller les déploiements d'AEM forms, tant au niveau du système qu’au niveau interne. Utilisez pour cela des outils de gestion spécialisés tels que HP OpenView, IBM Tivoli et CA UniCenter, ainsi qu’un moniteur JMX tiers appelé JConsole et tout particulièrement dédié au contrôle de l’activité Java. L’implémentation d’une stratégie de surveillance améliore la disponibilité, la fiabilité et les performances des déploiements d'AEM forms.

Pour plus d’informations sur la surveillance des déploiements d'AEM forms, consultez le Guide technique pour la surveillance des déploiements d'AEM forms .

Contrôle via les MBeans

AEM forms propose deux MBeans qui fournissent des informations de navigation et des statistiques. Il s’agit des seuls MBeans pris en charge au niveau de l’intégration et de l’inspection :

  • ServiceStatistic : ce MBean fournit des informations sur le nom du service et sur sa version.

  • OperationStatistic : ce MBean fournit les statistiques de chaque service du serveur Forms. C’est là que les administrateurs peuvent obtenir des informations sur un service donné, par exemple l’heure d’appel, le nombre d’erreurs, etc.

Interfaces publiques de ServiceStatisticMbean

Vous pouvez accéder à ces interfaces publiques du MBean ServiceStatistic à des fins de test : 

public String getServiceId();  
public int getMajorVersion();  
public int getMinorVersion();

Interfaces publiques de OperationStatisticMbean

Vous pouvez accéder à ces interfaces publiques du MBean OperationStatistic à des fins de test : 

// InvocationCount: The number of times the method is invoked.  
public long getInvocationCount();  
// InvocationStartTime: The time at which the method started to execute.  
public long getInvocationStartTime();  
// InvocationEndTime: The time at which the method finished execution.  
public long getInvocationEndTime();  
// InvocationTime: The time taken for the execution of the method.  
public long getInvocationTime();  
// LastSamplingDateTime: Convert InvocationStartTime to a formatted string  
public String getLastSamplingDateTime();  
// MaxInvocationTime: The maximum time taken for the execution of the method.  
public long getMaxInvocationTime();  
// MinInvocationTime: The minimum time taken for the execution of the method.  
public long getMinInvocationTime();  
// AverageInvocationTime: the averege execution time taken for the execution of the method.  
public double getAverageInvocationTime();  
// ExceptionCount: The number of times the method has thrown an Exception.  
public long getExceptionCount();  
// ExceptionMessage: The message of the last exception occurred.  
public String getExeptionMessage();  
public void setExceptionMessage(String errorMessage);

Arborescence des MBeans et statistiques sur les opérations

Vous pouvez accéder aux statistiques du MBean OperationStatistic depuis une console JMX (JConsole). Ces statistiques sont des attributs de MBean et vous pouvez les parcourir dans l’arborescence suivante :

Arborescence de MBean

Adobe Domain Name :
nom de domaine Adobe dépendant du serveur d’applications. Si celui-ci ne définit pas le domaine, la valeur par défaut sera adobe.com.

ServiceType :
AdobeService est le nom de type de service utilisé pour répertorier tous les services.

AdobeServiceName :
nom ou identifiant du service Adobe.

Version:
version du service.

Statistiques des opérations

Invocation Time :
durée de l’exécution de la méthode. Cette valeur ne comprend pas le temps de sérialisation de la demande, de transfert du client vers le serveur et de désérialisation.

Invocation count :
nombre de fois où le service a été appelé.

Average invocation time :
durée moyenne de tous les appels qui ont été exécutés depuis le démarrage du serveur.

Max invocation time :
durée de l’appel le plus long qui a été exécuté depuis le démarrage du serveur.

Min invocation time :
durée de l’appel le plus court qui a été exécuté depuis le démarrage du serveur.

Exception Count :
nombre d’appels ayant entraîné des échecs.

Exception Message :
message d’erreur relatif à la dernière exception qui s’est produite.

Last Sampling Date Time :
date du dernier appel.

Time Unit :
milliseconde par défaut.

Pour activer le contrôle JMX, les serveurs d’applications ont généralement besoin d’être configurés. Veuillez consulter la documentation de votre serveur d’applications pour obtenir des informations détaillées.

Exemples de configuration d’un accès JMX ouvert

JBoss 4.0.3/4.2.0 - configuration du démarrage de la JVM

Pour afficher les MBeans depuis JConsole, vous devez configurer les paramètres de démarrage de la JVM du serveur d’applications JBoss. Assurez-vous que JBoss est démarré depuis le fichier run.bat/sh.

  1. Modifiez le fichier run.bat situé sous InstallJBoss/bin.

  2. Recherchez la ligne JAVA_OPTS et ajoutez le code suivant : 

    -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9088 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

WebLogic 9.2 /10 - configuration du démarrage de la JVM

  1. Modifiez le fichier startWebLogic.bat situé sous [WebLogic Home] /user_projects/domains/Adobe_Live_Cycle/bin.

  2. Recherchez la ligne JAVA_OPTS et ajoutez le code suivant : 

    -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9088 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

  3. Redémarrez WebLogic.

Remarque : pour WebLogic, vous pouvez accéder au MBean à distance ou via IIOP.

Accès à distance au MBean

  1. Lancez JConsole pour établir une nouvelle connexion et cliquez sur l’onglet Remote.

  2. Entrez le nom d’hôte et le port (9088, le nombre spécifié dans les options de démarrage de la JVM).

WebSphere 6.1 - configuration du démarrage de la JVM

  1. Dans la console d’administration (Serveur d’applications > server1 > Process Definition > JVM), ajoutez la ligne suivante dans le champ correspondant à Generic JVM Argument : 

    -Djavax.management.builder.initial= -Dcom.sun.management.jmxremote

  2. Ajoutez les trois lignes suivantes (ou annulez leur mise en commentaires) dans le fichier /opt/IBM/WebSphere/AppServer/java/jre/lib/management/management.properties (ou <Votre JRE WebSphere>/lib/management/management.properties) : 

    com.sun.management.jmxremote.port=9999 //any port you like, but make sure you use this port when you connect  
com.sun.management.jmxremote.authenticate=false  
com.sun.management.jmxremote.ssl=false

  3. Redémarrez WebSphere.