Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Настройка обмена данными между модулем и агентом

Настройка обмена данными между модулем SNMP Менеджер и агентами, которые модуль опрашивает и которые отправляют ему уведомления, выполняется в среде разработки Alpha.DevStudio.

Чтобы настроить обмен данными между модулем и агентом:

  • добавьте в Alpha.Server и настройте модуль SNMP Менеджер;
  • добавьте в проект и настройте агента SNMP, от которого будет получать данные SNMP Менеджер;
  • настройте обмен данными между модулем SNMP Менеджер и агентом;
  • при необходимости настройте параметры взаимодействия между менеджером и агентом;
  • примените конфигурацию Alpha.Server.

Порядок создания проекта и добавление Alpha.Server в проект описаны в документации на Alpha.DevStudio (раздел Знакомство с Alpha.DevStudio руководства пользователя).

Далее приведено описание настройки обмена данными между модулем SNMP Менеджер и агентами, работающими по протоколу SNMP.

Добавление и настройка

  1. Перейдите в Alpha.Domain → Узел Alpha.Domain и проверьте IP-адрес Адаптера Ethernet. IP-адрес адаптера должен соответствовать IP-адресу компьютера, на котором функционирует Alpha.Server.

  2. Перейдите в Alpha.Server. Добавьте модуль SNMP Менеджер из папки Коммуникационные модули панели элементов.

Настройте свойства модуля.

Свойство Описание
Параметры модуля
Настройки по умолчанию

Глобальные настройки модуля Настройки SNMP Менеджер с общими значениями параметров для группы агентов. Если глобальные настройки не указаны, то для каждого агента параметры настраиваются индивидуально.

Активность

Активность модуля при запуске/перезапуске Alpha.Server:

  • Да – модуль запущен;
  • Нет – модуль остановлен.

Управляется служебным сигналом Active.Set.

Отображаемое имя

Название модуля SNMP Менеджер для отображения в журнале работы модуля и в тегах служебных сигналов.

Если поле не заполнено, то используется значение по умолчанию – SNMP Manager.

Параметры журналирования
Вести журнал работы модуля

Ведение записи сообщений о работе модуля в журнал работы:

  • Да – вести журнал работы;
  • Нет – журнал работы не ведётся.

Управляется служебным сигналом FrameLogEnable.Set.

Размер журнала работы модуля, МБ

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

Значение по умолчанию – 10.

Количество дополнительных журналов работы

Количество файлов заполненных журналов работы модуля:

  • минимальное количество – 1;
  • максимальное количество – 255.

Значение по умолчанию – 1.

Уровень трассировки в журнал приложений

Типы сообщений, которые выводятся в журнал приложений:

  • Предупреждения и аварийные сообщения – логические ошибки и ошибки работы модуля. Предупреждения содержат некритичные ошибки. Аварийные сообщения информируют об ошибках, которые влияют на работоспособность сервера;
  • Информационные сообщения – предупреждения и аварийные сообщения, а также основная информация о работе модуля;
  • Отладочные сообщения – предупреждения и аварийные сообщения, основная и детальная информация о работе модуля.

Управляется служебным сигналом SystemLogTraceLevel.Set.

Значение по умолчанию – Информационные сообщения.

Общие
Имя Идентификатор модуля в конфигурации Alpha.Server, значение сервисного сигнала Id.

Добавление и настройка агента

Перед добавлением агента в Alpha.DevStudio установите и настройте приложение-агент на устройстве.

Настройка типа приложения для агента

  1. Перейдите в Определения в Обозревателе решений и добавьте в проект элемент Пространство имен. Задайте ему Имя, например, SNMP_Types.

  2. В пространстве имен SNMP_Types добавьте Тип приложения ApplicationType.

  3. Перейдите в Тип приложения ApplicationType и добавьте Логический объект. В свойствах логического объекта для параметра Имя укажите имя логического объекта, например, HDD_Storage.

  4. Перейдите в Логический объект HDD_Storage и из Панели элементов добавьте параметры, значения которых нужно получить от устройства. Например:

    Сигнал Тип Направление Описание

    StorageSize

    Int4 выход Общий объем жесткого диска.

    StorageUsed

    Int4 выход Объем занятого места на жестком диске.

    Добавленный логический объект с параметрами:

  5. В приложение ApplicationType из Панели элементов добавьте элемент Карта адресов SNMP:

  6. На элементе Карта адресов SNMP:

    1. Нажмите кнопку .
    2. Укажите место хранения карты адресов на диске в папке решения.
    3. Задайте имя карты адресов.
    4. Нажмите кнопку Открыть.

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

    Заполнить карту адресов нужно будет позже при настройке агента.

Добавление агента

Для добавления агента добавьте логический адаптер Агент SNMP и укажите адреса параметров устройства, на котором настроено приложение-агент.

Ниже описано добавление агента на компьютер, на котором установлен экземпляр Alpha.Server. Если устройство, на котором установлено приложение-агент и с которого нужно получать данные, не принадлежит типам Компьютер или Узел Alpha.Domain, то перейдите в устройство и начните добавление агента с пункта 2.

Чтобы добавить агента:

  1. Перейдите в Alpha.Domain → Узел Alpha.Domain и добавьте Исполняющий компонент.

    Перейдите в Исполняющий компонент.

  2. Добавьте экземпляр типа приложения:

  3. Добавьте логический адаптер Агент SNMP из Панели элементов:

  4. В свойствах логического адаптера укажите карту адресов, которая будет использоваться для этого адаптера:

Настройка агента

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

Свойство Описание
Общие
Карта адресов

Расположение карты адресов, которую будет использовать SNMP Менеджер при обмене данными с агентом.

Порт для опроса UDP-порт приложения-агента на устройстве для соединения с модулем SNMP Менеджер. По умолчанию используется порт 161.
Пароль для опроса Пароль для доступа к агенту. Значение по умолчанию – public.
Порт для уведомлений

Порт модуля SNMP Менеджер, на котором он ожидает получения trap-уведомлений. По умолчанию используется порт 162.

Пароль для уведомлений Пароль, который указан в trap-уведомлении. Значение по умолчанию – public.
Версия протокола Версия протокола SNMP. Возможные значения: SNMPv1, SNMPv2с, SNMPv3.
Имя Уникальное имя логического адаптера. Используется для отображения в списке агентов модуля SNMP Менеджер и в дереве объектов при просмотре статистических данных.

Настройте параметры SNMPv3, если используете эту версию протокола:

Свойство Описание
Параметры безопасности SNMP v3
Уровень безопасности

Уровень безопасности SNMP v3:

  • NoAuthNoPriv – без аутентификации и шифрования, данные передаются в открытом виде;
  • AuthNoPriv – аутентификация без шифрования;
  • AuthPriv – аутентификация и шифрование, максимальный уровень защищенности.
Тип аутентификации Должен совпадать с настройками устройства.
Тип шифрования Должен совпадать с настройками устройства.
Имя контекста

Имя контекста безопасности при использовании протокола SNMPv3. Контекст безопасности связывается с агентом и присутствует в конфигурации всех модулей SNMP Менеджер, которые взаимодействуют с этим агентом. Используется для разграничения доступа к нескольким физическим/логическим устройствам.

Если контекст безопасности не используется, то оставьте поле пустым.

Параметры опроса (SNMP v3) (должны совпадать с настройками устройства)
Имя пользователя Имя (идентификатор) пользователя на устройстве, от имени которого отправляются запросы.
Ключ аутентификации Ключ аутентификации пользователя для опроса. Длина ключа должна быть не менее 8-ми символов.
Ключ шифрования Ключ шифрования пользователя для опроса. Длина ключа должна быть не менее 8-ми символов.
Параметры уведомления (SNMP v3) (должны совпадать с настройками устройства)
Идентификатор приложения (EngineId) Приложение, которое посылает trap-уведомления.
Имя пользователя Имя (идентификатор) пользователя на устройстве, от имени которого отправляются trap-уведомления.
Ключ аутентификации Ключ аутентификации пользователя для уведомления. Длина ключа должна быть не менее 8-ми символов.
Ключ шифрования Ключ шифрования пользователя для уведомления. Длина ключа должна быть не менее 8-ми символов.

При использовании контекста безопасности для корректного разграничения доступа к нескольким физическим/логическим устройствам убедитесь, что комбинация значений параметров Имя контекста и Идентификатор приложения (EngineId) уникальна для каждого агента.

Ключи аутентификации и ключи шифрования для SNMPv3, а также пароли для опроса/уведомлений для SNMPv1 и SNMPv2c хранятся в файле конфигурации в зашифрованном виде.

Заполнение карты адресов

Заполните карту адресов для устройства, данные с которого будет передавать агент. Для этого откройте карту адресов, указанную в свойствах логического адаптера Агент SNMP, и настройте параметры для каждого сигнала.

Параметр Значение
Привязка

непосредственно

OID элемента

Указание на параметр:

  • OID параметра, значение которого записывается в сигнал. OID параметров опрашиваемого устройства содержатся в документации на устройство. Получение значения OID конкретного параметра возможно с помощью специальных утилит (MIB Browsers);
  • значение Any – указывается при необходимости получать только значения типа OctetString.
Индекс элемента массива Индекс элемента массива данных SNMP типа Sequence of <type>, значение которого записывается в сигнал. Так как в Alpha.Server нумерация индексов ведется с 0, то для получения значения элемента массива с индексом n указывается индекс n-1.
Композитный тип объекта

Содержание параметра, значение которого записывается в сигнал. Параметр используется для корректного отображения значения сигнала при получении: IP-адреса устройства, MAC-адреса устройства, даты и времени на устройстве. Принимает значения:

  • Дата и время;
  • Физический адрес;
  • IP адрес.
Способ получения данных

Способ получения данных от агента. Параметр принимает значения:

  • Только через опрос – запись значения в сигнал производится только через опрос;
  • Только через уведомления – запись значения в сигнал производится только через trap-уведомления;
  • Через опрос и уведомления – запись значения в сигнал производится через опрос и trap-уведомления (значение по умолчанию).

Пример заполненной карты адресов:

Настройка обмена данными с агентом

Настройка логических типов

  1. Вернитесь в созданное ранее пространство имен SNMP_Types и добавьте элемент Логический тип. В свойствах логического типа укажите:

    Свойство Описание
    Представляемый тип

    Добавленный ранее тип приложения – ApplicationType.

    Имя Имя логического типа.

  2. Перейдите в Логический тип и добавьте элемент Ссылка из папки Ссылки панели элементов. С помощью Ссылки в Логическом типе будет создано представление для объектов, находящихся в типе приложения, на которое указывает ссылка. В свойствах ссылки укажите:

    Свойство Описание
    Тип

    Имя добавленного ранее типа приложения – ApplicationType.

    Имя Имя логического типа.

  3. Добавьте элемент Объектная ссылка. Ссылка нужна для создания связи с добавленными сигналами. В свойствах объектной ссылки укажите:

    Свойство Описание
    Объект

    Имя объекта ссылки. Ссылку можно добавить на любой объект в типе приложения.

    Имя Имя объектной ссылки.

  4. В контекстном меню Объектной ссылки выполните команду Экспонировать входы и выходы, после чего в логическом объекте Alpha.Server будут созданы сигналы с теми же именами и типами, что и в устройстве, а также прорисованы связи.

В Логический тип дополнительно можно добавить служебные сигналы диагностики для определения доступности и активности канала связи с агентом. Добавление сигналов диагностики описано в документации на Alpha.DevStudio (раздел Диагностика устройств по SNMP руководства пользователя).

Добавление логических типов в приложение Alpha.Server

  1. Перейдите в Alpha.Server, куда ранее был добавлен модуль SNMP Менеджер, и добавьте Приложение:

  2. Перейдите в Приложение и добавьте Логический объект. В свойствах Логического объекта укажите:

    Свойство Описание
    Тип

    Логический тип, который представляет тип приложения.

    Представляемый объект Экземпляр типа приложения на устройстве, на котором установлено приложение-агент.
    Имя Имя логического объекта.

  3. Инициализируйте ссылку:

    • вызовите контекстное меню логического объекта и выполните команду Инициализировать все ссылки;
    • нажмите кнопку на панели инструментов или клавишу F5 на клавиатуре.

Настройка параметров взаимодействия между менеджером и агентом

Взаимодействие между менеджером и агентом выполняется согласно настройкам по умолчанию. Для изменения значений по умолчанию:

  1. На модуле SNMP Менеджер нажмите кнопку и укажите настроенный ранее логический адаптер агента.

  2. Выделите добавленный логический адаптер и настройте параметры взаимодействия с агентом.

Свойство Описание
Общие
SNMP Агент Уникальное имя логического адаптера для агента. Используется для отображения в списке агентов модуля SNMP Менеджер и в дереве объектов при просмотре статистических данных.
Параметры агентов
Интервал запроса данных, секунд

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

Значение по умолчанию – 1.

Интервал отклика на запрос, мс

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

Значение по умолчанию – 500.

Таймаут потери связи, с

В случае отсутствия данных, при превышении этого времени, соединение по каналу связи считается разорванным.

Значение по умолчанию – 3.

Таймаут потери связи по каналу, секунд

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

Значение по умолчанию – 3.

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

Сброс счетчика перезагрузок и времени последнего сеанса непрерывной работы устройства при потере связи с агентом, переход на отслеживание времени по OID. Применим при работе с протоколом SNMPv3 для агентов, которые некорректно подсчитывают перезагрузки и время работы.