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.
• Type de script. Sélectionnez JSCRIPT ou VBSCRIPT.
• 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.
• Délai (s). Saisissez la durée de la tentative de connexion deWhatsUp Gold au périphérique sélectionné.
• Variables de référence. Ajoutez, modifiez ou supprimez des variables de référence SNMP et WMI en utilisant les boutons appropriés à droite de la boîte de dialogue. À 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 :

1. Cliquez sur Ajouter 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.
2. 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.
3. Sélectionnez SNMP dans la liste Type d'objet.
4. Saisissez le délai et le nombre de tentatives pour la connexion au périphérique. Les champs précédents sont facultatifs.
5. Cliquez sur Parcourir (...) en regard d'Instance. La boîte de dialogue Navigateur MIB apparaît.
6. 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.
7. 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.
8. 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.
9. Cliquez sur OK. Le navigateur SNMP MIB apparaît.
10. Utilisez l'arborescence de navigation dans le panneau gauche 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.
11. 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.
12. 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.
13. Écrivez ou collez le code de votre analyseur dans le champ Texte du script.
14. Cliquez sur OK pour enregistrer les modifications.

Pour configurer un analyseur de performances de scripts actifs WMI :

1. Cliquez sur Ajouter 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.
2. 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.
3. Sélectionnez WMI dans la liste Type d'objet.
4. Cliquez sur Parcourir (...) en regard d'Instance. La boîte de dialogue Compteurs de performances s'affiche.
5. Saisissez le nom ou l'adresse IP de l'ordinateur auquel vous tentez de vous connecter. Vous pouvez cliquer sur le bouton Parcourir (...) pour sélectionner un périphérique d'une liste.
6. 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.
7. Cliquez sur OK pour vous connecter à l'ordinateur.
8. Utilisez l'arborescence de compteur de performances pour naviguer vers le compteur de performances que vous souhaitez analyser.
9. Sélectionnez l'instance de performances spécifique que vous souhaitez analyser.
10. Cliquez sur OK pour ajouter la variable au champ Compteur de performances dans la boîte de dialogue Ajout d'une nouvelle variable de référence.
11. Cliquez sur OK pour ajouter la variable à la liste Variable de référence dans la boîte de dialogue Ajout d'un analyseur de performances de script actif.
12. Saisissez le code de l'analyseur dans le champ Texte du script.
13. 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 des erreurs des analyseurs 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.

Voir également Analyseurs de performances Onduleur APC (Performances) Utilisation du processeur (Performances) Script PowerShell Utilisation du disque (Performances) Imprimante (performances) Activité du disque de la machine virtuelle Hyper-V JMX (performances) Utilisation de la mémoire (performances) Latence et disponibilité du test ping SNMP (performances) Requête SQL (performances) SSH (performances) IOPS du magasin de données VMware Compteur de performances Windows Configuration des analyseurs de compteurs au format WMI Analyseur de performances WMI Analyseur du journal d'événements Hyper-V (Intégré) Analyseur de machines virtuelles d'hôte Hyper-V