Étiquettes dynamiques
Il existe de multiples méthodes pour gérer le texte contenu dans les étiquettes, celui-ci peut même être dynamique.
Sommaire
Afficher un paramètre ou une variable dans l'étiquette
L'étiquette peut afficher des informations de la probe : paramètres ou variables ou de l'élément. La syntaxe est la suivante :
${param:<Nom Paramètre, variable, ou attribut>}
|
Par exemple, pour afficher le temps nécessaire à l'établissement de la connexion de la probe TCP au nœud, votre étiquette doit ressembler à :
<Smart Name> Temps etablissement connexion: ${param:_connect} msec.
|
Attention : il n'y a pas d'espace après "param:" et le nom de la variable (Dans cet exemple, le "_" fait parti du nom de la variable ce qui n'est pas le cas de la plupart des variables.) N'importe quelle variable de la probe contenue dans le <snmp-device-display>, <script-out> ou <commande-display> en utilisant cette syntaxe. Vous pouvez afficher un paramètre de la probe Basic OID en utilisant la syntaxe :
Getting data from: ${param:Object ID}
|
L'affichage des information du nœud se fait en utilisant :
Belongs to map: ${param:MapName}
|
Utiliser JavaScript dans une étiquette ou une alerte
Vous pouvez également utiliser JavaScript dans une étiquette ou une alerte. Cette méthode vous permet de réaliser des micro-traitements sur les informations que vous souhaitez afficher.
<? write( "Hello World" + "\n"); ?> |
Les balises <? et ?> indiquent respectivement le début et la fin du JavaScript.
Variables et Champ du Javascript
Important : JavaScript dans les étiquettes et les alertes fonctionne de manière globale. Si vous déclarez une variable au niveau global plutôt que dans une fonction, cette dernière est accessible en lecture/écriture par n'importe quel autre JavaScript (éventuellement positionné sur une autre nœud). Cela peut produire des résultats inattendus et erronés si vous lancez le même script sur plusieurs nœuds.
Les fonctions JavaScript sont supportées, vous pouvez dès-lors stocker des valeurs dans les nœuds et les alertes, elles seront conservées entre chaque tests ( polls ). Cette méthode est recommandée pour protéger les variables de toute modification non souhaitée. Définir des variables dans les nœuds est décrit ici : xxxxxxxxxxxxxxxxx
Exemple : un script d'étiquette simple
Le résultat de ce script est sans intérêt, l'objet de l'exemple est d'en montrer l'écriture.
<Smart Name> <? for (var i=1; i<=3; i++) {
writeln( "Hello World #" + i); } ?> |
Affichera comme étiquette :
IMAGE
Les fonctions write et writeln
Ces deux fonctions sont utilisées pour écrire plusieurs valeurs dans les étiquettes. La différence est que writeln ajouter un saut à la ligne (ce qui évite de devoir coder un \n)
Accéder aux paramètres d'une probe
L'utilisation de la syntaxe suivante permet d'accéder aux paramètres d'une probe :
abc
