Prozentvariablen

Sie können den Meldungstext einer Aktion und bestimmte Konfigurationsinhalte mit Prozentvariablen anpassen.

Note: Eine Tabelle der Variablen für WhatsUp Gold AlertCenter finden Sie im Thema AlertCenter-Prozentvariablen.

Wichtige Richtlinien für den Einsatz von Prozentvariablen

Bei mehreren Aktionen gibt es einzelne Datenfelder in den Konfigurationsdialogen, die Prozentvariablen unterstützen und eine Liste der verfügbaren Variablen enthalten.

Variablen für aktive Monitore

Beschreibung

%ActiveMonitor.Argument

Nummer der SNMP-Instanz. Wird nur verwendet, wenn eine Aktion nur mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist.

%ActiveMonitor.Comment

Zeichenkettenwert, der den Kommentaren der Monitorbeschreibung entspricht. Wird nur verwendet, wenn eine Aktion direkt mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist. Hinweis: Bei aktiven Schnittstellenmonitoren verwendet die Erkennung diese Prozentvariable, um die Schnittstellenbeschreibung automatisch zu befüllen.

%ActiveMonitor.Name

 

Der Name des aktiven Monitors, der eine Aktion ausgelöst hat. Wird nur verwendet, wenn eine Aktion nur mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist.

%ActiveMonitor.NetworkInterfaceAddress

IP-Adresse für die Netzwerkschnittstelle. Wird nur verwendet, wenn eine Aktion nur mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist.

%ActiveMonitor.Payload

Die Payload, die von einem aktiven WMI-, Exchange-, SQL- oder Active-Script-Monitor ausgegeben wurde. Wird nur verwendet, wenn eine Aktion direkt mit einem aktiven Monitor, nicht mit den Geräten als Ganzen verknüpft ist.

Für Active-Script-Monitore ist die Payload der Text, der an die Methode SetResult() im Skript weitergereicht wird.

%ActiveMonitor.State

 

Aktueller Status des Monitors, z. B. „Mindestens 5 min nicht erreichbar“ Wird nur verwendet, wenn eine Aktion direkt mit einem aktiven Monitor, nicht mit dem Gerät als Ganzem verknüpft ist.

Gerätevariablen

Beschreibung

%Device.ActiveMonitorDownNames

Liste der nicht erreichbaren Dienste mit abgekürztem Namen (falls verfügbar).

%Device.ActiveMonitorDownNamesCSV

Namensliste der nicht erreichbaren aktiven Monitore, mit Komma getrennt.

%Device.ActiveMonitorUpNames

Vollständige Dienstnamen aller erreichbaren überwachten Dienste auf einem Gerät.

%Device.Address

IP-Adresse (aus den Geräteeigenschaften).

%Device.Attribute.[Attribute Name]

Gibt ein Attribut aus den für das Gerät verfügbaren SNMP-Informationen aus (z. B. Kontaktname). Sie können das Attribut genauer definieren, indem Sie den Kategorienamen (s. u.) an die Variable anhängen. Beispiel: %Device.Attribute.Contact gibt den Kontaktnamen aus.

Standardkategorien:

  • *. Alle Attribute ausgeben
  • Info1. Upgrade-Pfad von Version 8
  • Info2. Upgrade-Pfad von Version 8
  • Contact. Kontaktinformationen aus SNMP
  • Standort. Standortinformationen aus SNMP
  • Beschreibung. Beschreibungsinformationen aus SNMP
  • Benutzerdefiniert. Wenn Sie ein benutzerdefiniertes Attribut erstellt haben, können Sie den Namen dieses benutzerdefinierten Attributs in der Prozentvariable verwenden.

Beispiel:

%Device.Attribute.Phone
%Device.Attribute.RackPosition

Tip: Stellen Sie zur Vermeidung von Parsing-Fehlern sicher, dass ein Leerzeichen oder ein Zeilenumbruch am Ende der gesamten eingebetteten Prozentvariable eingeführt wird (d. h. nach dem Attributnamen).  

%Device.DatabaseID

Gibt die Datenbank-ID eines Geräts aus.

%Device.DisplayName

Anzeigename (von der Registerkarte „Allgemein“ in den Geräteeigenschaften)

%Device.HostName

Hostname (von der Registerkarte „Allgemein“ in den Geräteeigenschaften)

%Device.Notes

Kommentare. (Kommentare aus den Geräteeigenschaften > Kommentare)

%Device.Role

Primäre Geräterolle, die auch in den Geräteeigenschaften angezeigt wird.

%Device.RoleGUID

Global Unique Identifier (globale eindeutige ID, GUID) für die primäre Rolle, die dem Gerät zugewiesen wurde.

%Device.SNMPOid

SNMP-Objektkennung.

%Device.State

Beschreibung des Gerätestatus (zum Beispiel „Mindestens 2 min nicht erreichbar“ oder „Mindestens 5 min erreichbar“)

%Device.BestState

Beschreibung des Gerätestatus mit dem „besten“ Zustand des Geräts. Beispiel: Wenn ein Gerät sich aufgrund fehlgeschlagener Monitore nie im Zustand Erreichbar befunden hat, wäre der beste Zustand Nicht erreichbar.

%Device.WorstState

Beschreibung des Gerätestatus mit dem „schlechtesten“ Zustand des Geräts. Beispiel: Wenn ein Gerät sich nie aufgrund fehlgeschlagener Monitore im Zustand Nicht erreichbar befunden hat, wäre der schlechteste Zustand Erreichbar.

%Device.Status

Die ID des Gerätestatus, gefolgt vom Namen des aktiven Monitors, der eine Aktion ausgelöst hat.

Beispiel:

10 | DNS.

Werte für die ID des Gerätestatus:

0 = Nicht gestartet, 1 = Angehalten, 2 = Abgebrochen, 3 = Wird ausgeführt, 4 = Abgeschlossen, 5 = Hostname wird aufgelöst, 6 = Suche nach Typ,
7 = SNMP-Anmeldeinformationen werden erkannt, 8 = Windows-Anmeldeinformationen werden erkannt, 9 = Gerätedetails werden erkannt, 10 = Benutzerdefinierte Monitore werden erkannt, 12 = Benutzerdefinierte Monitore werden erkannt, 13 = Geräte-VMWare-Host wird erkannt, 14 = SSH-Anmeldeinformationen werden erkannt,
15 = Schicht-2-Suchlauf, 16 = Schicht-2-Topologie wird berechnet, 17 = WLAN-Suchlauf, 18 = Netzwerkschnittstellen werden erkannt,
19 = Prüfung auf doppelt vorhandene Geräte, 21 = Suchlauf für bekannte Adressen

%Device.ManualMaintenanceReason

Benutzerdefinierte Zeichenkette, in dem der Grund angegeben werden kann, warum ein Gerät in den Zustand Wartung versetzt wurde.

%Device.Type

Gerätetyp (von der Registerkarte „Allgemein“ in den Geräteeigenschaften)

Variablen für passive Monitore

Beschreibung

%PassiveMonitor.DisplayName

Der Name des Monitors aus der Bibliothek passiver Monitore.

%PassiveMonitor.LoggedText

Detaillierte Ereignisbeschreibung. (SNMP-Traps – gibt den vollständigen SNMP-Trap-Text aus.) (Windows-Protokolleinträge – Gibt die Informationen in den Windows-Ereignisprotokolleinträgen aus.) (Syslog-Einträge – Gibt den Text der Syslog-Meldung aus.)

%PassiveMonitor.Payload.*

Von einem passiven Monitor generierte Payload.

%PassiveMonitor.Payload.EventType

Die Art des passiven Monitors (Syslog, Windows-Ereignis oder SNMP-Trap)

%PassiveMonitor.Payload.LogicalSource

Die logische IP-Adresse des Geräts.

%PassiveMonitor.Payload.PhysicalSource

Die physische IP-Adresse des Geräts.

Systemvariablen

Beschreibung

%System.Date

Systemdatum anzeigen. (Das Format entspricht dem Format des Betriebssystems, auf dem der WhatsUp Gold-Server ausgeführt wird.)

%System.DisplayNamesDownDevices

Zeigt die Namen von Geräten mit nicht erreichbaren Monitoren an.

%System.DisplayNamesDownMonitors

 

Zeigt den Namen eines Geräts und jeden nicht erreichbaren Monitor auf diesem Gerät an. Das Format der Antwort lautet 'Gerätename':'Monitor 1','Monitor 2','...'

Beispiel: ARNOR: FTP, HTTPs, Ping

%System.DisplayNamesUpDevices

Zeigt die Namen von erreichbaren Geräten an

%System.DisplayNamesUpMonitors

Zeigt den Namen eines Geräts und jeden erreichbaren Monitor auf diesem Gerät an. Das Format der Antwort lautet 'Gerätename':'Monitor 1','Monitor 2','...'

Beispiel: ARNOR: FTP, HTTPs, Ping

%System.InstallDir

Zeigt das Verzeichnis an, in dem WhatsUp Gold installiert ist.

%System.NumberofDownDevices

Die Anzahl nicht erreichbarer Geräte im Netzwerk

%System.NumberOfDownMonitors

Die Anzahl nicht erreichbarer Monitore im Netzwerk

%System.NumberofUpDevices

Die Anzahl erreichbarer Geräte im Netzwerk

%System.NumberOfUpMonitors

Die Anzahl erreichbarer Monitore im Netzwerk

%System.Time

Die aktuelle Systemzeit. Das Format lautet hh:mm:ss

See Also

WhatsUp Gold-Hilfe – Sprachen

Einführung in WhatsUp Gold

Erkennung

Geräterollen

Anmeldeinformationen

Abbildungen

Geräte

Monitore

Dashboards

Aktionen und Alarme

AlertCenter-Bibliotheken

Berichte

Protokolle

Log Management

WhatsUp Gold-Agents

WLAN

Virtual

Anwendungen

Speicher und Cloud

Netzwerkdatenverkehrsanalyse

Konfigurationsmanagement

Tools

Einstellungen

MIBs

Benutzer und Benutzergruppen

Admin-Konsole

Skalierbarkeitspoller

Failover

Distributed

SMS-Aktionsbenachrichtigung

Direkt-SMS-Benachrichtigung

E-Mail-Benachrichtigung

Benachrichtigungsrichtlinien verwalten

Eskalationsplan visualisieren

Bibliothek der geplanten Berichte

Systemstatus und eigenschaften

Wählen von Bürozeiten

Datumsbereich definieren

Aktivieren von Ereignis-Listenern für WhatsVirtual (VMware)

Aktivieren von Ereignis-Listenern für WhatsVirtual (Hyper-V)

Visualisieren, Drucken, Teilen und Exportieren

Senden von Berichten und Protokollen per E-Mail

Protokoll- und Berichtdaten exportieren

Berichte teilen

Einstellungen für Schnittstellenberichte

Spaltensortierung und -auswahl

Zeile filtern und suchen

Berichtseinstellungen für Netzwerk-Datenverkehr

Planen der Wartung

Netzwerkschnittstellen

Netzwerkschnittstelle hinzufügen/bearbeiten

Active Directory durchsuchen

LDAP-Anmeldeinformationen testen

Globale SMTP-Einstellungen

SMS-Provider

SMS-Provider-Details

Computer auswählen

Aktive E-Mail-Monitore – erweiterte Eigenschaften

Tools: Schicht-2-Trace

IP/MAC-Adresssuche

Verwenden von E-Mail-Benachrichtigungs-Einstellungen

Gerät auswählen

Start-Gerätegruppe auswählen

Einführung

Anmeldeinformationen für Active Directory/LDAP einrichten

Cisco ACS-Anmeldeinformationen einrichten

Prozentvariablen für die Erkennung

Multi-Feldänderung – Aktiver Monitor – Eigenschaften

AlertCenter-Prozentvariablen

Aktionen für passive Monitore einrichten

Überwachen der Anwendungsleistung

Monitore konfigurieren – Einstellungen für Windows-Ereignisprotokoll

Dialogfenster „SNMP-MIB-Browser“

Passiver Monitor – Eigenschaften

Optionen für die Suchlaufwiederholung

JMX Browser

Abhängigkeiten – Überblick

Betriebssystem-Bibliothek

JSONPath-Abfragen und der JSON-Pfadassistent

Editor für Filter für dynamische Gruppen

Favoriten in WhatsUp Gold

Urheberrechtsvermerk