La surveillance dans Experience Manager Assets implique l’observation et le suivi des technologies et processus suivants :
Typiquement, la surveillance d’Experience Manager Assets peut être effectuée de deux façons : en temps réel ou sur le long terme.
La surveillance en temps réel est conseillée lors de la phase de test des performances de votre développement ou en cas de charges élevées afin de comprendre les caractéristiques de performance de votre environnement. Typiquement, différents outils peuvent être utilisés pour la surveillance en temps réel. Voici quelques recommandations :
Visual VM : Visual VM vous permet d’afficher des informations détaillées sur la machine virtuelle Java, et notamment l’utilisation du processeur et de la mémoire Java. En outre, il vous permet de tester et d’évaluer le code exécuté sur un déploiement.
Top : Top est une commande Linux ouvrant un tableau de bord qui affiche des statistiques d’utilisation, notamment sur le processeur, la mémoire et les E/S. Vous obtenez ainsi une vue d’ensemble de ce qui se produit sur une instance.
Htop : Htop est un utilitaire qui permet de visualiser les processus de manière interactive. Il permet de disposer d’informations détaillées sur l’utilisation du processeur et de la mémoire en plus des informations fournies par Top. Htop peut être installé sur la plupart des systèmes Linux en utilisant yum install htop
ou apt-get install htop
.
Iotop : Iotop fournit un tableau de bord détaillé sur l’utilisation des disques en lecture/écriture. Il fournit des informations détaillées sur les processus qui utilisent les E/S sur les disques ainsi que le volume utilisé. Iotop peut être installé sur la plupart des systèmes Linux en utilisant yum install iotop
ou apt-get install iotop
.
Iftop : Iftop affiche des informations détaillées sur l’utilisation des ports ethernet et réseau. Iftop affiche des statistiques par canal de communication sur les entités utilisant Ethernet et la quantité de bande passante utilisée. Iftop peut être installé sur la plupart des systèmes Linux en utilisant yum install iftop
ou apt-get install iftop
.
Java Flight Recorder (JFR) : JFR est un outil Oracle pouvant être utilisé gratuitement dans les environnements qui ne sont pas destinés à l’exploitation. Pour des informations détaillées, reportez-vous à la section relative à l’utilisation de Java Flight Recorder pour diagnostiquer les problèmes d’exécution de CQ.
Fichier error.log
Experience Manager : vous pouvez consulter le fichier error.log
Experience Manager pour obtenir plus de détails sur les erreurs enregistrées par le système. Utilisez la commande tail -F quickstart/logs/error.log
pour identifier les erreurs à étudier.
Console d’administration des workflow : utilisez la console d’administration des workflow pour suivre les workflow en retard ou bloqués.
Ces outils vous permettent d’obtenir une vue globale des performances de votre déploiement Experience Manager.
Il s’agit d’outils standard qui ne sont pas pris en charge directement par Adobe. En outre, ils ne requièrent pas de licences supplémentaires.
Image : surveillance en direct à l’aide de l’outil Visual VM.
La surveillance à long terme d’une instance consiste à surveiller pendant une longue période les mêmes portions de l’instance Experience Manager que vous avez surveillées en temps réel. Cela implique également de définir des alertes spécifiques à votre environnement.
Plusieurs outils sont disponibles pour l’agrégation des journaux, par exemple, Splunk™ et Elastic Search, Logstash et Kabana (ELK). Pour évaluer la disponibilité de votre déploiement Experience Manager, il est important de comprendre les événements de journal spécifiques à votre système et de créer des alertes basées sur ces événements. Une bonne connaissance de votre développement et des pratiques opérationnelles peut vous aider à mieux comprendre comment adapter le processus d’agrégation des journaux pour générer des alertes critiques.
La surveillance de l’environnement implique de surveiller les éléments suivants :
Des outils externes sont nécessaires, par exemple NewRelic™ et AppDynamics™ pour la surveillance de chaque élément. Vous pouvez, avec ces outils, définir des alertes spécifiques à votre système, par exemple, en cas d’utilisation intensive du système, pour la sauvegarde des workflow, en cas d’échec des contrôles de l’intégrité ou d’accès non authentifiés à votre site web. Adobe ne recommande pas un outil plutôt qu’un autre. Choisissez l’outil qui correspond le plus à vos besoins et utilisez-le pour la surveillance des éléments indiqués ici.
La surveillance des applications internes consiste à surveiller les composants d’application qui constituent la pile Experience Manager, notamment JVM et le référentiel de contenu. Elle inclut également la surveillance via le code d’application personnalisé intégré à la plateforme. En général, elle se fait via les MBeans JMX qui peuvent être contrôlés directement par de nombreuses et solutions de contrôle populaires telles que SolarWinds ™, HP OpenView™, Hyperic™, Zabbix™ et bien d’autres encore. Pour les systèmes ne prenant pas en charge une connexion directe avec JMX, vous pouvez écrire des scripts shell pour extraire les données JMX et les présenter à ces systèmes dans un format intelligible pour eux.
Par défaut, l’accès à distance aux JMX MBeans n’est pas activé. Pour plus d’informations sur la surveillance via JMX, reportez-vous à la section Surveillance et gestion à l’aide de la technologie JMX.
Souvent, il faut une valeur de référence pour que la surveillance des statistiques soit efficace. Pour créer une valeur de référence, observez le système dans des conditions de fonctionnement normales pendant une période de temps prédéfinie, puis identifiez la mesure normale.
Surveillance JVM
Comme toutes les piles d’application basées sur Java, Experience Manager dépend des ressources qui lui sont fournies via la machine virtuelle Java sous-jacente. Vous pouvez suivre l’état de ces ressources via les MXBeans de plateforme présentés par JVM. Pour plus d’informations sur les MXBeans, reportez-vous à la section Utilisation du serveur MBean de plateforme et des MXBeans de plateforme.
Voici quelques paramètres de référence que vous pouvez surveiller pour JVM :
Mémoire
MBean: lava.lang:type=Memory
/system/console/jmx/java.lang:type=Memory
Les informations fournies par ce bean sont exprimées en octets.
Threads
java.lang:type=Threading
/system/console/jmx/java.lang:type=Threading
SurveillerExperience Manager
Experience Manager présente également un ensemble de statistiques et d’opérations via JMX. Elles peuvent vous aider à évaluer l’état de santé du système et à identifier les éventuels problèmes avant qu’ils n’affectent les utilisateurs. Pour plus d’informations, reportez-vous à la documentation sur les JMX MBeans d’Experience Manager.
Voici quelques paramètres de référence que vous pouvez surveiller pour Experience Manager :
Agents de réplication
MBean : com.adobe.granite.replication:type=agent,id="<AGENT_NAME>"
URL : /system/console/jmx/com.adobe.granite.replication:type=agent,id="<AGENT_NAME>"
Instances : un auteur et toutes les instances de publication (pour les agents de purge)
Seuil d’alarme : lorsque QueueBlocked
a la valeur true
ou lorsque la valeur de QueueNumEntries
est supérieure de 150 % à la valeur de référence.
Définition de l’alarme : une file d’attente est bloquée dans le système, indiquant que la cible de réplication n’est pas active ou qu’elle est hors d’atteinte. Très souvent, les problèmes d’infrastructure ou de réseau provoquent la mise en attente d’un nombre excessif d’entrées, ce qui peut affecter les performances du système.
Pour les paramètres d’URL et MBean, remplacez <AGENT_NAME>
par le nom de l’agent de réplication que vous voulez surveiller.
Décompte du nombre de sessions
org.apache.jackrabbit.oak:id=7,name="OakRepository Statistics",type="RepositoryStats"
Contrôles de l’intégrité
Les contrôles de l’intégrité disponibles dans le tableau de bord des opérations ont des MBeans JMX correspondants pour la surveillance. Vous pouvez toutefois créer des contrôles personnalisés pour disposer de statistiques supplémentaires sur le système.
Voici plusieurs contrôles de l’intégrité prêts à l’emploi qui pourront vous être utiles :
Contrôles système
org.apache.sling.healthcheck:name=systemchecks,type=HealthCheck
/system/console/jmx/org.apache.sling.healthcheck:name=systemchecks,type=HealthCheck
File d’attente de réplication
org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck
/system/console/jmx/org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck
Performances des réponses
org.apache.sling.healthcheck:name=requestsStatus,type=HealthCheck
/system/console/jmx/org.apache.sling.healthcheck:name=requestsStatus,type=HealthCheck
Performances des requêtes
org.apache.sling.healthcheck:name=queriesStatus,type=HealthCheck
/system/console/jmx/org.apache.sling.healthcheck:name= queriesStatus,type=HealthCheck
Lots actifs
org.apache.sling.healthcheck:name=inactiveBundles,type=HealthCheck
/system/console/jmx/org.apache.sling.healthcheck:name=inactiveBundles,type=HealthCheck
Erreurs de journal
org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck
/system/console/jmx/org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck
Si vous rencontrez des problèmes lors du processus de surveillance, voici quelques solutions permettant de résoudre les problèmes courants des déploiement Experience Manager :
Si vous utilisez TarMK, exécutez souvent la compression Tar. Pour plus d’informations, consultez Maintien du référentiel.
Vérifiez les journaux OutOfMemoryError
. Pour plus d’informations, reportez-vous à Analyse des problèmes de mémoire.
Consultez les journaux pour vérifier les références aux requêtes non indexées, ou aux parcours d’arborescence ou d’index. Ils signalent les requêtes non indexées ou indexées de façon inappropriée. Pour connaître les bonnes pratiques en matière d’optimisation des performances des requêtes et de l’indexation, reportez-vous à la section Bonnes pratiques relatives aux requêtes et à l’indexation.
Utilisez la console d’administration des workflow pour vérifier que vos workflow se comportent comme prévu. Si possible, regroupez plusieurs workflow en un seul.
Revoyez la surveillance en temps réel et recherchez toute congestion supplémentaire ou recherchez les processus fortement consommateurs de certaines ressources spécifiques.
Vérifiez les points de sortie du réseau client et les points d’entrée au réseau de déploiement d’Experience Manager, Dispatcher compris. Ce sont souvent des zones de congestion. Pour plus d’informations, reportez-vous à la section Considérations relatives aux ressources réseau.
Augmentez la taille de votre serveur Experience Manager. Il est possible que la capacité de votre déploiement d’Experience Manager ne soit pas adaptée. L’assistance clientèle d’Adobe peut vous aider à déterminer si votre serveur est sous-dimensionné.
Consultez les fichiers access.log
et error.log
pour trouver les entrées situées autour du moment où le problème est survenu. Recherchez des indices susceptibles d’indiquer la présence d’anomalies au niveau du code personnalisé. Ajoutez-les à la liste d’événements à surveiller.