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 un ou plusieurs authentifiants suivants :
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.
- . (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 d'attente (sec)). Saisissez la durée de la tentative de connexion deWhatsUp Gold au périphérique sélectionné. Lorsque la durée saisie est dépassée sans réussite de connexion, un délai d'attente se produit et WhatsUp Gold arrête d'essayer de se connecter au serveur SMTP. Ceci est considéré comme un échec de connexion. À noter que le délai d'attente maximum autorisé est de 60 secondes. Cependant, Ipswitch ne recommande pas le paramétrage d'un délai d'attente dépassant 10 secondes. Utilisez le délai d'attente le plus court possible.
- (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 :
- Cliquez sur (Ajouter) dans la boîte de dialogue Add Active Script Performance Monitor (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 Add New Reference Variable (Ajouter une nouvelle variable de référence) apparaît.
- Entrez les informations appropriées :
- (Nom de la variable). Saisissez un nom unique pour la variable.
- . (Facultatif) Saisissez une description courte pour la variable.
- Sélectionnez dans la liste(Type d'objet).
- Saisissez le (Délai d'attente) et le nombre de (Tentatives) pour la connexion au périphérique. Les champs précédents sont facultatifs.
- Cliquez sur Parcourir() à côté de . La boîte de dialogue MIB Browser (Navigateur MIB) apparaît.
- 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 utilisés pour la connexion au périphérique. Vous pouvez également cliquez sur Parcourir() pour accéder à la Bibliothèque d'informations d'identification afin de créer un nouvel authentifiant.
- Ajustez la durée et le nombre de tentatives pour l'ordinateur auquel vous tentez de vous connecter dans les cases (Délai d'attente) et (Nombre de tentatives).
- Cliquez sur . Le navigateur SNMP MIB apparaît.
- 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.
- Cliquez sur pour ajouter l'OID au (Compteur de performances) et aux champs dans la boîte de dialogue Add New Reference Variable (Ajouter une nouvelle variable de référence).
- Vérifiez la configuration et cliquez sur pour ajouter la variable à la liste de (Variables de référence) dans la boîte de dialogue Add Active Script Performance Monitor (Ajouter un analyseur de performances de scripts actifs).
- Écrivez ou collez le code de votre analyseur dans le champ (Texte du script).
- Cliquez sur pour enregistrer les modifications.
Pour configurer un analyseur de performances de scripts actifs WMI :
- Cliquez sur (Ajouter) dans la boîte de dialogue Add Active Script Performance Monitor (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 Add New Reference Variable (Ajouter une nouvelle variable de référence) apparaît.
- Entrez les informations appropriées :
- (Nom de la variable). Saisissez un nom unique pour la variable.
- . (Facultatif) Saisissez une description courte pour la variable.
- Sélectionnez dans la liste(Type d'objet).
- Cliquez sur Parcourir () à côté de . La boîte de dialogue Performance Counters (Compteurs de performances) apparaît.
- 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.
- Sélectionnez le (Authentifiant Windows) utilisé pour la connexion au périphérique. Vous pouvez également cliquez sur Parcourir() pour accéder à la Bibliothèque d'informations d'identification afin de créer un nouvel authentifiant.
- Cliquez sur pour vous connecter à l'ordinateur.
- Utilisez l'arborescence de compteur de performances pour naviguer vers le (Compteur de performances) que vous souhaitez analyser.
- Sélectionnez la (Instance de performances) spécifique que vous souhaitez analyser.
- Cliquez sur pour ajouter la variable au champ (Compteur de performances) dans la boîte de dialogue Add New Reference Variable (Ajouter une nouvelle variable de référence).
- Cliquez sur pour ajouter la variable à la liste (Variable de référence) dans la boîte de dialogue Add Active Script Performance Monitor (Ajouter un analyseur de performances de scripts actifs).
- Saisissez le code de l'analyseur dans le champ (Texte du script).
- Cliquez sur 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 Custom Performance Monitors (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.
: 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 ».
: 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.