Surveiller les déploiements d’AEM Forms monitoring-aem-forms-deployments

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Vous pouvez surveiller les déploiements d’AEM forms au niveau du système et au niveau interne. Vous pouvez utiliser des outils de gestion spécialisés tels que HP OpenView, IBM Tivoli et CA UniCenter, ainsi qu’un moniteur JMX tiers appelé JConsole pour surveiller spécifiquement 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 Guide technique pour la surveillance des déploiements d’AEM forms.

Surveillance à l’aide des MBeans monitoring-using-mbeans

AEM forms fournit deux MBeans enregistrés qui fournissent des informations de navigation et statistiques. Il s’agit des seuls MBeans pris en charge pour l’intégration et 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 particulier, comme l’heure d’appel, le nombre d’erreurs, etc.

Interfaces publiques de ServiceStatisticMbean servicestatisticmbean-public-interfaces

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 operationstatisticmbean-public-interfaces

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 de MBean et statistiques des opérations mbean-tree-operation-statistics

À l’aide d’une console JMX (JConsole), les statistiques du MBean OperationStatistic sont disponibles. Ces statistiques sont des attributs de MBean et peuvent être naviguées sous l’arborescence suivante :

Arborescence 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 ou identifiant du service.

Version : version du service.

Statistiques des opérations

Durée d’appel : 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.

Nombre d’appels : nombre de fois où le service a été appelé.

Durée moyenne d’appel : durée moyenne de tous les appels qui ont été exécutés depuis le démarrage du serveur.

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

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

Nombre d’exceptions : nombre d’échecs d’appel.

Message d’erreur : 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 la milliseconde.

Pour activer la surveillance JMX, les serveurs d’applications ont généralement besoin d’une configuration. Consultez la documentation de votre serveur d’applications pour plus d’informations.

Exemples de configuration de l’accès JMX ouvert examples-of-how-to-set-up-open-jmx-access

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

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

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

  2. Recherchez la ligne JAVA_OPTS et ajoutez les éléments suivants :

    code language-as3
     -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 les éléments suivants :

    code language-as3
     -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.

NOTE
Pour WebLogic, vous pouvez accéder au MBean à distance ou IIOP.

Accès à distance au MBean

  1. Lancez JConsole pour une nouvelle connexion et cliquez sur l’onglet distant.
  2. Saisissez le nom d’hôte et le port (9088, le numéro que vous indiquez lors des 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 pour Generic JVM Argument :

    code language-as3
     -Djavax.management.builder.initial= -Dcom.sun.management.jmxremote
    
  2. Ajoutez ou annulez la mise en commentaire des trois lignes suivantes dans le fichier /opt/IBM/WebSphere/AppServer/java/jre/lib/management/management.properties (ou <your websphere="" jre="">/ lib/management/management.properties) :

    code language-as3
     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.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da