Active-Script (Leistung)

Mit dem Leistungsmonitor für Active-Script können Sie in VBScript und JScript schreiben, um ganz bequem einen oder mehrere SNMP- oder WMI-Werte abzufragen, mit diesen Werten mathematische oder andere Operationen durchzuführen und einen einzelnen Ausgabewert grafisch darzustellen. Den Leistungsmonitor für Active-Script sollten Sie nur dann verwenden, wenn Sie zu den abgefragten Werten Berechnungen durchführen müssen. Sie sollten bedenken, dass mit der Funktion zwar das Abfragen mehrerer Werte möglich ist, jedoch nur ein Wert in der Datenbank gespeichert wird, nämlich das Ergebnis Ihrer per Skript durchgeführten Berechnung.

Für den Leistungsmonitor für Active-Script sind eine oder mehrere der folgenden Anmeldeinformationen erforderlich:

SNMPv1
SNMPv2
SNMPv3
WMI

So konfigurieren Sie den Leistungsmonitor für Active-Script mit Hilfe folgender Felder:

Name. Geben Sie dem Leistungsmonitor einen eindeutigen Namen. Dieser Name wird in der Monitorbibliothek angezeigt.
Beschreibung. (Optional) Geben Sie eine kurze Beschreibung für den Leistungsmonitor ein. Diese Beschreibung wird in der Monitor-Bibliothek neben dem Leistungsmonitor angezeigt.
Skript-Art. Wählen Sie entweder JSCRIPT oder VBSCRIPT.
Zeitüberschreitung. Geben Sie hier an, wie lange WhatsUp Gold versuchen soll, eine Verbindung mit dem ausgewählten Gerät herzustellen.
Abfrageintervall. Legen Sie fest, wie oft aktualisierte Informationen zum Gerät durch WhatsUp Gold abgefragt werden sollen.
Referenzvariablen. SNMP- und WMI-Referenzvariablen können Sie hinzufügen, bearbeiten oder löschen. Beachten Sie bitte, dass die Verwendung von Referenzvariablen im Leistungsmonitor für Active-Script lediglich eine Option darstellt. Weitere Informationen können Sie unter Verwenden von Referenzvariablen bei Skript-Monitoren nachlesen.
Skripttext. Geben Sie den Skriptcode für den Monitor ein.

So konfigurieren Sie einen Leistungsmonitor für SNMP-Active-Script:

Klicken Sie auf im Dialogfeld „Leistungsmonitor für Active-Script hinzufügen“ und fügen Sie eine neue Variable in das Feld Referenzvariablen ein. Das Dialogfeld „Neue Referenzvariable hinzufügen“ wird angezeigt.
Geben Sie die entsprechenden Informationen ein:
- Variablenname. Geben Sie der Variable einen eindeutigen Namen.
- Beschreibung. (Optional) Geben Sie eine kurze Beschreibung für die Variable ein.
Wählen Sie das Optionsfeld SNMP aus.
Geben Sie für die Verbindung zum Gerät die Zeitüberschreitung und die Anzahl der Wiederholungsversuche ein. Das Ausfüllen dieser Felder ist optional.
Öffnen Sie den MIB-Browser mit Auswählen.
Geben Sie in das Feld Leistungsindikatoren auswählen von Computer den Namen oder die IP-Adresse des Computers ein, zu dem eine Verbindung hergestellt werden soll. Alternativ können Sie auch auf „Durchsuchen“ (...) klicken und ein Gerät aus einer Liste auswählen.
Wählen Sie die SNMP-Anmeldeinformationen zur Herstellung einer Verbindung zum Gerät aus. Alternativ können Sie auch auf „Durchsuchen“ (...) klicken und in der Anmeldeinformationen-Bibliothek neue Anmeldeinformationen erstellen.
In den Feldern Zeitüberschreitung und Anzahl der Wiederholungsversuche können Sie die Zeitdauer und die Anzahl der Wiederholungsversuche für den Computer anpassen, zu dem eine Verbindung hergestellt werden soll.
Klicken Sie auf OK.
Wählen Sie mit Hilfe der Navigationsstruktur die jeweilige MIB aus, die überwacht werden soll. Weitere Informationen zu den Eigenschaften/Werten sind unten im Dialogfeld zu sehen.
Klicken Sie auf OK und geben Sie anschließend im Dialogfeld „Neue Referenzvariable hinzufügen“ die OID in die Felder Leistungsindikator und Instanz ein.
Überprüfen Sie die Konfiguration und klicken Sie auf OK. Fügen Sie anschließend im Dialogfeld „Leistungsmonitor für Active-Script hinzufügen“ die Variable in die Referenzvariablenliste ein.
Fügen Sie Ihren Monitorcode in das Feld Skripttext ein.
Klicken Sie auf OK, um die Änderungen zu speichern.

So konfigurieren Sie einen Leistungsmonitor für WMI-Active-Script:

Klicken Sie auf im Dialogfeld „Leistungsmonitor für Active-Script hinzufügen“ und fügen Sie eine neue Variable in das Feld Referenzvariablen ein. Das Dialogfeld „Neue Referenzvariable hinzufügen“ wird angezeigt.
Geben Sie die entsprechenden Informationen ein:
- Variablenname. Geben Sie der Variable einen eindeutigen Namen.
- Beschreibung. (Optional) Geben Sie eine kurze Beschreibung für die Variable ein.
Wählen Sie das Optionsfeld WMI aus.
Öffnen Sie den MIB-Browser mit Auswählen.
Geben Sie in das Feld Leistungsindikatoren auswählen von Computer den Namen oder die IP-Adresse des Computers ein, zu dem eine Verbindung hergestellt werden soll. Alternativ können Sie auch auf „Durchsuchen“ (...) klicken und ein Gerät aus einer Liste auswählen.
Wählen Sie die Windows-Anmeldeinformationen zur Herstellung einer Verbindung zum Gerät aus. Alternativ können Sie auch auf „Durchsuchen“ (...) klicken und in der Anmeldeinformationen-Bibliothek neue Anmeldeinformationen erstellen.
Klicken Sie auf OK.
Wählen Sie mit Hilfe der Navigationsstruktur die jeweilige MIB aus, die überwacht werden soll. Weitere Informationen zu den Eigenschaften/Werten sind unten im Dialogfeld zu sehen.
Klicken Sie auf OK und geben Sie anschließend im Dialogfeld „Neue Referenzvariable hinzufügen“ die OID in die Felder Leistungsindikator und Instanz ein.
Überprüfen Sie die Konfiguration und klicken Sie auf OK. Fügen Sie anschließend im Dialogfeld „Leistungsmonitor für Active-Script hinzufügen“ die Variable in die Referenzvariablenliste ein.
Fügen Sie Ihren Monitorcode in das Feld Skripttext ein.
Klicken Sie auf OK, um die Änderungen zu speichern.

Zur Erinnerung

In Ihrem Monitorskript muss auch die Fehlerbehandlung enthalten sein. Ihr Skript benötigt entweder einen Wert, der sich mit Context.SetValue grafisch darstellen lässt, oder Sie müssen WhatsUp Gold über Context.SetResult mitteilen, dass das Skript fehlgeschlagen ist.
Context.GetReferenceVariable gibt „Null“ zurück, wenn die Abfrage aus gleich welchen Gründen erfolglos war.
Wenn gemäß Ihrem Skript weder SetValue noch SetResult aufgerufen wird, meldet das Skript keine Fehler und es werden keine Daten grafisch dargestellt.
Wird SetValue verwendet, ist SetResult nicht mehr notwendig, da SetResult bereits durch SetValue auf 0 oder „gut“ gesetzt wird.
Ergebnisse aus diesem Leistungsmonitor werden in den Dashboard-Berichten und den ausführlichen Berichten der benutzerdefinierten Leistungsmonitore angezeigt.
Fehler aus diesem Leistungsmonitor werden in das Fehlerprotokoll des Leistungsmonitors sowie EventViewer.exe aufgenommen.

Important: Bei der ersten Abfrage einer WMI-Referenzvariable, für die zur Errechnung des Mittelwerts (wie etwa „Prozessor\% Prozessorzeit“) zwei Abfragen erforderlich sind, wird „Null“ zurückgegeben.

Warning: Wir raten dringend davon ab, die Konfiguration eines Leistungsmonitors für das VoIP-Active-Script zu ändern; sollten Sie dennoch Änderungen vornehmen, werden bereits vorhandene VoIP-Konfigurationen vom VoIP-Setupdienstprogramm nicht erkannt.