{{indexmenu_n>5}}

====== Мониторинг по SNMP через службу snmpd ======

===== Описание =====
SNMP — протокол, позволяющий получать информацию о сервере СКАТ для централизованного мониторинга критически важных параметров. Для этого используется служба snmpd из состава операционной системы.\\
**Принцип работы:** по SNMP отправляется запрос на сервер, служба snmpd получает необходимую информацию и отправляет ее на сервер мониторинга. Сервер мониторинга эту информацию принимает и обрабатывает, после этого можно понять статус сервера — отследить, на каких уровнях находятся те или иные параметры и данные.

Пакет ''bngsnmp'' содержит скрипты, необходимые для формирования VENDOR ветки OID'ов для опроса по SNMP.\\
В основе лежит библиотека ''snmp_passpersist''. OID вендорской ветки: ''.1.3.6.1.4.1.43823''

Состав вендорской ветки:
  * статистика CPU, в т.ч. утилизация ядра процессами BNG;
  * количество нелегитимных дропов;
  * статистика дропов на диспетчере;
  * список доступности RADIUS серверов (**при использовании прокси или балансира в статистике будет указан этот прокси**);
  * количество DHCP абонентов — **при активном функционале**;
  * количество PPPoE, L2TP, PPP абонентов — **при активном функционале**;
  * список VRF и активных абонентов в каждом — **при активном функционале**;
  * статистика DPDK интерфейсов (количество пакетов, ошибок, уровень сигнала и т.п.);
  * статистика NAT (список профилей, список пулов, и количество трансляций на каждый публичный адрес) — **при активном функционале**;
  * список аппаратных модулей, установленных на материнской плате — **при наличии данной возможности у BMC контроллера**;
  * показатели с аппаратных сенсоров (напряжение, потребляемая мощность, FAN RPMs) — **при наличии данной возможности у BMC контроллера**;
  * утилизация пулов в DHCP сервере (поддерживается **только** KEA-DHCP сервер) — **при активном функционале**.

Данный скрипт также переопределяет стандартные ветки, добавляя статистику с DPDK интерфейсов:
  * ''.1.3.6.1.2.1.2.2.1'' — 32-битные счетчики
  * ''.1.3.6.1.2.1.31.1.1.1'' — 64-битные счетчики

При необходимости можно отключить переопределение — закомментировать или удалить следующие строки из ''/etc/snmp/snmpd.conf'':

<code bash>
pass_persist    .1.3.6.1.2.1.2.2.1      /usr/local/bin/bng_snmp/vaspp
pass_persist    .1.3.6.1.2.1.31.1.1.1   /usr/local/bin/bng_snmp/vaspphc
</code>

Файл MIB доступен после установки по пути: ''/usr/share/snmp/mibs/VASEXPERTS-MIB.txt''

===== Установка =====
  - Установка (net-snmp, net-snmp-utils будут установлены как зависимости): <code bash>yum install bngsnmp</code>
  - Конфигурация: <code bash>/bin/cp -f /etc/snmp/snmpd.conf.example /etc/snmp/snmpd.conf</code>
  - Перезапуск службы net-snmp: <code bash>systemctl restart snmpd</code>
  - Отключить selinux (в случае ошибки при запуске SNMP): <code bash>vi /etc/selinux/config
...
SELINUX=disabled
...</code>

===== Проверка работоспособности snmpd и вендорской ветки =====
Утилита snmpwalk позволяет проверить, приходят ли данные по SNMP

Команда для проверки работы SNMP:
<code bash>snmpwalk -v 2c -c nokiamon localhost -On .1.3.6.1.4.1.43823</code>
Система опрашивается раз в минуту, поэтому чаще, чем раз в минуту опрашивать не имеет смысла.

===== Как прочитать файл MIB =====
В случае, если необходимо увидеть файл MIB в графическом представлении, можно открыть его через MIB Browser. Там будет описана вся вендорская ветка и ее OID. \\ 
На примере ниже показано:
  - Файл вендорской ветки
  - Ее OID

{{:dpi:dpi_components:platform:mon_stat:mib_browser.png?nolink&800|}}

===== Известные ограничения =====
Поддержка on-stick девайсов доступна с версии 13.2-beta4.2