Surveiller les ressources de serveur à l’aide de la console JMX monitoring-server-resources-using-the-jmx-console

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.

La console JMX permet de surveiller et de gérer des services sur le serveur CRX. Les sections suivantes récapitulent les attributs et les opérations exposés par le biais de la structure JMX.

Pour plus d’informations sur l’utilisation des commandes de la console, consultez la section Utilisation de la console JMX. Pour obtenir des informations d’ordre général sur JMX, consultez la page Technologie Java Management Extensions (JMX) (en anglais) sur le site web d’Oracle.

Pour plus d’informations sur la création de MBeans pour gérer vos services à l’aide de la console JMX, voir Intégration de services à la console JMX.

Maintenance des workflows workflow-maintenance

Opérations d’administration des instances de workflow en cours d’exécution, terminées, obsolètes et ayant échoué.

  • Domaine : com.adobe.granite.workflow
  • Type : Maintenance
NOTE
Voir console de workflow pour accéder à d’autres outils d’administration de workflow et à des descriptions des états d’instance de workflow possibles.

Opérations operations

listRunningWorkflowsPerModel Indique le nombre d’instances de workflows exécutées pour chaque modèle de workflow.

  • Arguments : none
  • Valeur renvoyée : Données tabulaires contenant les colonnes Count et ModelId.

listCompletedWorkflowsPerModel Indique le nombre d’instances de workflows terminées pour chaque modèle de workflow.

  • Arguments : none
  • Valeur renvoyée : Données tabulaires contenant les colonnes Count et ModelId.

returnWorkflowQueueInfo Répertorie les informations sur les éléments de workflows traités et mis en file d’attente pour le traitement.

  • Arguments : none

  • Valeur renvoyée : Données tabulaires contenant les colonnes suivantes :

    • Tâches
    • Nom de la file d’attente
    • Activer les tâches
    • Temps de traitement moyen
    • Temps d’attente moyen
    • Tâches annulées
    • Tâches en échec
    • Tâches terminées
    • Tâches traitées
    • Tâches en file d’attente

returnWorkflowJobTopicInfo Répertorie les informations de traitement des tâches de workflow, organisées par rubrique.

  • Arguments : none

  • Valeur renvoyée : Données tabulaires contenant les colonnes suivantes :

    • Nom de la rubrique
    • Temps de traitement moyen
    • Temps d’attente moyen
    • Tâches annulées
    • Tâches en échec
    • Tâches terminées
    • Tâches traitées

returnFailedWorkflowCount Affiche le nombre d’instances de workflow ayant échoué. Vous pouvez spécifier un modèle de workflow pour interroger ou extraire les informations pour tous les modèles de workflow.

  • Arguments :

    • Modèle : ID du modèle à interroger. Pour afficher le nombre d’instances de workflows ayant échoué pour tous les modèles de workflows, ne spécifiez aucune valeur. L’ID est le chemin d’accès au nœud de modèle, par exemple :

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Valeur renvoyée : nombre d’instances de workflow ayant échoué.

returnFailedWorkflowCountPerModel Affiche le nombre d’instances de workflow ayant échoué pour chaque modèle de workflow.

  • Arguments : aucun.
  • Valeur renvoyée : Données tabulaires contenant les colonnes Nombre et ID de modèle.

terminateFailedInstances Interrompt les instances de workflow ayant échoué. Vous pouvez interrompre toutes les instances ayant échoué ou uniquement les instances ayant échoué pour un modèle spécifique. Vous avez la possibilité de redémarrer les instances après les avoir interrompues. Vous pouvez également tester l’opération pour afficher les résultats sans effectuer réellement l’opération.

  • Arguments :

    • Redémarrez l’instance : (facultatif) spécifiez la valeur true pour redémarrer les instances après les avoir interrompues. La valeur par défaut false n’entraîne pas le redémarrage des instances de workflow interrompues.

    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.

    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances ayant échoué de tous les modèles de workflows. L’ID est le chemin d’accès au nœud de modèle, par exemple :

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Valeur renvoyée : Données sous forme de tableau concernant les instances interrompues, contenant les colonnes suivantes :

    • Initiateur
    • InstanceId
    • ModelId
    • Payload
    • StartComment
    • WorkflowTitle

retryFailedWorkItems Tente d’exécuter les étapes d’une tâche ayant échoué. Vous pouvez tenter de réexécuter toutes les tâches ayant échoué ou seulement les tâches ayant échoué pour un modèle de workflow spécifique. Vous avez la possibilité de tester l’opération pour afficher les résultats sans effectuer réellement l’opération.

  • Arguments :

    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.

    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux tâches ayant échoué pour tous les modèles de workflows. L’ID est le chemin d’accès au nœud de modèle, par exemple :

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Valeur renvoyée : Données tabulaires sur les tâches ayant échoué et qui ont été reprises, notamment les colonnes suivantes :

    • Initiateur
    • InstanceId
    • ModelId
    • Payload
    • StartComment
    • WorkflowTitle

PurgeActive Supprime les instances de workflows actives d’une ancienneté déterminée. Vous pouvez purger des instances actives pour tous les modèles ou pour un modèle spécifique seulement. Vous avez la possibilité de tester l’opération pour afficher les résultats sans effectuer réellement l’opération.

  • Arguments :

    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances de workflows de tous les modèles de workflows. L’ID est le chemin d’accès au nœud de modèle, par exemple :

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

    • Nombre de jours écoulés depuis le début du workflow : ancienneté des instances de workflows à purger, exprimée en jours.

    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.

  • Valeur renvoyée : Données tabulaires sur les principales instances de workflow purgées, y compris les colonnes suivantes :

    • Initiateur
    • InstanceId
    • ModelId
    • Payload
    • StartComment
    • WorkflowTitle

countStaleWorkflows Renvoie le nombre d’instances de workflows obsolètes. Vous pouvez récupérer le nombre d’instances obsolètes pour tous les modèles de workflow ou pour un modèle spécifique.

  • Arguments :

    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances de workflows de tous les modèles de workflows. L’ID est le chemin d’accès au nœud de modèle, par exemple :

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Valeur renvoyée : nombre d’instances de workflows obsolètes.

restartStaleWorkflows Redémarrez les instances de workflows obsolètes. Vous pouvez redémarrer toutes les instances obsolètes ou seulement les instances obsolètes pour un modèle spécifique. Vous pouvez également tester l’opération pour afficher les résultats sans effectuer réellement l’opération.

  • Arguments :

    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances obsolètes de tous les modèles de workflows. L’ID est le chemin d’accès au nœud de modèle, par exemple :

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.

  • Valeur renvoyée : une liste d’instances de workflows redémarrées.

fetchModelList Répertorie tous les modèles de workflows.

  • Arguments : none
  • Valeur renvoyée : Données tabulaires qui identifient les modèles de workflow, y compris les colonnes ModelId et ModelName .

countRunningWorkflows Renvoie le nombre d’instances de workflows en cours d’exécution. Vous pouvez récupérer le nombre d’instances en cours d’exécution pour tous les modèles de workflow ou pour un modèle spécifique.

  • Arguments :

    • Modèle : (facultatif) ID du modèle pour lequel le nombre d’instances exécutées est renvoyé. Ne spécifiez aucun modèle pour renvoyer le nombre d’instances exécutées pour tous les modèles de workflows. L’ID est le chemin d’accès au nœud de modèle, par exemple :

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Valeur renvoyée : nombre d’instances de workflows en cours d’exécution.

countCompletedWorkflows Renvoie le nombre d’instances de workflows terminées. Vous pouvez récupérer le nombre d’instances terminées pour tous les modèles de workflow ou pour un modèle spécifique.

  • Arguments :

    • Modèle : (facultatif) ID du modèle pour lequel le nombre d’instances terminées est renvoyé. Ne spécifiez aucun modèle pour renvoyer le nombre d’instances terminées pour tous les modèles de workflows. L’ID est le chemin d’accès au nœud de modèle, par exemple :

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Valeur renvoyée : nombre d’instances de workflows terminées.

purgeCompleted Supprime du référentiel les enregistrements des workflows terminés disposant d’une ancienneté spécifique. Utilisez régulièrement cette opération pour réduire la taille du référentiel lorsque vous utilisez intensivement des workflows. Vous pouvez purger les instances terminées pour tous les modèles ou pour un modèle spécifique seulement. Vous avez la possibilité de tester l’opération pour afficher les résultats sans effectuer réellement l’opération.

  • Arguments :

    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances de workflows de tous les modèles de workflows. L’ID est le chemin d’accès au nœud de modèle, par exemple :

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

    • Nombre de jours écoulés depuis la fin du workflow : nombre de jours pendant lesquels les instances de workflows ont eu le statut Terminé.

    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.

  • Valeur renvoyée : Données tabulaires sur les instances de workflow terminées purgées, y compris les colonnes suivantes :

    • Initiateur
    • InstanceId
    • ModelId
    • Payload
    • StartComment
    • WorkflowTitle

Référentiel repository

Informations sur le référentiel CRX

  • Domaine : com.adobe.granite
  • Type : Référentiel

Attributs attributes

Name Nom de la mise en œuvre du référentiel JCR. Lecture seule.

Version Version de la mise en œuvre du référentiel. Lecture seule.

HomeDir Répertoire dans lequel se trouve le référentiel. L’emplacement par défaut est <QuickStart_Jar_Location>/crx-quickstart/repository. Lecture seule.

CustomerName Nom du client pour lequel la licence du logiciel est émise. Lecture seule.

LicenseKey Clé de licence unique pour cette installation du référentiel. Lecture seule.

AvailableDiskSpace Espace disque disponible pour cette instance du référentiel, en mégaoctets (Mo). Lecture seule.

MaximumNumberOfOpenFiles Nombre de fichiers pouvant être ouverts simultanément. Lecture seule.

SessionTracker Valeur de la variable système crx.debug.sessions. La valeur true indique une session de débogage. La valeur false indique une session normale. Lecture/écriture.

Descriptors Ensemble de paires clé-valeur, qui représentent les propriétés du référentiel. Toutes les propriétés sont en lecture seule.

Clé
Valeur
option.node.and.property.with.same.name.supported
Indique si un nœud et une propriété du nœud peuvent porter le même nom. La valeur true indique que les mêmes noms sont pris en charge, la valeur false indique qu’il n’est pas pris en charge.
identifier.stability

Indique la stabilité des identifiants de nœud non référençables. Les valeurs possibles sont les suivantes :

  • identifier.stability.indefined.duration : Les identifiants ne changent pas.
  • identifier.stability.method.duration : Les identifiants peuvent changer entre les appels de méthode.
  • identifier.stability.save.duration : Les identifiants ne changent pas au cours d’un cycle d’enregistrement/actualisation.
  • identifier.stable.session.duration: Les identifiants ne changent pas au cours d’une session.
query.xpath.pos.index
Indique si le langage de requête XPath JCR 1.0 est pris en charge. La valeur true indique la prise en charge et la valeur false indique l’absence de prise en charge.
crx.repository.systemid
Identifiant système tel qu’il se trouve dans le fichier system.id.
option.query.sql.supported
Indique si le langage de requête XPath JCR 1.0 est pris en charge. La valeur true indique la prise en charge et la valeur false indique l’absence de prise en charge.
jcr.repository.version
Version de l’implémentation du référentiel.
option.update.primary.node.type.supported
Indique si le type de nœud principal d’un nœud peut être modifié. La valeur true indique que vous pouvez modifier le type de noeud Principal et la valeur false indique que la modification n’est pas prise en charge.
option.node.type.management.supported
Indique si la gestion du type de nœud est prise en charge. La valeur true indique qu’elle est prise en charge et la valeur false indique qu’elle ne l’est pas.
node.type.management.overrides.supported
Indique si vous pouvez remplacer la propriété héritée ou la définition de nœud enfant d’un type de nœud. La valeur true indique que les remplacements sont pris en charge et la valeur false indique qu’aucun remplacement n’est effectué.
option.observation.supported
La valeur true indique que l’observation asynchrone des modifications apportées au référentiel est prise en charge. La prise en charge de l’observation asynchrone permet aux applications de recevoir et de répondre aux notifications de chaque modification au fur et à mesure.
query.jcrscore
La valeur true indique que la pseudo-propriété jcr:score est disponible dans les requêtes XPath et SQL, qui comportent une fonction jcrfn:contains (dans XPath) ou CONTAINS (dans SQL) pour effectuer une recherche en texte intégral.
option.simple.versioning.supported
La valeur true indique que le référentiel prend en charge le contrôle de version simple. Avec le contrôle de version simple, le référentiel conserve une série séquentielle de versions d’un noeud.
option.workspace.management.supported
La valeur true indique que le référentiel prend en charge la création et la suppression d’espaces de travail à l’aide d’API.
option.update.mixin.node.types.supported
La valeur true indique que le référentiel prend en charge l’ajout et la suppression de types de noeuds mixin d’un noeud existant.
node.type.management.primary.item.name.supported
La valeur true indique que le référentiel permet aux définitions de nœud de contenir un élément principal en tant qu’enfant. Un élément Principal est accessible à l’aide de l’API sans connaître le nom de l’élément.
level.2.supported
La valeur true indique que LEVEL_1_SUPPORTED et OPTION_XML_IMPORT_SUPPORTED sont tous deux vrais.
write.supported
La valeur true indique que le référentiel fournit un accès en écriture à l’aide de l’API. false indique un accès en lecture seule.
node.type.management.update.in.use.supported
La valeur true indique que vous pouvez modifier les définitions de noeud utilisées par les noeuds existants.
jcr.specification.version
Version de la spécification JCR mise en oeuvre par le référentiel.
option.journaled.observation.supported
La valeur true indique que les applications peuvent effectuer une observation journalisée du référentiel. avec l’observation journalisée, un ensemble de notifications de modification peut être obtenu pendant une période spécifique.
query.languages
Langages de requête pris en charge par le référentiel. Aucune valeur n’indique qu’aucune requête n’est prise en charge.
option.xml.export.supported
La valeur true indique que le référentiel prend en charge l’exportation de noeuds en tant que code XML.
node.type.management.multiple.binary.properties.supported
La valeur true indique que le référentiel prend en charge l’enregistrement des types de nœuds comportant plusieurs propriétés de fichier binaire. La valeur false indique qu’une seule propriété binaire est prise en charge pour un type de noeud.
option.access.control.supported
La valeur true indique que le référentiel prend en charge le contrôle d’accès pour définir et déterminer les privilèges d’utilisateur pour l’accès aux noeuds.
option.baselines.supported
La valeur true indique que le référentiel prend en charge les configurations et les lignes de base.
option.shareable.nodes.supported
La valeur true indique que le référentiel prend en charge la création de noeuds partageables.
crx.cluster.id
Identifiant de la grappe de référentiel.
query.stored.queries.supported
La valeur true indique que le référentiel prend en charge les requêtes stockées.
query.full.text.search.supported
La valeur true indique que le référentiel prend en charge la recherche de texte intégral.
node.type.management.inheritance

Indique le niveau de prise en charge du référentiel pour l’héritage du type de nœud. Les valeurs possibles sont les suivantes :

node.type.management.inheritance.minimal : l’enregistrement des types de nœuds principaux se limite aux types qui contiennent uniquement le supertype nt:base. L’enregistrement des types de noeuds mixin est limité aux types sans supertype.

node.type.management.inheritance.single : l’enregistrement des types de nœuds principaux se limite aux types comportant un seul supertype. L’enregistrement des types de nœuds Mixin se limite aux types comportant un supertype au maximum.

node.type.management.inheritance.multiple : les types de nœuds principaux peuvent être enregistrés avec un ou plusieurs supertypes. Les types de noeuds Mixin peuvent être enregistrés avec aucun ou plusieurs supertypes.

crx.cluster.preferredMaster
La valeur true indique que ce noeud de grappe est le maître préféré de la grappe.
option.transactions.supported
La valeur true indique que le référentiel prend en charge les transactions.
jcr.repository.vendor.url
URL du fournisseur du référentiel.
node.type.management.value.constraints.supported
La valeur true indique que le référentiel prend en charge les contraintes de valeur pour les propriétés de noeud.
node.type.management.property.types
Tableau de constantes javax.jcr.PropertyType, qui représentent les types de propriétés qu’un type de nœud enregistré peut spécifier. Un tableau dont la longueur est égale à zéro indique que les types de nœuds enregistrés ne peuvent pas spécifier de définitions de propriétés. Les types de propriétés sont STRING, URI, BOOLEAN, LONG, DOUBLE, DECIMAL, BINARY, DATE, NAME, PATH, WEAKREFERENCE, REFERENCE et UNDEFINED (s’ils sont pris en charge).
node.type.management.orderable.child.nodes.supported
La valeur true indique que le référentiel prend en charge la conservation de l’ordre des noeuds enfants.
jcr.repository.vendor
Nom du fournisseur du référentiel.
query.joins

Niveau de prise en charge des jointures dans les requêtes. Les valeurs possibles sont les suivantes :

  • query.joins.none : jointures non prises en charge. Les requêtes peuvent utiliser un seul sélecteur.
  • query.joins.inner : Prise en charge des jointures internes.
  • query.joins.inner.outer: Prise en charge des jointures internes et externes.
org.apache.jackrabbit.spi.commons.AdditionalEventInfo
query.xpath.doc.order
La valeur true indique que le référentiel prend en charge le langage de requête XPath 1.0.
query.jcrpath
option.xml.import.supported
La valeur true indique que le référentiel prend en charge l’importation du code XML en tant que contenu.
node.type.management.same.name.siblings.supported
La valeur true indique que le référentiel prend en charge les noeuds frères (noeuds ayant le même parent) portant le même nom.
node.type.management.residual.definitions.supported
La valeur true indique que le référentiel prend en charge les propriétés de nom avec des définitions résiduelles. Lorsqu’il est pris en charge, l’attribut name d’une définition d’élément peut être un astérisque ("*").
node.type.management.autocreated.definitions.supported
La valeur true indique que le référentiel prend en charge la création automatique d’éléments enfants (noeuds ou propriétés) d’un noeud lors de sa création.
crx.cluster.master
La valeur true indique que ce noeud de référentiel est le noeud maître de la grappe.
level.1.supported
La valeur true indique que option.xml.export.support est true et que query.languages a une longueur non nulle.
option.unfiled.content.supported
La valeur true indique que le référentiel prend en charge le contenu non classé. Les noeuds non classés ne font pas partie de la hiérarchie du référentiel.
jcr.specification.name
Nom de la spécification JCR mise en oeuvre par le référentiel.
option.versioning.supported
La valeur true indique que le référentiel prend en charge le contrôle de version complet.
jcr.repository.name
Nom du référentiel.
option.locking.supported
La valeur true indique que le référentiel prend en charge le verrouillage des nœuds. Le verrouillage permet à un utilisateur d’empêcher temporairement d’autres utilisateurs d’apporter des modifications.
jcr.repository.version.display
option.activities.supported
La valeur true indique que le référentiel prend en charge des activités. Les activités sont un ensemble de modifications apportées à un espace de travail, qui sont fusionnées dans un autre espace de travail.
node.type.management.multivalued.properties.supported
La valeur true indique que le référentiel prend en charge les propriétés de noeud qui peuvent comporter aucune ou plusieurs valeurs.
option.retention.supported
La valeur true indique que le référentiel prend en charge l’utilisation d’applications de gestion de la rétention externes pour appliquer des stratégies de rétention au contenu et prend en charge la rétention et la mise à jour.
option.lifecycle.supported
La valeur true indique que le référentiel prend en charge la gestion du cycle de vie.

WorkspaceNames Nom des espaces de travail dans le référentiel. Lecture seule.

DataStoreGarbageCollectionDelay Délai, en millisecondes, pendant lequel le nettoyage est mis en veille après l’analyse de chaque dixième nœud. Lecture/écriture.

BackupDelay Délai, en millisecondes, pendant lequel le processus de sauvegarde est mis en veille entre chaque étape de la sauvegarde. Lecture/écriture.

BackupInProgress Une valeur true indique qu’un processus de sauvegarde est en cours d’exécution. Lecture seule.

BackupProgress Pour la sauvegarde actuelle, pourcentage de tous les fichiers sauvegardés. Lecture seule.

CurrentBackupTarget Pour la sauvegarde actuelle, fichier ZIP dans lequel les fichiers de sauvegarde sont enregistrés. Lorsqu’il n’y a pas de sauvegarde en cours, aucune valeur ne s’affiche. Lecture seule.

BackupWasSuccessful La valeur true indique qu’aucune erreur ne s’est produite lors de la sauvegarde actuelle ou qu’aucune sauvegarde n’est en cours. La valeur false indique qu’une erreur s’est produite lors de la sauvegarde actuelle. Lecture seule.

BackupResult Statut de la sauvegarde actuelle. Les valeurs possibles sont les suivantes :

  • Sauvegarde en cours : Une sauvegarde est en cours d’exécution.
  • Sauvegarde annulée : La sauvegarde a été annulée.
  • Sauvegarde terminée avec une erreur : une erreur s’est produite lors de la sauvegarde. Le message d’erreur fournit des informations sur la cause.
  • Sauvegarde terminée : La sauvegarde a réussi.
  • Aucune sauvegarde exécutée jusqu'à présent : Aucune sauvegarde n’est en cours.

Lecture seule.

TarOptimizationRunningSince Heure à laquelle le processus d’optimisation actuel du fichier TAR a commencé. Lecture seule.

TarOptimizationDelay Délai, en millisecondes, pendant lequel le processus d’optimisation du fichier TAR est mis en veille entre chaque étape du processus. Lecture/écriture.

ClusterProperties Ensemble de paires clé-valeur, qui représente les propriétés et les valeurs du cluster. Chaque ligne du tableau représente une propriété du cluster. Lecture seule.

ClusterNodes Membres du cluster de référentiel.

ClusterId Identifiant de ce cluster de référentiel. Lecture seule.

ClusterMasterId Identifiant du nœud maître de ce cluster de référentiel. Lecture seule.

ClusterNodeId Identifiant de ce nœud du cluster de référentiel. Lecture seule.

Opérations operations-1

createWorkspace Crée un espace de travail dans ce référentiel.

  • Arguments :

    • name: Une valeur String qui représente le nom du nouvel espace de travail.
  • Valeur renvoyée : aucune

runDataStoreGarbageCollection Exécute le nettoyage sur les nœuds du référentiel.

  • Arguments :

    • delete : valeur booléenne, qui indique si les éléments inutilisés du référentiel doivent être supprimés. La valeur true entraîne la suppression des nœuds et des propriétés inutilisés. La valeur false entraîne l’analyse de tous les noeuds, mais aucun n’est supprimé.
  • Valeur renvoyée : aucune

stopDataStoreGarbageCollection Arrête le nettoyage en cours d’un entrepôt de données.

  • Arguments : none
  • Valeur renvoyée : représentation sous forme de chaîne de l’état actuel

startBackup Sauvegarde les données du référentiel dans un fichier ZIP.

  • Arguments :

    • target : (facultatif) valeur de String, qui représente le nom du fichier ZIP ou d’un répertoire dans lequel archiver les données du référentiel. Pour utiliser un fichier ZIP, incluez l’extension du nom de fichier ZIP. Pour utiliser un répertoire, n’incluez pas d’extension de nom de fichier.

      Pour effectuer une sauvegarde incrémentielle, spécifiez le répertoire qui a déjà été utilisé pour la sauvegarde.

      Vous pouvez spécifier un chemin d’accès absolu ou relatif. Les chemins d’accès relatifs le sont par rapport au parent du répertoire crx-quickstart.

      Lorsque vous ne spécifiez aucune valeur, la valeur par défaut backup-currentdate.zip est utilisée, où currentdate est au format yyyyMMdd-HHmm.

  • Valeur renvoyée : aucune

cancelBackup Arrête le processus de sauvegarde en cours et supprime l’archive temporaire créée par le processus pour archiver les données.

  • Arguments : none
  • Valeur renvoyée : aucune

blockRepositoryWrites Empêche d’apporter des modifications aux données du référentiel. Tous les écouteurs de sauvegarde du référentiel sont informés du bloc.

  • Arguments : none
  • Valeur renvoyée : aucune

unblockRepositoryWrites Supprime le blocage du référentiel. Tous les écouteurs de sauvegarde du référentiel sont informés de la suppression du bloc.

  • Arguments : none
  • Valeur renvoyée : aucune

startTarOptimization Commence le processus d’optimisation du fichier TAR à l’aide de la valeur par défaut pour tarOptimizationDelay.

  • Arguments : none
  • Valeur renvoyée : aucune

stopTarOptimization Interrompt l’optimisation du fichier TAR.

  • Arguments : none
  • Valeur renvoyée : aucune

tarIndexMerge Fusionne les fichiers d’index de niveau supérieur de tous les ensembles TAR. Les fichiers d’index de niveau supérieur sont des fichiers comportant des versions principales différentes. Par exemple, les fichiers ci-dessous sont fusionnés dans le fichier file index_3_1.tar: index_1_1.tar, index_2_0.tar, index_3_0.tar. Les fichiers fusionnés sont supprimés (dans l’exemple précédent, index_1_1.tar, index_2_0.taret index_3_0.tar sont supprimés).

  • Arguments :

    • background : valeur booléenne, qui indique si l’opération doit être exécutée en arrière-plan afin que la console web soit utilisable lors de l’exécution. La valeur true exécute l’opération en arrière-plan.
  • Valeur renvoyée : aucune

becomeClusterMaster Définit ce nœud de référentiel comme nœud maître du cluster. S’il n’est pas déjà le nœud principal, cette commande arrête le programme d’écoute de l’instance principale actuelle et démarre un programme d’écoute sur le nœud actuel. Ce nœud est ensuite défini comme nœud principal et redémarre, ce qui fait que tous les autres nœuds du cluster (c’est-à-dire ceux qui sont contrôlés par le nœud principal) se connectent à cette instance.

  • Arguments : none
  • Valeur renvoyée : aucune

joinCluster Ajoute ce référentiel à un cluster en tant que nœud contrôlé par le nœud principal du cluster. Vous devez fournir un nom d’utilisateur et un mot de passe pour l’authentification. La connexion utilise l’authentification de base. Les informations d’identification de sécurité sont codées en base 64 avant d’être envoyées au serveur.

  • Arguments :

    • master : valeur de chaîne, qui représente l’adresse IP ou le nom de l’ordinateur qui exécute le nœud de référentiel principal.
    • username : nom à utiliser pour l’authentification au niveau du cluster.
    • password : mot de passe à utiliser pour l’authentification.
  • Valeur renvoyée : aucune

traversalCheck Parcourt et corrige, éventuellement, les incohérences d’une sous-arborescence, en commençant par un nœud spécifique. Cet aspect est abordé en détail dans la documentation sur les gestionnaires de persistance.

consistencyCheck Vérifie et corrige, éventuellement, les incohérences dans l’entrepôt de données. Cet aspect est abordé en détail dans la documentation sur l’entrepôt de données.

Statistiques du référentiel (TimeSeries) repository-statistics-timeseries

Valeur du champ TimeSeries pour chaque type de statistiques défini par org.apache.jackrabbit.api.stats.RepositoryStatistics.

  • Domaine : com.adobe.granite

  • Type : TimeSeries

  • Nom : l’une des valeurs ci-dessous de la classe d’énumération org.apache.jackrabbit.api.stats.RepositoryStatistics.Type :

    • BUNDLE_CACHE_ACCESS_COUNTER
    • BUNDLE_CACHE_MISS_AVERAGE
    • BUNDLE_CACHE_MISS_COUNTER
    • BUNDLE_CACHE_MISS_DURATION
    • BUNDLE_CACHE_SIZE_COUNTER
    • BUNDLE_COUNTER
    • BUNDLE_READ_COUNTER
    • BUNDLE_WRITE_AVERAGE
    • BUNDLE_WRITE_COUNTER
    • BUNDLE_WRITE_DURATION
    • BUNDLE_WS_SIZE_COUNTER
    • QUERY_AVERAGE
    • QUERY_COUNT
    • QUERY_DURATION
    • SESSION_COUNT
    • SESSION_LOGIN_COUNTER
    • SESSION_READ_AVERAGE
    • SESSION_READ_COUNTER
    • SESSION_READ_DURATION
    • SESSION_WRITE_AVERAGE
    • SESSION_WRITE_COUNTER
    • SESSION_WRITE_DURATION

Attributs attributes-1

Les attributs suivants sont fournis pour chaque type de statistique signalé :

  • ValuePerSecond : valeur mesurée par seconde au cours de la dernière minute. Lecture seule.
  • ValuePerMinute : valeur mesurée par minute au cours de la dernière heure. Lecture seule.
  • ValuePerHour : valeur mesurée par heure au cours de la dernière semaine. Lecture seule.
  • ValuePerWeek : valeur mesurée par semaine au cours des trois dernières années. Lecture seule.

Statistiques de requête du référentiel repository-query-stats

Informations statistiques sur les requêtes de référentiel.

  • Domaine : com.adobe.granite
  • Type : QueryStat

Attributs attributes-2

SlowQueries Informations sur les requêtes dans le référentiel qui ont pris le plus de temps. Lecture seule.

SlowQueriesQueueSize Nombre maximal de requêtes à inclure dans la liste de SlowQueries. Lecture-écriture.

PopularQueries Informations sur les requêtes dans le référentiel exécutées le plus souvent. Lecture seule.

PopularQueriesQueueSize Nombre maximal de requêtes dans la liste de PopularQueries. Lecture-écriture.

Opérations operations-2

clearSlowQueriesQueue Supprime toutes les requêtes de la liste SlowQueries.

  • Arguments : none
  • Valeur renvoyée : aucune

clearPopularQueriesQueue Supprime toutes les requêtes de la liste PopularQueries.

  • Arguments : none
  • Valeur renvoyée : aucune

Agents de réplication replication-agents

Surveillez les services pour chaque agent de réplication. Lorsque vous créez un agent de réplication, le service s’affiche automatiquement dans la console JMX.

  • Domaine  : com.adobe.granite.replication
  • Type  : agent
  • Nom  : aucune valeur
  • Propriétés  : {id="Name"}, où Name est la valeur de la propriété Name de l’agent.

Attributs attributes-3

Id Valeur de chaîne qui représente l’identifiant de la configuration de l’agent de réplication. Plusieurs agents peuvent utiliser la même configuration. Lecture seule.

Valid Valeur booléenne qui indique si l’agent est configuré correctement :

  • true : configuration valide.
  • false : la configuration contient des erreurs.

Lecture seule.

Enabled Valeur booléenne qui indique si l’agent est activé :

  • true : activé.
  • false : désactivé.

QueueBlocked Valeur booléenne qui indique si la file d’attente existe et si elle est bloquée :

  • true : bloquée. Une nouvelle tentative automatique est en attente.
  • false : non bloquée ou inexistante.

Lecture seule.

QueuePaused Valeur booléenne qui indique si la file d’attente de tâches est suspendue :

  • true : suspendue.
  • false : non suspendue ou inexistante.

Lecture-écriture.

QueueNumEntries Valeur d’entier (int) représentant le nombre de tâches dans la file d’attente de l’agent. Lecture seule.

QueueStatusTime Valeur Date indiquant le temps passé sur le serveur une fois que les valeurs de statut affichées ont été obtenues. La valeur correspond au délai de chargement de la page. Lecture seule.

QueueNextRetryTime Pour les files d’attente bloquées, valeur Date indiquant le moment auquel la tentative automatique suivante aura lieu. Lorsque aucun délai ne s’affiche, la file d’attente n’est pas bloquée. Lecture seule.

QueueProcessingSince Valeur Date indiquant le moment auquel le traitement a commencé pour la tâche actuelle. Lorsque aucun délai ne s’affiche, la file d’attente est bloquée ou inactive. Lecture seule.

QueueLastProcessTime Valeur Date indiquant le moment auquel la tâche précédente s’est terminée. Lecture seule.

Opérations operations-3

queueForceRetry Pour les files d’attente bloquées, exécute la commande retry dans la file d’attente.

  • Arguments : none
  • Valeur renvoyée : aucune

queueClear Supprime toutes les tâches de la file d’attente.

  • Arguments : none
  • Valeur renvoyée : aucune

Moteur Sling sling-engine

Fournit des statistiques sur les requêtes HTTP afin que vous puissiez surveiller les performances du service SlingRequestProcessor.

  • Domaine : org.apache.sling
  • Type : moteur
  • Propriétés :

Attributs attributes-4

RequestsCount Nombre de demandes exécutées depuis que les statistiques ont été réinitialisées pour la dernière fois.

MinRequestDurationMsec Délai le plus court (en millisecondes) nécessaire pour traiter une demande depuis que les statistiques ont été réinitialisées pour la dernière fois.

MaxRequestDuratioMsec Durée la plus longue (en millisecondes) nécessaire pour traiter une demande depuis que les statistiques ont été réinitialisées pour la dernière fois.

StandardDeviationDurationMsec Écart-type du délai nécessaire pour traiter des demandes. L’écart-type est calculé à l’aide de toutes les demandes depuis que les statistiques ont été réinitialisées pour la dernière fois.

MeanRequestDurationMsec Délai moyen nécessaire pour traiter une demande. La moyenne est calculée à l’aide de toutes les demandes depuis que les statistiques ont été réinitialisées pour la dernière fois.

Opérations operations-4

resetStatistics Définit toutes les statistiques sur zéro. Réinitialisez les statistiques lorsque vous devez analyser les performances de traitement des requêtes pendant une période spécifique.

  • Arguments : none
  • Valeur renvoyée : aucune

Gestionnaire de packages package-manager

Informations sur tous les modules contenus dans Package Manager.

  • Domaine : com.adobe.granite.packaging
  • Type : manager

Lanceur de démarrage rapide quickstart-launcher

Informations sur le processus de démarrage et le lanceur de démarrage rapide.

  • Domaine : com.adobe.granite.quickstart
  • Type : Lanceur

Opérations operations-5

log

Affiche un message dans la fenêtre QuickStart.

Arguments :

  • p1 : valeur de String représentant le message à afficher. L’illustration suivante montre le résultat de l’appel de log avec une valeur p1 de this is a log message.

launcheruilog

  • Valeur renvoyée : aucune

startupFinished

Appelle la méthode startupFinished du lanceur du serveur. La méthode tente d’ouvrir la page d’accueil dans un navigateur web.

  • Arguments : none
  • Valeur renvoyée : aucune

startupProgress

Définit la valeur de fin du processus de démarrage du serveur. La barre de progression de la fenêtre QuickStart représente la valeur de fin.

  • Arguments :

    • p1 : valeur flottante représentant la quantité du processus de démarrage terminée, sous forme de fraction. La valeur doit être comprise entre zéro et un. Par exemple, 0,3 indique que 30 % a terminé.
  • Valeur renvoyée : aucune.

launcherprogress

Services tiers third-party-services

Plusieurs ressources de serveur tiers installent des beans gérés (MBeans), qui exposent des attributs et des opérations dans la console JMX. Le tableau suivant répertorie les ressources tierces et fournit des liens vers d’autres informations.

Domaine
Type
Classe MBean
Mise en oeuvre JMI
MBeanServerDelegate
javax.management.MBeanServerDelegate
com.sun.management
HotSpotDiagnostic
com.sun.management.HotSpotDiagnosticMXBean
java.lang
  • ClassLoading
  • Compilation
  • GarbageCollector
  • Mémoire
  • MemoryManager
  • MemoryPool
  • OperatingSystem
  • Exécution
  • Thread
package javax.management
java.util.logging
java.util.logging.LoggingMXBean
osgi.core
  • bundleState
  • structure
  • packageState
  • serviceState
package org.osgi.jmx.framework

Utilisation de la console JMX using-the-jmx-console

La console JMX affiche des informations sur plusieurs services exécutés sur le serveur :

  • Attributs : propriétés de service, comme des configurations ou des données d’exécution. Les attributs peuvent être en lecture seule ou en lecture-écriture.
  • Opérations : Commandes que vous pouvez appeler sur le service.

Les MBeans déployés avec un service OSGi exposent les attributs et les opérations du service dans la console. Le MBean détermine les attributs et les opérations exposés et si les attributs sont en lecture seule ou en lecture/écriture.

La page principale de la console JMX comporte un tableau des services. Chaque ligne du tableau représente un service exposé par un MBean.

  1. Ouvrez la console web et cliquez sur l’onglet JMX . (http://localhost:4502/system/console/jmx)
  2. Cliquez sur une valeur de cellule pour un service afin d’afficher les attributs et les opérations du service.
  3. Pour modifier une valeur d’attribut, cliquez sur la valeur, spécifiez la valeur dans la boîte de dialogue qui s’affiche, puis cliquez sur Enregistrer.
  4. Pour appeler une opération de service, cliquez sur le nom de l’opération, spécifiez les valeurs d’argument dans la boîte de dialogue qui s’affiche, puis cliquez sur Invoquer.

Utilisation d’applications JMX externes pour la surveillance using-external-jmx-applications-for-monitoring

CRX permet aux applications externes d’interagir avec les beans gérés (MBeans) par le biais de Java Management Extensions (JMX). Utilisation de consoles génériques telles que JConsole pour les applications de surveillance spécifiques à un domaine, permet d’obtenir et de définir des configurations et des propriétés CRX, ainsi que de surveiller les performances et l’utilisation des ressources.

Utilisation de JConsole pour se connecter à CRX using-jconsole-to-connect-to-crx

Pour vous connecter à CRX à l’aide de JConsole, procédez comme suit :

  1. Ouvrez une fenêtre de terminal.

  2. Saisissez la commande suivante :

    jconsole

JConsole démarre et la fenêtre JConsole s’affiche.

Connexion à un processus CRX local connecting-to-a-local-crx-process

JConsole affiche une liste des processus locaux de machine virtuelle Java. La liste contient deux processus QuickStart. Sélectionnez le processus "ENFANT" de démarrage rapide dans la liste des processus locaux (généralement celui avec le PID supérieur).

screen_shot_2012-03-26at114557am

Connexion à un processus CRX distant connecting-to-a-remote-crx-process

Pour se connecter à un processus CRX distant, la JVM qui héberge le processus CRX distant doit être activée pour accepter les connexions JMX distantes.

Pour activer les connexions JMX à distance, la propriété système ci-dessous doit être définie au démarrage de la machine virtuelle Java :

com.sun.management.jmxremote.port=portNum

Dans la propriété ci-dessus, portNum correspond au numéro de port sur lequel vous souhaitez activer les connexions RMI JMX. Veillez à spécifier un numéro de port inutilisé. Outre la publication d’un connecteur RMI pour l’accès local, la définition de cette propriété publie un connecteur RMI supplémentaire dans un registre privé en lecture seule sur le port spécifié à l’aide d’un nom bien connu, "jmxrmi".

Par défaut, lorsque vous activez l’agent JMX pour la surveillance à distance, il utilise l’authentification par mot de passe basée sur un fichier de mot de passe qui doit être spécifié à l’aide de la propriété système suivante lors du démarrage de la machine virtuelle Java :

com.sun.management.jmxremote.password.file=pwFilePath

Pour obtenir des instructions détaillées sur la configuration d’un fichier de mot de passe, consultez la documentation JMX correspondante.

Exemple :

$ java
  -Dcom.sun.management.jmxremote.password.file=pwFilePath
  -Dcom.sun.management.jmxremote.port=8463
  -jar ./cq-quickstart.jar

Utilisation des MBeans fournis par CRX using-the-mbeans-provided-by-crx

Après la connexion au processus de démarrage rapide, JConsole fournit une gamme d’outils de surveillance généraux pour la JVM dans laquelle CRX est exécuté.

screen_shot_2012-03-26at115056am

Pour accéder aux options de surveillance et de configuration internes de CRX, cliquez sur l’onglet MBeans et, dans l’arborescence à gauche, sélectionnez la section Attributs ou Opérations qui vous intéresse. Par exemple, la section com.adobe.granite/Repository/Operations .

Dans cette section, sélectionnez l’attribut ou l’opération de votre choix dans le volet de gauche.

screen_shot_2012-03-26at115728am

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8