Модуль Icinga для vSphere

Модуль Icinga для vSphere позволяет легко добавить окружение  vSphere. Модуль позволяет подключить как отдельный ESXi сервер так и сервер vCenter.

Для работы модуля рекомендуется использовать PHP 7.x, Icinga web 2 версии 2.5 и выше, база данных MySQL 5.6 и выше или MariaDB 5.5.3 и выше, модули php: php-soap, php-pcntl, php-posix.

Так-же требуются следующие icinga модули: ipl 0.4.0 или выше, incubator 0.5.0 или выше, reactbundle 0.7.0 или выше.

 

Удовлетворение зависимостей для модуля

apt install php-soap git

 

Установка ipl:

MODULE_NAME=ipl
MODULE_VERSION=v0.4.0
REPO="https://github.com/Icinga/icingaweb2-module-$"
MODULES_PATH="/usr/share/icingaweb2/modules"
git clone ${REPO} "$/$" --branch "$"
icingacli module enable "$"

 

Установка reactbundle:

MODULE_NAME=reactbundle
MODULE_VERSION=v0.7.0
REPO="https://github.com/Icinga/icingaweb2-module-$"
MODULES_PATH="/usr/share/icingaweb2/modules"
git clone ${REPO} "$/$" --branch "$"
icingacli module enable "$"

 

Установка модуля Icinga vspheredb

Установка модуля:

ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
REPO_URL="https://github.com/Icinga/icingaweb2-module-vspheredb"
TARGET_DIR="${ICINGAWEB_MODULEPATH}/vspheredb"
git clone "${REPO_URL}" "${TARGET_DIR}"

 

Создание БД и пользователя (заменить пароль на желаемый):

mysql -e "CREATE DATABASE vspheredb CHARACTER SET 'utf8mb4' COLLATE utf8mb4_bin;
 GRANT ALL ON vspheredb.* TO vspheredb@localhost IDENTIFIED BY 'ПАРОЛЬ';"

 

Прописываем БД в конфигурацию Icinga:

Отредактируем файл resources.ini

nano /etc/icingaweb2/resources.ini

Добавим созданную выше БД:

[vSphereDB]
type = "db"
db = "mysql"
host = "localhost"
; port = 3306
dbname = "vspheredb"
username = "vspheredb"
password = "ПАРОЛЬ"
charset = "utf8mb4"

 

Создадим файл конфигурации для модуля vspheredb:

mkdir /etc/icingaweb2/modules/vspheredb
nano /etc/icingaweb2/modules/vspheredb/config.ini

Добавим в созданный файл следующие строки

[db]
resource = "vSphereDB"

Активируем модуль vspheredb

icingacli module enable vspheredb

После активации модуля необходимо войти в Web-интерфейс Icinga2 и в появившемся пункте Virtualization (VMware) создать схему БД нажав соответствующую кнопку.

• 
•  

 

Создание сервиса:

После успешного создания схемы необходимо создать атозапускаемый сервис:

Отредактируйте файл, указав имя пользователя, от которого запущена Icinga в поле User

cd /usr/share/icingaweb2/modules/vspheredb/
nano contrib/systemd/icinga-vspheredb.service

создаем сервис:

cd /usr/share/icingaweb2/modules/vspheredb/
cp contrib/systemd/icinga-vspheredb.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable icinga-vspheredb
systemctl start icinga-vspheredb

 

Добавление сервера:

Перед добавлением сервера возможно потребуется перезагрузка Icinga2, если в окне добавления серверов пусто.

Добавление сервера происходит через веб-интерфейс - для этого создайте пользователя с правами Read-Only на сервере ESXi или vCenter и заполните необходимые поля:

• 
• 
•  

На этом настройка модуля закончена.

 

Возможные проблемы

Daemon keep-alive is outdated

Спустя некоторое время может перестать обновляться информация, на вкладке Daemon может появится надпись Daemon keep-alive is outdated

В статусе службы icinga-vspheredb может висеть сообщение Running DB cleanup (this could take some time), или же служба упала с результатом watchdog

Необходимо сделать следующее

nano /etc/systemd/system/icinga-vspheredb.service

Заменить WatchdogSec=10 на WatchdogSec=360 и сохранить

systemctl daemon-reload
systemctl start icinga-vspheredb