|
|
| Ligne 1 : |
Ligne 1 : |
| − | Il existe de multiples méthodes pour gérer le contenu des étiquettes ( Labels) , celui-ci peut même être dynamique.
| + | == Documentation en Anglais == |
| | | | |
| | | | |
| | + | * {en} [http://ressources.intermapper.eu/docs/InterMapper_User_Guide.pdf Guide utilisateur d'InterMapper] |
| | + | * {en} [http://ressources.intermapper.eu/docs/InterMapper_Developer_Guide.pdf Guide du développement InterMapper] |
| | + | * {en} [http://http://releasenotes.intermapper.eu Notes de version (release notes)] |
| | | | |
| − | ===Afficher un paramètre ou une variable dans l'étiquette=== | + | == InterMapper en Français == |
| | | | |
| − | L'étiquette peut afficher des informations de la probe : paramètres ou variables ou de l'élément. La syntaxe est la suivante :
| |
| | | | |
| | + | * [http://blog.intermapper.eu Nouveauté 2017 le Blog Intermapper, chaque semaine ou presque un nouveau billet !] |
| | | | |
| − | <pre>${param:<Nom Paramètre, variable, ou attribut>}</pre>
| |
| | | | |
| − | Par exemple, pour afficher le temps nécessaire à l'établissement de la connexion de la probe TCP au nœud, votre étiquette doit ressembler à :
| + | * [http://www.netwalker.fr/intermapper.html Site NetWalker.fr, Distributeur France et Belgique] |
| | + | * [http://forum.netwalker.fr/viewforum.php?f=3&sid=609e014beb3c04fda04de50a01c5c9cf Forum Intermapper en Français] |
| | + | * [https://support2.netwalker.fr Support Intermapper en Français] |
| | + | * [http://support.intermapper.eu/faq.php F.A.Q. Intermapper (Questions Fréquentes à propos d'InterMapper) ] |
| | | | |
| | + | * [https://www.netwalkerstore.com/logiciel-de-supervision-reseau-et-monitoring-serveurs-intermapper-c2x11829688 Acheter Intermapper] |
| | | | |
| − | <pre>Temps etablissement connexion: ${param:_connect} msec.</pre>
| |
| | | | |
| | | | |
| − | 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 :
| + | et aussi |
| | | | |
| | + | * [http://ressources.netwalkerstore.com/mbb/html/subscribe_intermapper.php Newsletter InterMapper] |
| | + | * [http://twitter.com/intermapperfr InterMapper sur Twitter] |
| | | | |
| − | <pre>Getting data from: ${param:Object ID}</pre>
| |
| | | | |
| | + | et en Anglais : |
| | + | * {en} [http://forums.intermapper.com/index.php? InterMapper Talk Forums] |
| | | | |
| − | L'affichage des informations du nœud se fait en utilisant :
| |
| | | | |
| | | | |
| − | <pre>Belongs to map: ${param:MapName}</pre> | + | <center><google1 style="1"></google1></center> |
| | | | |
| − | ===Utiliser JavaScript dans une étiquette ou une alerte=== | + | == Contributions utilisateurs == |
| | | | |
| − | 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.
| + | * [http://bit.ly/Zh4csa InterMapper App pour Splunk (Avril 2013)] ([http://bit.ly/YcETaJ lire le communiqué de presse détaillé en Anglais par ici] ) |
| | + | [http://forum.netwalker.fr/viewtopic.php?f=19&t=173&p=185#p185 Voir une courte vidéo sur le tableau de bord Splunk pour InterMapper] |
| | + | * [[Liste des probes utilisateurs]] |
| | + | * [[Fonds de cartes utilisateurs pour InterMapper]] |
| | | | |
| | | | |
| − | <pre><? write( "Hello World" + "\n"); ?></pre>
| + | * [https://virtualmin.wordpress.com/2010/03/31/definir-et-personnaliser-les-seuils-dalerte-dans-dartware-intermapper/ Définir et personnaliser les seuils d'alerte avec InterMapper] |
| | | | |
| − | Les balises <? et ?> indiquent respectivement le début et la fin du JavaScript.
| + | ==Vidéos== |
| | | | |
| | + | ===En Français=== |
| | | | |
| | + | * [http://forums.netwalker.fr/vf/im/intermapper_double_clic.htm Vidéo : Définir l'action d'un double-clic sur une icone] |
| | + | * [http://forums.netwalker.fr/vf/im/lier_un_element.htm Vidéo : Connecter manuellement une icone à un commutateur] |
| | + | * [http://forums.netwalker.fr/vf/im/addcommutateur.htm Vidéo : Ajouter un switch sur une carte et optimiser son affichage] |
| | + | * [http://forums.netwalker.fr/vf/im/intermapper5.1.html Vidéo : Grapher les flux du réseau] |
| | | | |
| | | | |
| − | ====Variables et Champ du Javascript==== | + | ===En Anglais=== |
| | | | |
| | + | * [http://www.intermapper.com/support/video-tutorials.aspx les vidéos sur le site de l'éditeur] |
| | + | * [http://www.intermapper.com/support/release-notes/release-notes-for-intermapper.aspx Notes de version (Release Notes) de l'éditeur en anglais] |
| | | | |
| − | '''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 un autre nœud). Des résultats erronés ou inattendus se produiront si vous lancez le même script sur plusieurs nœuds.
| + | Ces vidéos sont en Anglais, mais la plupart peuvent être regardées sans le son ! |
| | | | |
| | + | ==Techniques de diagnostic == |
| | | | |
| − | Les fonctions JavaScript sont supportées, vous pouvez stocker des valeurs dans les nœuds et les alertes, elles seront conservées entre chaque test ( polls ). Cette méthode est recommandée pour protéger les variables de toute modification indésirable. Définir des variables locales dans les nœuds est décrit ici : [[Étiquettes dynamiques#Mémoriser les données d'un test à l'autre|Mémoriser les données d'un test à l'autre]].
| + | * [[Diagnostic ADSL]] |
| | + | * [[Lenteur Applications]] |
| | | | |
| − | ====Exemple : un script d'étiquette simple====
| |
| − | Le résultat affiché par ce script est sans intérêt pour la supervision, mais permet de détailler l'écriture d'un script.
| |
| | | | |
| | + | ==Trucs et Astuces == |
| | | | |
| − | <pre><Smart Name>
| + | * [[Inserer l'url d'une carte dans une alerte|Insérer l'URL d'une carte dans une alerte]] |
| − | <?
| |
| − | for (var i=1; i<=3; i++) {
| |
| − | writeln( "Hello World #" + i);
| |
| − | }
| |
| − | ?></pre>
| |
| | | | |
| − | Affichera comme étiquette :
| |
| | | | |
| − | <center>http://www.intermapper.eu/imgwiki/Labels/LabelExample1_357x141.png</center>
| |
| | | | |
| | + | == Essayer & Acheter == |
| | | | |
| | + | * [http://www.netwalkerstore.com/evaluer_intermapper.htm Télécharger la démo InterMapper] |
| | + | * [http://www.netwalkerstore.com/intermapper_supervision.htm Tarifs d'InterMapper] |
| | | | |
| − | =====Les fonctions write et writeln=====
| |
| | | | |
| − | Ces deux fonctions sont utilisées pour afficher 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===== | + | == On parle d'InterMapper == |
| | | | |
| − | L'utilisation de la syntaxe suivante permet d'accéder aux paramètres d'une probe :
| + | * [http://www.supervision-reseau-facile.fr/ Site Supervision Réseau Facile] |
| | + | * [http://www.globalsecuritymag.fr/I-ILL-a-retenu-Extreme-Networks,20130905,39427.html InterMapper supervise le réseau de l'Institut Laue Langevin (ILL)] |
| | + | <center> |
| | + | http://wiki.intermapper.eu/img/intermapper-a-l-institut-laue-langevin.png |
| | + | </center> |
| | | | |
| − | <pre><? writeln( "Getting data from: " + self.get( "Object ID")); ?></pre>
| + | == Autour d'InterMapper == |
| | | | |
| − | | + | * [[Extensions Logicielles InterMapper ]] |
| − | L'objet self fait référence à l'objet où se trouve le script. L'objet self est toujours disponible en JavaScript dans les étiquettes. Utilisez une syntaxe identique :
| + | * [http://www.barnesandnoble.com/w/intermapper-lambert-m-surhone/1029003739?ean=9786134553834 Un livre en Anglais sur InterMapper] |
| − | | |
| − | <pre><?
| |
| − | var connTime = self.get( "_connect");
| |
| − | writeln( "Time to establish connection: " + connTime);
| |
| − | ?></pre>
| |
| − | | |
| − | | |
| − | | |
| − | | |
| − | =====Gestion des erreurs JavaScript=====
| |
| − | | |
| − | Si vous aviez fait une faute de frappe dans le nom de votre variable, (par exemple tapé ''_conect'' au lieu de'' _connect'') l'étiquette afficherait :
| |
| − | | |
| − | <center>http://www.intermapper.eu/imgwiki/Labels/LabelExample2_555x37.png</center>
| |
| − | | |
| − | | |
| − | Si vous consultez le journal de debug (debug log) vous trouverez le message suivant :
| |
| − | | |
| − | <pre> 12:15:46 JS> [Device: map 'Exporting Fields', device 'nitro.dartware.com.', probe
| |
| − | 'SNMP Traffic']:BAD ARG: There is no variable called '_conect'. It should be the
| |
| − | name of a probe variable without '$' or curly braces.</pre>
| |
| − | | |
| − | Le message d'erreur vous indique la carte, le nœud et la probe qui sont à l'origine de l'erreur et autant de détail que possible.
| |
| − | | |
| − | Une erreur de syntaxe JavaScript afficherait ainsi :
| |
| − | | |
| − | <center>http://www.intermapper.eu/imgwiki/Labels/LabelExample3_305x36.png</center>
| |
| − | | |
| − | | |
| − | Le journal de debug donnera des détails sur l'erreur.
| |
| − | | |
| − | | |
| − | | |
| − | =====Limite du temps d'exécution=====
| |
| − | | |
| − | La durée d'exécution d'un script est limitée, entre 50 et 100 msec pour éviter la monopolisation de la CPU. C'est aussi un excellent moyen de générer des étiquettes complexes.
| |
| − | | |
| − | Voici un petit exemple :
| |
| − | | |
| − | <pre><?
| |
| − | for (var i = 0; i < 1000000; i++) {
| |
| − | if(i%10000 == 0) {
| |
| − | writeln( "testing the timeout " + i);
| |
| − | }
| |
| − | }
| |
| − | ?></pre>
| |
| − | | |
| − | Dont le résultat sera :
| |
| − | <center>http://www.intermapper.eu/imgwiki/Labels/timeoutexample.png</center>
| |
| − | | |
| − | 3 ticks correspondent approximativement à 50 msec.
| |
| − | | |
| − | | |
| − | | |
| − | | |
| − | =====Mémoriser les données d'un test=====
| |
| − | | |
| − | Il peut parfois être utile de mémoriser la valeur des variables.
| |
| − | | |
| − | Il y a 2 manières de procéder :
| |
| − | | |
| − | * '''JavaScript Global Variables''' : Toutes les variables JavaScript déclarées en mode global restent mémorisées d'une exécution de JavaScript à l'autre. La variable est accessible de n'importe quel nœud qui utiliserait le script. Elle est aussi accessible quelque soit l'emplacement d'exécution du JavaScript pour être placée dans une étiquette ou une alerte. Attention, en utilisant le même script à différents endroits, vous prenez le risque de modifier à tort cette variable.
| |
| − | * '''Device JavaScript Variables''' : Cette donnée est stockée au niveau du nœud. L'avantage est que chaque nœud peut utiliser les mêmes noms de variables sans risques de conflit. Utilisez self.get(…) et self.read(…) pour lire et écrire ces variables. Attention, '''le nom de ces variables doit être différent des noms de paramètres de la probe et des variables de la probe elle-même'''.
| |
| − | | |
| − | | |
| − | | |
| − | ======Associer une variable à un nœud (exemple)======
| |
| − | | |
| − | Pour placer la valeur stockée dans le variable locale "MyInformation" dans ''myinfo'':
| |
| − | | |
| − | <pre>var ''myinfo'' = self.get( "MyInformation" );</pre>
| |
| − | | |
| − | | |
| − | Pour écrire la valeur de ''myinfo'' dans la variable locale "MyInformation" :
| |
| − | | |
| − | <pre>storedinfo = self.set( "MyInformation", ''myinfo'' );</pre>
| |
| − | | |
| − | La fonction self.set(…) contient la valeur qui est stockée. Si la valeur ne peut être stockée (par exemple si vous essayez de stocker dans une variable de la probe ou un de ses paramètres), la valeur de votre variable ''myinfo'' contiendra la valeur qui se trouve dans la cible (le paramètre ou la variable de la probe que vous ne pouvez pas modifier).
| |
| − | | |
| − | | |
| − | | |
| − | ======Incrémenter un compteur (exemple)======
| |
| − | | |
| − | Il est assez simple d'incrémenter la valeur d'un compteur à chaque affichage de l'étiquette. Il faut juste se rappeler que la variable correspondant au compteur n'existe pas encore lors de la première exécution du script.
| |
| − | | |
| − | Le script suivant récupère la valeur de la variable "Count", l'affiche, l'incrémente puis la sauvegarde. Lors de la première exécution du script, self.get() retourne la chaine "BAD ARG, see debug log". Vous devez utiliser la fonction JavaScript isNaN() pour déterminer si n est NaN (Not a Number) ce qui est le cas lorsque cette dernière pas encore été initialisée (= lors du premier passage).
| |
| − | | |
| − | <pre>
| |
| − | <?
| |
| − | var n = Number( self.get( "Count"));
| |
| − | if (isNaN(n)) n = 0;
| |
| − | writeln( "Count is " + n);
| |
| − | n++;
| |
| − | self.set("Count", n);
| |
| − | ?>
| |
| − | </pre>
| |
| − | | |
| − | Ce type de script fonctionne également pour les variables globales.
| |
| − | | |
| − | | |
| − | ======Utiliser les attributs des nœuds======
| |
| − | | |
| − | L'utilisation de Javascript permet également d'accéder aux attributs des nœuds. La syntaxe est différente de cette utilisée pour les paramètres et les variables de la probe. La script utilise toujours l'objet self mais le nom de l'attribut est la propriété de l'objet.
| |
| − | | |
| − | <pre>
| |
| − | <?
| |
| − | var rtt = self.RoundTripTime;
| |
| − | writeln( "Round-trip time is \n" + rtt + " msec");
| |
| − | ?>
| |
| − | </pre>
| |
| − | | |
| − | Ce script copie la valeur du dernier Round-Trip (temps de réponse) dans la variable rtt et l'affiche :
| |
| − | | |
| − | <center>http://www.intermapper.eu/imgwiki/Labels/roundtripexample.png</center>
| |
| − | | |
| − | Toute erreur de syntaxe provoquera une erreur de syntaxe JavaScript. Le message "JS EXCEPTION, see debug log" (Exception JavaScript, voir le journal de debug).
| |
| − | | |
| − | N'importe quel attribut du nœud peut être utilisé dans l'étiquette. Voir la liste des [[Attributs de nœud|attributs de nœud]].
| |
| − | | |
| − | | |
| − | | |
| − | ======Accéder aux attributs======
| |
| − | | |
| − | Les nœuds sont connectés au réseau via des interfaces. La propriété '''Interfaces''' est disponible pour chaque nœud.. En JavaScript, cette propriété apparaît comme une table. L'exemple suivant liste l'ensemble des interfaces dont le status est "Down"
| |
| − | | |
| − | <pre>
| |
| − | <?
| |
| − | var downInterfaces = 0;
| |
| − | for (var i =0; i < self.interfaces.length; i++;) {
| |
| − | var ifc = self.interfaces[i];
| |
| − | if ((ifc.Enabled == "TRUE") && (ifc.Status == "down")) {
| |
| − | downInterfaces++;
| |
| − | write( ifc.Index + ". ");
| |
| − | write(ifc.Alias.length > 0 ? ifc.Alias : ifc.Name );
| |
| − | writeln( " : " + ifc.Status);
| |
| − | }
| |
| − | }
| |
| − | writeln();
| |
| − | writeln(downInterfaces + "/" + self.interfaces.length + " interfaces down");
| |
| − | ?>
| |
| − | </pre>
| |
| − | | |
| − | N'importe quel attribut peut être utilisé dans les étiquettes. Voir la liste des [[Attributs d'Interface | attributs d'interface]].
| |
| − | | |
| − | | |
| − | | |
| − | | |
| − | ----
| |
| − | | |
| − | | |
| − | ----
| |
| − | | |
| − | [[Accueil]] > [[Documentation]] > [[Personnalisation de cartes | Personnalisation des cartes]]
| |
