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 %

Plusieurs actions ont des champs de saisie de données individuels dans leurs boîtes de dialogue de configuration qui non seulement prennent en charge, mais fournissent également une liste de pourcentages variables à utiliser.

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.

See Also

Création d'actions et de stratégies d'action

Types d'action intégrés

Instructions pour la création de stratégies d'action

Bibliothèque d'actions récurrentes