Процентные переменные

С помощью процентных переменных можно настроить сообщения действий и определенное содержимое конфигураций.

Note: Информацию о таблице переменных центра оповещения WhatsUp Gold см. в теме Процентные переменные центра оповещения.

Важные рекомендации при использовании процентных переменных

В диалоговых окнах конфигурации некоторых действий предусмотрены отдельные поля ввода данных, которые не только поддерживают процентные переменные, но и предоставляют список доступных переменных.

Переменные активного монитора

Описание

%ActiveMonitor.Argument

Номер экземпляра SNMP. Это используется только тогда, когда действие связано непосредственно с активным монитором, а не с устройством в целом.

%ActiveMonitor.Comment

Строчное значение, совпадающие с комментариями, связанными с монитором. Это используется только тогда, когда действие связано непосредственно с активным монитором, а не с устройством в целом. Обратите внимание, что в случае с активными мониторами интерфейса, для автоматического заполнения описания интерфейса обнаружение использует процентную переменную.

%ActiveMonitor.Name

 

Имя активного монитора, вызвавшего запуск действия. Это используется только тогда, когда действие связано непосредственно с активным монитором, а не с устройством в целом.

%ActiveMonitor.NetworkInterfaceAddress

IP-адрес сетевого интерфейса. Это используется только тогда, когда действие связано непосредственно с активным монитором, а не с устройством в целом.

%ActiveMonitor.Payload

Полезные данные, возвращаемые WMI, Exchange, SQL, SNMP или активным монитором активного сценария. Это используется только тогда, когда действие связано непосредственно с активным монитором, а не с устройствами в целом.

Для активных мониторов активного сценария полезные данные являются текстом, передаваемым в метод SetResult() в сценарии.

%ActiveMonitor.State

 

Текущее состояние монитора, например «Неактивен, как минимум, 5 минут» Это используется только тогда, когда действие связано непосредственно с активным монитором, а не с устройством в целом.

Переменные устройства

Описание

%Device.ActiveMonitorDownNames

Список неактивных служб с использованием сокращенного имени, если имеется.

%Device.ActiveMonitorDownNamesCSV

Перечень имен активных мониторов в неактивном состоянии, разделенных запятой.

%Device.ActiveMonitorUpNames

Полные имена серверов всех активных наблюдаемых служб устройства.

%Device.Address

IP-адрес (из свойств устройства).

%Device.Attribute.[Attribute Name]

Возвращает атрибут из информации SNMP, доступной для устройства, например, имя лица для контактов. Чтобы указать атрибут, добавьте имя категории (из списка ниже) в конец переменной. Например: %Device.Attribute.Contact, возвращает имя лица для контактов.

Стандартные категории:

  • *. Возвращает все атрибуты
  • Info1. Путь к обновлению от v8
  • Info2. Путь к обновлению от v8
  • Контакт. Контактная информация от SNMP
  • Расположение. Информация о расположении от SNMP
  • Описание. Информация описания от SNMP
  • Настраиваемый. Если вы создали настраиваемый атрибут, можно указать имя этого настраиваемого атрибута в процентной переменной.

Пример:

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

Tip: Во избежание ошибок анализа вставляйте пробел или новую строку в конце встроенной процентной переменной (другими словами после имени атрибута).  

%Device.DatabaseID

Возвращает ID базы данных устройства.

%Device.DisplayName

Отображаемое имя (из свойств устройства Общие)

%Device.HostName

Имя узла (из свойств устройства Общие)

%Device.Notes

Примечания. (Примечания из свойств устройства Примечания)

%Device.Role

Основная роль устройства, отображаемая в интерфейсе свойств устройства.

%Device.RoleGUID

Уникальный глобальный идентификатор основной роли, назначенной устройству.

%Device.SNMPOid

Идентификатор объекта SNMP.

%Device.State

Описание состояния устройства (например, «Неактивен, как минимум, 2 минуты» или «Активен, как минимум, 5 минут»)

%Device.BestState

Описание состояния устройства с «наилучшим» состоянием устройства. Например, если устройство никогда не находилось в состоянии Активен из-за отказа мониторов, то наилучшим состоянием может быть Неактивен.

%Device.WorstState

Описание состояния устройства с «наихудшим» состоянием устройства. Например, если устройство никогда не находилось в состоянии Неактивен из-за отказа мониторов, то наихудшим состоянием может быть Активен.

%Device.Status

Показывает имя активного монитора, предваренное id состояния устройства.

Пример:

10 | DNS.

Значения ID состояния устройства:

0 = Не запущен, 1 = Пауза, 2 = Отменен, 3 = Выполняется, 4 = Завершен, 5 = Разрешение имени узла, 6 = Поиск типа,
7 = Сканирование учетных данных SNMP, 8 = Сканирование учетных данных Windows, 9 = Сканирование подробностей устройства, 10 = Сканирование настраиваемых мониторов, 12 = Сканирование настраиваемых мониторов, 13 = Сканирование узла устройства VMWare, 14 = Сканирование учетных данных SSH,
15 = Сканирование Уровня 2, 16 = Вычисление топологии Уровня 2, 17 = Сканирование беспроводных устройств, 18 = Сканирование сетевых интерфейсов,
19 = Проверка наличия дублирующихся устройств, 21 = Сканирование известных адресов

%Device.ManualMaintenanceReason

Настраиваемая строка, в которой указывается причина перевода устройства в состояние Обслуживание.

%Device.Type

Тип устройства (из свойств устройства Общее)

Переменные пассивного монитора

Описание

%PassiveMonitor.DisplayName

Имя монитора как оно появляется в Библиотеке пассивных мониторов.

%PassiveMonitor.LoggedText

Подробное описание события. (Ловушки SNMP - Возвращает полный текст ловушки SNMP.) (Записи журнала Windows - Возвращает информацию, содержащуюся в записях журнала событий Windows.) (Записи Syslog - Возвращает весь текст, содержащийся в сообщениях системного журнала Syslog.)

%PassiveMonitor.Payload.*

Полезные данные, создаваемые пассивным монитором.

%PassiveMonitor.Payload.EventType

Тип пассивного монитора (системный журнал, события Windows или ловушка SNMP)

%PassiveMonitor.Payload.LogicalSource

Показывает логический IP-адрес устройства.

%PassiveMonitor.Payload.PhysicalSource

Показывает физический IP-адрес устройства.

Системные переменные

Описание

%System.Date

Отображение системной даты (используется формат операционной системы, в которой работает сервер WhatsUp Gold).

%System.DisplayNamesDownDevices

Показывает имена устройств с неактивными мониторами

%System.DisplayNamesDownMonitors

 

Показывает имена устройства и каждого монитора, неактивного на этом устройстве. Формат отклика следующий: 'имя устройства':'монитор 1','монитор 2','...'

Пример: ARNOR: FTP, HTTPS, Ping

%System.DisplayNamesUpDevices

Отображает имена активных устройств

%System.DisplayNamesUpMonitors

Показывает имена устройства и каждого монитора, активного на этом устройстве. Формат отклика следующий: 'имя устройства':'монитор 1','монитор 2','...'

Пример: ARNOR: FTP, HTTPS, Ping

%System.InstallDir

Отображает каталог, в который установлена программа WhatsUp Gold

%System.NumberofDownDevices

Количество неактивных устройств в сети

%System.NumberOfDownMonitors

Показывает количество неактивных мониторов в сети

%System.NumberofUpDevices

Количество активных устройств в сети

%System.NumberOfUpMonitors

Показывает количество активных мониторов в сети

%System.Time

Текущее системное  время. Формат следующий: чч:мм:сс

See Also

Создание действий и политик действий

Встроенные типы действий

Рекомендации для создания политик действий

Библиотека повторяющихся действий