Variables %

Vous pouvez personnaliser le message d'une action et le contenu de certaines configurations à l'aide de variables %.

Note: Pour plus d'informations sur les tables de variables spécifiques du Centre d'alerte WhatsUp Gold, voir la rubrique Variables % du Centre d'alerte.

Recommandations importantes lors de l'utilisation de variables %

Variables d'analyseur actif

Description

%ActiveMonitor.Argument

Numéro d'instance SNMP. Cette variable est utilisée uniquement quand une action est associée directement à un analyseur actif, plutôt qu'à un périphérique global.

%ActiveMonitor.Comment

Valeur de chaîne qui coïncide avec les commentaires associés à l'analyseur. Cette variable est utilisée uniquement quand une action est associée directement à un analyseur actif, plutôt qu'à un périphérique global. Notez que, dans le cas d'analyseurs actifs d'interface, la découverte utilise cette variable % pour renseigner automatiquement avec la description de l’interface.

%ActiveMonitor.Name

 

Nom de l'analyseur actif qui a déclenché l'action. Cette variable est utilisée uniquement quand une action est associée directement à un analyseur actif, plutôt qu'à un périphérique global.

%ActiveMonitor.NetworkInterfaceAddress

Adresse IP de l'interface réseau. Cette variable est utilisée uniquement quand une action est associée directement à un analyseur actif, plutôt qu'à un périphérique global.

%ActiveMonitor.Payload

Charge utile renvoyée par un analyseur active WMI, Exchange, SQL, SNMP ou de script actif. Cette variable est utilisée uniquement quand une action est associée directement à un analyseur actif, plutôt qu'à des périphériques globaux.

Pour les analyseurs actifs de script actif, la charge utile est le texte transmis à la méthode SetResult() dans le script.

%ActiveMonitor.State

 

État actuel de l'analyseur, par exemple « Indisponible au moins 5 minutes ». Cette variable est utilisée uniquement quand une action est associée directement à un analyseur actif, plutôt qu'à un périphérique global.

Variables de périphérique

Description

%Device.ActiveMonitorDownNames

Liste des périphériques indisponibles utilisant le nom abrégé si disponible.

%Device.ActiveMonitorDownNamesCSV

Liste des noms d'analyseurs actifs indisponibles séparés par une virgule.

%Device.ActiveMonitorUpNames

Noms de service complets de tous les services surveillés disponibles d'un périphérique.

%Device.Address

Adresse IP (des propriétés du périphérique).

%Device.Attribute.[Nom attribut]

Renvoie un attribue des informations SNMP disponibles pour le périphérique, comme le nom de contact. Pour spécifier l'attribut, ajoutez le nom de catégorie (voir ci-dessous) à la fin de la variable. Par exemple : %Device.Attribute.Contact renvoie le nom de contact.

Catégories par défaut :

  • *. Renvoie tous les attributs.
  • Info1. Chemin de mise à niveau à partir de la v8
  • Info2. Chemin de mise à niveau à partir de la v8
  • Contact. Informations de contact depuis SNMP
  • Emplacement. Informations d'emplacement depuis SNMP
  • Description. Informations de description depuis SNMP.
  • Personnalisation. Si vous avez créé un attribut personnalisé, vous pouvez utiliser son nom dans la variable %.

Exemple :

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

Tip: Pour éviter toute erreur d'analyse, veillez à inclure un espace ou un saut de ligne à la fin de la variable % intégrée (autrement dit, après le nom d'attribut).  

%Device.DatabaseID

Renvoi l'ID de base de données d'un périphérique.

%Device.DisplayName

Nom complet (provenant de l'onglet Général des Propriétés du périphérique).

%Device.HostName

Nom d'hôte (provenant de l'onglet Général des Propriétés du périphérique)

%Device.Notes

Notes. (Les notes proviennent de l'onglet Notes des Propriétés du périphérique.)

%Device.Role

Rôle du périphérique principal, comme affiché dans l'interface des propriétés du périphérique.

%Device.RoleGUID

Identifiant global unique pour le rôle principal affecté au périphérique.

%Device.SNMPOid

Identificateur d'objet SNMP.

%Device.State

Description de l'état du périphérique (par exemple, « Indisponible au moins 2 minutes » ou « Disponible au moins 5 minutes »).

%Device.BestState

Description de l'état du périphérique contenant le « meilleur » état du périphérique. Par exemple, si un périphérique n'a jamais été en état Actif en raison d'analyses défaillantes, le meilleur état pourrait être Indisponible.

%Device.WorstState

Description de l'état du périphérique contenant l'état « le plus défavorable » du périphérique. Par exemple, si un périphérique n'a jamais été en état Indisponible en raison d'analyses défaillantes, le plus mauvais état peut être Actif.

%Device.Status

Nom de l'analyseur actif, précédé de l'ID d'état du périphérique.

Exemple :

10 | DNS.

Valeurs de l'ID d'état du périphérique :

0 = non démarré, 1 = en pause, 2 = annulé, 3 = en cours d'exécution, 4 = terminé, 5 = résolution du nom d'hôte, 6 = recherche du type,
7 = analyse des informations d'identification SNMP, 8 = analyse des informations d'identification Windows, 9 = analyse des détails du périphérique, 10 = analyse d'analyseurs personnalisés, 12 = analyse d'analyseurs personnalisés, 13 = analyse de l'hôte VMWare du périphérique, 14 = analyse des informations d'identification SSH,
15 = analyse de couche 2, 16 = calcul de la topologie de couche 2, 17 = analyse sans fil, 18 = analyse des interfaces réseau,
19 = recherche de périphériques en double, 21 = analyse des adresses connues

%Device.ManualMaintenanceReason

Chaîne personnalisée que vous indiquez ainsi que la raison pour laquelle un périphérique est passé à l'état Maintenance.

%Device.Type

Type de périphérique (provenant de l'onglet Général des Propriétés du périphérique).

Variables d'analyseur passif

Description

%PassiveMonitor.DisplayName

Nom de l'analyseur tel qu'il apparaît dans la Bibliothèque d'analyseurs passifs.

%PassiveMonitor.LoggedText

Description détaillée de l'événement. (Interceptions SNMP SNMP : renvoie le texte complet des interceptions SNMP.) (Entrées du journal Windows : renvoie les informations contenues dans les entrées du Journal des événements Windows.) (Entrées Syslog : renvoie le texte contenu dans le message Syslog.)

%PassiveMonitor.Payload.*

Charge utile générée par un analyseur passif.

%PassiveMonitor.Payload.EventType

Type d'analyseur passif (Syslog, Événement Windows ou Interception SNMP).

%PassiveMonitor.Payload.LogicalSource

Affiche l'adresse IP logique du périphérique.

%PassiveMonitor.Payload.PhysicalSource

Affiche l'adresse IP physique du périphérique.

Variables du système

Description

%System.Date

Affiche la date du système (Utilise le même format que le système d'exploitation sur lequel tourne le serveur WhatsUp Gold).

%System.DisplayNamesDownDevices

Affiche le nom des périphériques avec des analyseurs indisponibles.

%System.DisplayNamesDownMonitors

 

Affiche le nom d'un périphérique et chaque analyseur indisponible sur ce périphérique. Le format de la réponse est 'nom périphérique':'analyseur 1','analyseur 2','...'

Exemple : ARNOR : FTP, HTTPS, Ping

%System.DisplayNamesUpDevices

Noms complets des périphériques disponibles

%System.DisplayNamesUpMonitors

Affiche le nom d'un périphérique et chaque analyseur disponible sur ce périphérique. Le format de la réponse est 'nom périphérique':'analyseur 1','analyseur 2','...'

Exemple : ARNOR : FTP, HTTPS, Ping

%System.InstallDir

Affiche le répertoire où WhatsUp Gold est installé.

%System.NumberofDownDevices

Nombre de périphériques indisponibles sur votre réseau.

%System.NumberOfDownMonitors

Nombre d'analyseurs indisponibles sur votre réseau.

%System.NumberofUpDevices

Nombre de périphériques disponibles sur votre réseau.

%System.NumberOfUpMonitors

Nombre d'analyseurs disponibles sur votre réseau.

%System.Time

Heure actuelle du système. Le format est hh:mm:ss.