Сетевое управление

Сетевое управление (netmanagement) - это системный контекст, который предоставляет доступ к данным, относящимся ко всей работе пристроек/расширений сетевого управления. Он не отображается в видимой части контекстного дерева.

Плагин "Сетевое управление" использует SNMP, WMI  и драйверы устройств сетевого хоста в качестве основы сетевой связи.

Дополнительная информация

Информация о контексте

Тип контекста: networkManagement

Имя контекста: netmanagement

Описание контекста: сетевое управление

Путь к контексту: netmanagement

Маска контекста: netmanagement

Права доступа к контексту

[?]

Уровень

Описание

Отсутствует

Доступ не разрешен.

Наблюдатель

Обнаружение топологии сети.

Оператор

Тот же, что у Наблюдателя.

Менеджер

Отправка SNMP-ловушки.

Отправка Syslog-сообщения.

Отправка запросов Wake-on-LAN.

Просмотр статуса услуг.

Инженер

Тот же, что у Менеджера.

Администратор

Тот же, что у Менеджера.

Общие переменные (свойства)

[?]

У этого контекста нет общих переменных (свойств).

Общие функции

[?]

Отправить snmp-ловушку

Генерирует SNMP-уведомления (ловушки и сообщения), как описано в разделе Отправка SNMP-ловушек и сообщений.

Имя функции:

sendSnmpTrap

Права доступа:

доступно на уровне с правами доступа Менеджера

Записи ввода:

1

Формат ввода:

см. Отправка SNMP-ловушек и сообщений

Записи вывода:

0 (для ловушек) или 1 (для сообщений)

Формат вывода:

см. Отправка SNMP-ловушек и сообщений

Отправить syslog -сообщение

Отправляет Syslog-сообщение, как описано в разделе Отправка Syslog-сообщений.

Имя функции:

sendSyslogMessage

Права доступа:

доступно на уровне с правами доступа для Менеджера

Записи ввода:

1

Формат ввода:

см Отправка Syslog-сообщений

Записи вывода:

0

Формат вывода:

нет

Wake-on-lan

Активирует компьютер, отправляя ему специальное сообщение. См. Wake-on-LAN.

Имя функции:

executeWakeOnLAN

Права доступа:

доступно на уровне с правами доступа для Менеджера

Записи ввода:

1

Формат ввода:

см. Wake-on-LAN

Записи вывода:

0

Формат вывода:

нет

Получить информацию о процессе

Функция утилиты, используемая инструментарием для мониторинга процесса для получения данных (параметров или строки пути) о процессах.

Имя функции:

getProcessInfo

Права доступа:

доступно на уровне с правами доступа Менеджера

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

contextName

Строковый

Имя контекста устройства.

processName

Строковый

Имя процесса.

requestType

Целочисленный

0 чтобы получить пути процессов с заданным именем, отфильтрованным параметрами;

1 чтобы получить параметры процессов с заданным именем, отфильтрованным путем.

processFilter

Целочисленный

Строка фильтра, которую следует применить к параметрам или пути, в зависимости от заданного requestType.

Записи вывода:

0...не ограничено

Формат вывода:

Имя

Тип

Описание

value

Строковый

Имя контекста устройства.

description

Строковый

Путь процесса или строка параметров.

Статус сервисов

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

Имя функции:

servicesStatus

Права доступа:

Доступно на уровне с правами доступа Менеджера

Записи ввода:

0

Формат ввода:

нет

Записи вывода:

0...не ограничено

Формат вывода:

Динамический формат со следующими полями:

  • Поле типа String, именуемое "устройство" (содержащее путь к контексту)

  • Одно поле типа Color для каждого зарегистрированного сервиса, обозначающего свой статус

Получить snmp-значение

Функция “Получить snmp-значение“ (snmpGet) получает одно “необработанное“ значение с SNMP устройства. Функция отправляет один запрос SNMP GET для OID, обозначенного в параметрах входа и обрабатывает ответ SNMP агента как отдельное значение, конвертируя его в String.

Обратите внимание, что OID запрашиваются "как есть". Поэтому функция выдает ошибку 'Нет такого имени', если нет точного совпадения с одним из OID устройств. Это означает, что скалярные значения должны запрашиваться по OID, заканчивающемуся на ".0", в то время как таблицы могут быть прочитаны только по ячейкам, и каждый запрос должен включать полный индекс конкретной ячейки.

Обратите внимание на следующие примеры.

Примеры:

Выполнение SNMP Get с OID=1.3.6.1.2.1.1.1.0 возвращает Описание системы (sysDescr).
Выполнение SNMP Get с OID=1.3.6.1.2.1.1.1 приводит к ошибке 'Нет такого имени' из-за неполного OID (отсутствует суффикс '.0').
Выполнение SNMP Get с OID=1.3.6.1.2.1.2.2 приводит к ошибке 'Нет такого имени' из-за того, что неполный OID ссылается на целую таблицу (ifTable), а не на ячейку.
Выполнение SNMP Get с OID=1.3.6.1.2.1.2.1.2.1.1 возвращает описание (ifDescr, 1.3.6.1.2.1.2.2.1.2) 1-го (.1) сетевого интерфейса из ifTable.

Имя функции:

snmpGet

Права доступа:

Доступно на уровне с правами доступа Менеджера

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

oid

Строковый

OID для запроса.

settings

Таблица

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

Записи вывода:

0...не ограничено

Формат вывода:

Имя

Тип

Описание

name

Строковый

Имя запрашиваемой переменной SNMP (включая ее OID).

value

Строковый

Полученное значение, конвертированное в String.

Получить несколько snmp-значений

Функция "Получить несколько SNMP-значений" (snmpGetMulti) получает несколько "необработанных" значений с SNMP устройства. Функция отправляет один запрос SNMP GET каждому OID, обозначенному в параметрах входа и обрабатывает каждый ответ как отдельное значение, конвертируя его в String. Также см. комментарии и примеры к функции snmpGet.

Имя функции:

snmpGetMulti

Права доступа:

Доступно на уровне с правами доступа Менеджера

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

oids

Таблица

Таблица OID для запроса. Каждый ряд должен представлять один OID для запроса в первом столбце (по умолчанию называемом 'oid').

settings

Таблица

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

Записи вывода:

0...не ограничено

Формат вывода:

Имя

Тип

Описание

name

Строковый

Имя запрашиваемой переменной SNMP (включая ее OID).

value

Строковый

Полученное значение, конвертированное в String.

SNMP READ

Извлекает "полноценные" SNMP переменные из SNMP устройства. В отличие от SNMP Get, эта функция вызывает SNMP Walk для извлечения всех значений в пределах обозначенных OID и обрабатывает результаты вместе с метаданными из директории MIB-файлов с составлением полных таблиц.

Пример: Выполнение функции SNMP Read с OID=1.3.6.1.2.1.2.2 возвращает полное содержимое ifTable.

Имя функции:

snmpRead

Права доступа:

Доступно на уровне с правами доступа Менеджера

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

oids

Таблица

A Таблица OID для запроса. Каждый ряд должен представлять один OID для запроса в первом столбце (по умолчанию называемом 'oid').  

settings

Таблица

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

Записи вывода:

0...не ограничено

Формат вывода:

Имя

Тип

Описание

name

Строковый

Имя полученной переменной SNMP (включая ее OID).

value

Таблица

Значение переменной SNMP в виде таблицы.

Проверка связи (ping)

Отправляет запрос на проверку связи определенному хосту.

Имя функции:

ping

Права доступа:

Доступно на уровне с правами доступа Менеджера

Записи ввода:

1

Формат ввода:

Name

Type

Description

address

Строковый

IP адрес или имя хоста для ping.

packetDataSize

Целочисленный

Размер ICMP пакета данных (исключая заголовки).

pingCount

Целочисленный

Число ping запросов в течение каждой синхронизации (цикла опроса).

storageSize

Целочисленный

Количество пакетов, используемое для вычисления процента потери. Для расчета процента потери пакетов берутся последние результаты пинга в количестве, определенном данной настройкой.

offlineCriterion

Целочисленный

Количество последовательных оставшихся без ответа ping запросов, которое переведет сетевой хост в статус подключения 'нет подключения'.

timeout

Длинный целочисленный

Если ответ не получен по истечению данного времени, запрос ping считается оставшимся без ответа.

Записи вывода:

1

Формат вывода:

см. Результаты мониторинга пинга

Обнаружение сетевой топологии

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

Имя функции:

discoverTopology

Права доступа:

Доступно на уровне с правами доступа Менеджера

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

discoverTopologyMode

Строковый

  • Обновить полностью (по умолчанию),

  • Только новые,

  • Обновить существующие

discoverContextMask

Строковый

Маска контекста устройств, указывающая, какие устройства следует включить в обнаружение

arpEnabled

Булевский

Использовать ARP алгоритм

stpEnabled

Булевский

Использовать STP алгоритм

cdpEnabled

Булевский

Использовать CDP алгоритм

aftEnabled

Булевский

Использовать AFT алгоритм

lldpEnabled

Булевский

Использовать LLDP алгоритм

serverContext

Строковый

Путь контекста узла корневого сервера

Записи вывода:

0...не ограничено

Формат вывода:

Имя

Тип

Описание

discoveryStatus

Строковый

Статус обнаруженной связи:

  • Добавлено

  • Обновлено

  • Удалено

status

Строковый

Указывает статус связи:

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

  • Определенные пользователем связи видны на карте топологии, но никогда не редактируются и не удаляются в процессе обнаружения.

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

type

Строковый

К общим типам сетей относятся связи OSI уровня 2 или OSI уровня 3.

Пользовательский тип связи используется в случае нестандартной топологии.

source

Строковый

Контекст (устройство или группа) находящийся на локальном узле связи.

target

Строковый

Контекст (устройство или группа), с которым осуществляется связь.

sourceInterface

Целочисленный

Уникальный индекс сетевого интерфейса (индекс интерфейса для SNMP устройств) контекста источника.

sourceInterfaceId

Строковый

Идентификатор L3-связи контекста-источника (устройство или группа)

targetInterfaceId

Строковый

Идентификатор L3-связи целевого контекста (устройство или группа)

sourceType

Строковый

Тип контекста-источника (устройство или группа), определяет иконку контекста на карте топологии (возможные значения: маршрутизатор, сервер, принтер и т.д.).

targetType

Строковый

Тип целевого контекста (устройства или группы), определяет иконку контекста на карте топологии (возможные значения: маршрутизатор, сервер, принтер и т.д.).

sourceDescription

Строковый

Пользовательское описание L3-связи контекста-источника (устройство или группа)

targetDescription

Строковый

Пользовательское описание L3-связи контекста-цели (устройство или группа)

description

Строковый

Описание связи

linkId

Строковый

Идентификатор связи

Общие события

[?]

У этого контекста нет общих событий.