Script actif (performances)

L'analyseur de performances de scripts actifs vous permet d'écrire du code VBScript et JScript pour faciliter l'interrogation d'une ou plusieurs valeurs SNMP ou WMI, de réaliser des opérations mathématiques ou d'autres opérations sur ces valeurs, et de réaliser un graphique d'une seule valeur de sortie. Vous devez utiliser uniquement l'analyseur de performances de scripts actifs lorsque vous devez réaliser des calculs sur des valeurs interrogées. Gardez à l'esprit que même si vous pouvez interroger plusieurs valeurs en utilisant cette fonction, uniquement une valeur est stockée dans la base de données : le résultat de votre calcul par script.

L'analyseur de performances de scripts actifs nécessite une ou plusieurs informations d'identification suivantes :

SNMPv1
SNMPv2
SNMPv3
WMI

Configurez l'analyseur de performances de scripts actifs en utilisant les cases suivantes :

Nom. Saisissez un nom unique pour l'analyseur de performances. Ce nom est affiché dans la bibliothèque d'analyseurs.
Description. (Facultatif) Saisissez une description courte pour l'analyseur de performances. Cette description s'affiche à côté de l'analyseur de performances dans la bibliothèque d'analyseurs.
Type de script. Sélectionnez JScript ou VBScript.
Délai. Saisissez la durée de la tentative de connexion de WhatsUp Gold au périphérique sélectionné.
Intervalle d'interrogation. Spécifiez la fréquence à laquelle WhatsUp Gold doit demander des informations mises à jour à partir du périphérique.
Variables de référence. Ajoutez, modifiez ou supprimez les variables de référence SNMP et WMI. À noter que l'utilisation de variables de référence dans l'analyseur de performances de scripts actifs est facultative. Pour plus d'informations, reportez-vous à Utilisation de variables de référence avec des analyseurs de scripts.
Texte du script. Saisissez le code de l'analyseur.

Pour configurer un analyseur de performances de scripts actifs SNMP :

Cliquez dans la boîte de dialogue Ajouter un analyseur de performances de scripts actifs pour ajouter une nouvelle variable dans le champ Variables de référence. La boîte de dialogue Ajouter une nouvelle variable de référence s'affiche.
Entrez les informations appropriées :
- Nom de la variable. Saisissez un nom unique pour la variable.
- Description. (Facultatif) Saisissez une description courte pour la variable.
Sélectionnez la case d'option SNMP.
Saisissez le délai et le nombre de tentatives pour la connexion au périphérique. Les champs précédents sont facultatifs.
Cliquez sur Sélectionner pour lancer le navigateur MIB.
Saisissez le nom ou l'adresse IP de l'ordinateur sur lequel vous essayez de vous connecter dans le champ Sélectionner les compteurs de l'ordinateur. Vous pouvez cliquer sur le bouton Parcourir (...) pour sélectionner un périphérique d'une liste.
Sélectionnez les informations d'identification SNMP utilisées pour la connexion au périphérique. Vous pouvez également cliquer sur Parcourir(...) pour accéder à la Bibliothèque d'informations d'identification afin de créer une nouvelle information d'identification.
Ajustez la durée et le nombre de tentatives pour l'ordinateur auquel vous tentez de vous connecter dans les cases Délai et Nombre de tentatives.
Cliquez sur OK.
Utilisez l'arborescence de navigation pour sélectionner le MIB spécifique que vous souhaitez analyser. Vous pouvez afficher davantage d'informations sur la propriété/valeur dans la partie inférieure de la boîte de dialogue.
Cliquez sur OK pour ajouter l'OID au compteur de performances et aux champs Instance dans la boîte de dialogue Ajouter une nouvelle variable de référence.
Vérifiez la configuration et cliquez sur OK pour ajouter la variable à la liste de Variables de référence dans la boîte de dialogue Ajout d'un analyseur de performances de script actif.
Écrivez ou collez le code de votre analyseur dans le champ Texte du script.
Cliquez sur OK pour enregistrer les modifications.

Pour configurer un analyseur de performances de scripts actifs WMI :

Cliquez dans la boîte de dialogue Ajouter un analyseur de performances de scripts actifs pour ajouter une nouvelle variable dans le champ Variables de référence. La boîte de dialogue Ajouter une nouvelle variable de référence s'affiche.
Entrez les informations appropriées :
- Nom de la variable. Saisissez un nom unique pour la variable.
- Description. (Facultatif) Saisissez une description courte pour la variable.
Sélectionnez la case d'option WMI .
Cliquez sur Sélectionner pour lancer le navigateur MIB.
Saisissez le nom ou l'adresse IP de l'ordinateur sur lequel vous essayez de vous connecter dans le champ Sélectionner les compteurs de l'ordinateur. Vous pouvez cliquer sur le bouton Parcourir (...) pour sélectionner un périphérique d'une liste.
Sélectionnez les informations d'identification utilisées pour la connexion au périphérique. Vous pouvez également cliquer sur Parcourir(...) pour accéder à la Bibliothèque d'informations d'identification afin de créer une nouvelle information d'identification.
Cliquez sur OK.
Utilisez l'arborescence de navigation pour sélectionner le MIB spécifique que vous souhaitez analyser. Vous pouvez afficher davantage d'informations sur la propriété/valeur dans la partie inférieure de la boîte de dialogue.
Cliquez sur OK pour ajouter l'OID au compteur de performances et aux champs Instance dans la boîte de dialogue Ajouter une nouvelle variable de référence.
Vérifiez la configuration et cliquez sur OK pour ajouter la variable à la liste de Variables de référence dans la boîte de dialogue Ajout d'un analyseur de performances de script actif.
Écrivez ou collez le code de votre analyseur dans le champ Texte du script.
Cliquez sur OK pour enregistrer les modifications.

Gardez à l'esprit

Vous devez inclure la gestion des erreurs dans le script de l'analyseur. Votre script doit contenir une valeur pour générer un graphique en utilisant Context.SetValue, ou vous devez utiliser Context.SetResult pour indiquer à WhatsUp Gold que le script a échoué.
Context.GetReferenceVariable renvoie la valeur « null » si l'interrogation échoue.
En l'absence d'appel des commandes SetValue ou SetResult, le script n'indique pas les erreurs et aucune donnée n'est générée dans un graphique.
Si SetValue est utilisé, il n'est pas nécessaire d'utiliser SetResult, comme SetValue définit implicitement SetResult sur 0, ou « bon ».
Les résultats de cet analyseur de performances sont affichés dans les rapports complets et dans les rapports du tableau de bord Analyseurs de performances personnalisés.
Les erreurs de cet analyseur de performances sont affichées dans le journal Performance Monitor Error (Erreurs de l'analyseur de performances), ainsi que dans EventViewer.exe.

Important: La première fois que vous interrogez une variable de référence WMI qui nécessite deux interrogations afin de calculer une moyenne (telle que « Processor\% Processor Time »), elle renvoie la valeur « Null ».

Warning: La modification de la configuration d'un analyseur de performances de scripts actifs VoIP n'est pas recommandée, afin d'éviter que l'utilitaire de configuration VoIP ne détecte une configuration VoIP existante.