Просмотр кода страницы Подключение к Zabbix

= Общая информация =
'''Zabbix''' — это система с открытым исходным кодом для мониторинга и управления сетью. Она используется для наблюдения за состоянием различных сетевых ресурсов и оборудования, таких как серверы, виртуальные машины, сетевые устройства и приложения.

Для работы с системами мониторинга, платформа Эра использует протокол SNMP версии 2c и в частности механизм SNMP Traps. В отличии от классического использования протокола SNMP, внешняя система не опрашивает платформу, вместо этого платформа сама передает данные для мониторинга внешней системе. Объем данных и параметры системы для передачи SNMP-трафика указываются в специализированной настройке мастер-домена.

По-умолчанию Zabbix не работает с механизмом SNMP Traps, его необходимо настроить перед подключением системы. 

Таким образом, выстраивется следующий алгоритм подключения Zabbix к платформе Эра:

# Настройка получения SNMP Traps в Zabbix
# Настройка отправки SNMP в мастер-домене
# Настройка узла сети и элементов данных (Host и Items) в Zabbix

Детали работы SNMP можно посмотреть на [https://vendor.era-platform.ru/docs/era/latest/manuals/health_monitoring/snmp_traps.html ресурсе Vendor].

= Настройка SNMP Traps в Zabbix =
Для настройки SNMP Traps будет необходим административный доступ к серверу Zabbix. В данном примере, будет рассмотрена работа с Zabbix под управлением Debian 12.

Если данный механизм уже активирован на вашем сервере Zabbix, можно переходить сразу к настройке SNMP в платформе Эра.

Первым шагом, необхдимо установить пакеты snmp, snmptrapd и библиотеку snmp для perl:<syntaxhighlight lang="bash">
sudo apt install snmp snmptrapd

sudo apt-get install libsnmp-perl

perl -MCPAN -e 'install Net::SNMP'

systemctl restart snmptrapd

systemctl enable snmptrapd
</syntaxhighlight>Далее, необходимо скачать и установить perl-скрипт обработки snmp traps с помощью zabbix<syntaxhighlight lang="bash">
curl -o /usr/bin/zabbix_trap_receiver.pl https://git.zabbix.com/projects/ZBX/repos/zabbix/raw/misc/snmptrap/zabbix_trap_receiver.pl

chmod +x /usr/bin/zabbix_trap_receiver.pl
</syntaxhighlight>


Для следующего шага, необходимо определиться со строкой community. <blockquote>'''SNMP community''' (сообщество SNMP) — это строка текста, выполняющая роль "пароля" в протоколе Simple Network Management Protocol (SNMP) версии 1 и 2c. Она используется для определения уровня доступа клиента (управляющей станции) к данным управляемого SNMP устройства (агента), такого как маршрутизатор, хост или свитч.

Существует несколько типов community, которые определяют права доступа:

1. Community public: Обычно используется как строка по умолчанию для доступа "только для чтения". С этим уровнем доступности можно считывать данные с устройства, но не изменять их.

2. Community private: Строка community, обеспечивающая доступ "чтение и запись". С ней можно как читать данные с устройства, так и менять его настройки.

3. Custom Community (настраиваемое сообщество): Это любые настраиваемые строки community, которые могут быть заданы администратором для конкретных нужд безопасности и управления.</blockquote>

После того, как установлены все компоненты и скрипты, необходимо провести их конфигурацию
{| class="wikitable"
!Файл
!Необходимые изменения
!Пример
|-
|/usr/bin/zabbix_trap_receiver.pl
|Установить значение $SNMPTrapperFile = '/tmp/zabbix_traps.tmp';
|[[Файл:Zabbox trap reciever.png|мини]]
|-
|/etc/snmp/snmptrapd.conf
|Разрешить доступ необходимому community. В данном случае используется community era. 
'''<u>Последней строчкой</u>''' вписать perl do "/usr/bin/zabbix_trap_receiver.pl";
|[[Файл:Snmptrapd.conf.png|мини]]
|-
|/etc/zabbix/zabbix_server.conf
|Раскомментировать строчку StartSNMPTrapper, задать значение 1.
Задать значение SNMPTrapperFile=/tmp/zabbix_traps.tmp
|[[Файл:Zabbix server.conf.png|мини]]
|}


После завершения настройки необходимо перезагрузить оба сервиса.<syntaxhighlight lang="bash">
systemctl restart zabbix-server

systemctl restart snmptrapd
</syntaxhighlight>При использовании Zabbix Proxy, или каких-либо особенных случаев настройки, рекомендуется обращаться к [https://www.zabbix.com/documentation/current/en/manual/config/items/itemtypes/snmptrap официальной документации Zabbix].

Также, рекомендуется к просмотру [https://www.youtube.com/watch?v=Mv5mQ2uQcZ4 данное видео по настройке SNMP Traps].



После того, как все настройки были произведены и применены, можно также загрузить и подключить MIB-файл платформы Эра.

Для получения MIB-файла, вы должны быть авторизованы в мастер-домене платформы. В браузере достаточно открыть страницу с адресом https://[адрес_платформы]/rest/v1/master/snmp/mib
[[Файл:ERA-MIB.png|мини|ERA-MIB]]
Полученный файл необходимо передать на сервер Zabbix, рекомендуется каталог /usr/share/snmp/mibs/

Далее, необходимо внести изменения в файл /etc/snmp/snmp.conf

В раздел mibs необходимо добавить путь к файлу (пример в скриншоте)

После сохранения изменений, необходимо перезагрузить Zabbix:<syntaxhighlight lang="bash">
systemctl restart zabbix-server
</syntaxhighlight>

= Настройка SNMP в мастер-домене =
[[Файл:Настройки мастер-домена.png|мини|Настройки мастер-домена]]
Работа SNMP определяется параметрами мастер-домена.

Для изменения параметров необходимо войти в приложение Настройки в мастер-домене, далее во вкладке Домен найти раздел Параметры.
[[Файл:Snmp options.png|мини|snmp_options]]


За работу SNMP отвечает параметр snmp_options, содержащий JSON следующего вида:<syntaxhighlight lang="json">
{
  "community": "communityname",
  "enabled": true,
  "excluded_types": [],
  "ip": "",
  "level": "info",
  "rate_interval_min": 1,
  "system_state_excluded_keys": [],
  "system_state_interval_min": 5,
  "types": [
    "*"
  ]
}
</syntaxhighlight>Для активации SNMP необходимо указать значение enabled=true, ip-адрес настроенного zabbix, необходимую строку community (например, era как в предыдущем шаге), а также задать уровень логирования:

* emergency (0)
* alert (1)
* critical (2)
* error (3)
* warning (4)
* notice (5)
* info (6)
* debug (7)

Детальное описание всех параметров snmp_options можно найти на [https://vendor.era-platform.ru/docs/era/latest/entities/domain/setting.html#snmp_options ресурсе Vendor].

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

= Обработка SNMP в Zabbix =
Zabbix предоставляет широкий набор возможностей по мониторингу систем, в данном разделе будет рассмотрены только базовые действия, необходимые для получения событий от платформы. Детальная настройка мониторинга и триггеров зависит от конкретных потребностей и в рамках данной статьи рассмотрена не будет.