Zones caractéristiques des MBeans JMX (Java Management Extensions)

La syntaxe du nom de métrique d'un groupe d'attributs JMX doit respecter certaines règles lorsque cela est spécifié dans la fenêtre Informations d'attribut.

La syntaxe du nom de métrique d'un groupe d'attributs JMX est constituée de jetons séparés par un point. Les jetons forment des valeurs principales et, le cas échéant, des valeurs secondaires :
  • Valeur principale : valeur obtenue directement du MBean ou d'une notification dans une ligne donnée de la table. Les valeurs principales d'un MBean sont obtenues d'un attribut MBean ou de l'appel d'une opération MBean (appel de méthode). Les valeurs principales d'une notification sont obtenues d'une zone ou d'un appel d'une méthode sur l'objet Notification. Les valeurs principales peuvent être des types primitifs ou des objets Java™.
  • Valeur secondaire : valeur obtenue par le traitement supplémentaire d'une valeur principale ou d'une autre valeur secondaire. Les valeurs secondaires sont traitées en interne dans le moteur et n'impliquent pas d'appels émis au serveur JMX. Si la valeur principale (ou l'autre valeur secondaire) est un objet Java, une valeur secondaire est le résultat de l'extraction d'une zone publique à partir de cet objet. Une valeur secondaire peut également être le résultat d'un appel de méthode sur cet objet. Les valeurs secondaires sont obtenues à l'aide de l'introspection Java de l'objet Java principal (ou d'un autre objet Java secondaire). Si la valeur principale (ou l'autre valeur secondaire) est une chaîne Java sous la forme d'un nom de MBean, la valeur secondaire peut correspondre au domaine. La valeur secondaire peut également correspondre à l'une des propriétés composant le nom du MBean.
La syntaxe suivante décrit le format de la zone Nom de métrique : 
Metric Name	=	valeur_principale [ .valeur_secondaire ]
PrimaryValue	=	Attribute.nom_attribut |
		Method.nom_méthode |
		Domain |
		Property.nom_propriété |
		Field.nom_zone |
		Nom
SecondaryValue	=	Field.nom_zone |
		Method.nom_méthode |
		Domain |
		Property.nom_propriété |
		Explode |
		ElementCount
propertyName	=	nom d'une propriété de clé dans un nom d'objet MBean
attributeName	=	nom d'un attribut MBean
methodName	=	opération à zéro argument d'un MBean ou méthode à zéro argument d'une notification ou d'un autre objet Java. 
nom_méthode(argument) = Opération à argument unique d'un MBean ou méthode à
argument unique d'une notification ou d'un autre objet Java. La commande 
L'argument
sera transmis à la méthode sous la forme d'une chaîne.
fieldName	=	nom d'une variable d'instance publique dans une
            notification ou un autre objet Java
notificationMethod	=	nom d'une méthode publique à zéro argument d'un
                     objet Notification
En insérant uniquement une valeur principale dans la définition de nom de métrique, les données collectées peuvent correspondre à l'un des éléments suivants :
  • Domaine de MBean
  • Valeur de chaîne du MBean
  • Propriété de clé issue du nom du MBean
  • Valeur d'attribut numérique ou de type chaîne dans un attribut d'un MBean (y compris le nom complet d'un autre MBean). Une valeur de retour de type chaîne ou numérique à partir d'une opération d'un MBean.
  • Valeur d'une variable d'instance publique numérique ou de type chaîne dans un objet Notification
  • Valeur de retour numérique ou de type chaîne d'une opération d'une notification.

En ajoutant une valeur secondaire à définition d'une métrique, vous pouvez explorer en aval la valeur principale d'un objet Java. En outre, vous pouvez démarrer une méthode publique ou extraire une variable d'instance publique.

En ajoutant une valeur secondaire à une autre valeur secondaire dans la définition de la métrique, vous pouvez explorer en aval un objet de valeur secondaire. Vous pouvez continuer cette exploration en aval aussi loin que les objets sont imbriqués dans un MBean ou une notification.

Les jetons qui composent les valeurs principales ou secondaires sont des mots clés ou des noms. Dans la plupart des cas, un jeton de mot clé est suivi d'un jeton de nom. Le tableau suivant présente quelques exemples :
Exemple de nom d'unité de mesure Type de groupe d'attributs Description des données renvoyées
Domain MBean Partie domaine du MBean (partie située avant le signe deux-points).
Nom MBean Représentation de chaîne complète du MBean.
Attribute.serverVendor MBean Attribut MBean serverVendor.
Method.getHeapSize MBean Valeur renvoyée par getHeapSize() sur le MBean.
Property.j2eeType MBean La valeur de j2eeType est extraite du nom de MBean.
Field.Message Evénement (Notification) Zone Message dans une notification.
Les mots clés Attribute, Method et Field peuvent renvoyer des objets Java contenant d'autres données. Vous pouvez effectuer des opérations sur ces objets en ajoutant des définitions de valeur secondaire. Autres exemples :
Exemple de nom d'unité de mesure Type de groupe d'attributs Description des données renvoyées
Attribute.deployedObject.Method.getName MBean Extrait l'attribut deployedObject du MBean et obtient le résultat de la méthode getName().
Attribute.eventProvider.Method.
getException.Method.getDescription		 MBean Trois étapes : un attribut intitulé eventProvider est censé être un objet comportant une méthode getException(). Cette méthode renvoie un objet à l'aide d'une méthode getDescription(). Cette méthode est appelée et la valeur de retour est placée dans la colonne.
Attribute.HeapMemoryUsage.Method.
get(used)		 MBean Extrait l'attribut HeapMemoryUsage du MBean et obtient le résultat de la méthode get(String valeur). La chaîne utilisée est transmise à la méthode sous forme d'argument. Un seul argument peut être fourni et celui-ci doit correspondre à une valeur de chaîne littérale.

Explique comment collecter des données d'une structure de données composites MBean ouverte.
Domain et Property peuvent être utilisés comme mots clés dans les valeurs secondaires si la valeur précédente a renvoyé une chaîne au format d'un nom de MBean. Par exemple :
Exemple de nom d'unité de mesure Type de groupe d'attributs Description des données renvoyées
Attribute.jdbcDriver.Property.name MBean L'attribut jdbcDriver renvoie un nom de MBean et la propriété de clé name est extraite du nom de MBean.
Attribute.jdbcDriver.Domain MBean L'attribut jdbcDriver renvoie un nom de MBean et le domaine est extrait du nom de MBean.
Les mots clés ElementCount et Explode effectuent des opérations sur des tableaux ou des collectes de données.
  • ElementCount – renvoie le nombre d'éléments d'un tableau.
  • Explode – scinde une ligne en plusieurs lignes correspondant chacune à un élément d'un tableau.
Exemples de chaque mot clé :
Exemple de nom d'unité de mesure Type de groupe d'attributs Description des données renvoyées
Attribute.deployedObjects.ElementCount MBean L'attribut MBean deployedObjects est un tableau et cette colonne contient le nombre d'éléments dans le tableau.
Attribute.deployedObjects.Explode.
MBean.Property.j2eeType		 MBean La table comporte une seule ligne pour chaque élément des objets déployés. Cette colonne contient le type j2eeType de l'objet déployé.
Attribute.SystemProperties.Method.
values.Explode.Method.get(key)		 MBean Permet d'extraire une nouvelle ligne pour chaque entrée dans une structure de données tabulaires MBean ouverte. Chaque structure de données tabulaires contient une structure de données composites comportant un élément intitulé key, qui est renvoyé.