Show Menu
SUJETS×

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, voir 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
​Nom de domaine Adobe : Dépend 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 utilisé pour répertorier tous les services.
​AdobeServiceName : Nom du service ou ID du service.
​Version : Version du service.
Statistiques des opérations
​Heure d’appel : Temps nécessaire à 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.
​Nombre d’appels : Nombre de fois où le service est appelé.
​Temps moyen d’appel : Temps moyen 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.
​Temps d’appel min. : durée de l’appel le plus court qui a été exécuté depuis le démarrage du serveur.
​Nombre d’exceptions : Nombre d’appels ayant entraîné des échecs.
​Message d’exception : Message d’erreur de la dernière exception survenue.
​Heure du dernier échantillonnage : Date du dernier appel.
​Unité de temps : La valeur par défaut est milliseconde.
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. Edit the startWebLogic.bat file that is located under* #*/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.
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.