Установка и настройка¶

Установка¶

sudo -i

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

   mkdir -p /tmp/rollback/monitor
   pip3 freeze > /tmp/rollback/monitor/pip_before.txt
   

   После чего в каталоге /tmp/rollback/monitor будет находиться файл pip_before.txt с перечнем установленных приложений.

2. Также сохраните версии миграции:

   openstack aos db list -n monitor > /tmp/rollback/monitor/migrations.txt
   

   Где:

   • /tmp/rollback/monitor/ - директория файла;
   • migrations.txt - наименование файла с версиями миграций.

3. Установите пакет Monitor:

   pip3 install monitor
   

4. Сохраните список установленных пакетов после установки для возможности отката изменений:

   pip3 freeze > /tmp/rollback/monitor/pip_after.txt
   

Настройка¶

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

   openstack aos configure -n monitor
   

2. Создайте каталог для логов с нужными правами:

   mkdir -p /var/log/aos/monitor
   chown -R aos:aos /var/log/aos/monitor
   

3. Скопируйте образец конфигурационного файла, при использовании нестандартных параметров отредактируйте их (подробнее см. Файл конфигурации):

   cp /etc/aos/monitor.conf.example /etc/aos/monitor.conf
   

4. Создайте базу данных на примере MySQL, настройте права, тип базы и остальные параметры:

   # Зайдите в базу данных, используя пароль пользователя root
   mysql -uroot -p
   # Создайте базу данных monitor
   CREATE DATABASE monitor;
   # Дайте пользователю права на чтение, редактирование, выполнение любых действий над всеми таблицами базы данных monitor
   GRANT ALL PRIVILEGES ON monitor.* TO 'aos'@'localhost' IDENTIFIED BY 'password';
   GRANT ALL PRIVILEGES ON monitor.* TO 'aos'@'%' IDENTIFIED BY 'password';
   # Осуществите выход из базы данных
   

5. Отредактируйте секцию [database] конфигурационного файла etc/aos/monitor.conf, например:

   [database]
   url = mysql+pymysql://aos:password@tst.stand.loc:3306/monitor?charset=utf8
   

6. Выполните синхронизацию базы данных:

   openstack aos db migrate -n monitor
   

7. Добавьте пользователя в RabbitMQ:

   rabbitmqctl add_user aos password
   rabbitmqctl add_vhost aos
   rabbitmqctl set_permissions -p aos aos ".*" ".*" ".*"
   rabbitmqctl set_permissions aos ".*" ".*" ".*"
   

8. Создайте пользователя в OpenStack для API сервисов:

   openstack user create --domain default --project service --project-domain default --password password --or-show aos
   

9. Назначьте пользователю роль service:

   openstack role add --user aos --user-domain default --project service --project-domain default service
   

10. Включите и запустите службы systemd:

    systemctl daemon-reload
    systemctl enable aos-monitor-api.service
    systemctl start aos-monitor-api.service
    systemctl enable aos-monitor-listener.service
    systemctl start aos-monitor-listener.service
    

11. Создайте сервис Monitor API:

    openstack service create --name monitor --description "Monitor Service" monitor
    

12. Создайте точки входа:

    openstack endpoint create --region RegionOne monitor internal http://controller:9363
    openstack endpoint create --region RegionOne monitor admin http://controller:9363
    openstack endpoint create --region RegionOne monitor public http://controller:9363
    

Настройка Zabbix¶

Настройка системы мониторинга Zabbix для работы с модулем Monitor.

Авторизация¶

Перейдите по адресу веб-приложения Zabbix и, используя свои учетные данные, авторизуйтесь в сервисе:

Окно авторизации¶

Файл конфигурации¶

Конфигурационный файл представлен в ini формате и состоит из следующих секций и параметров:

[DEFAULT]
enable_ceilometer_monitoring = true
enable_zabbix_monitoring = true
enable_backup = false
ceilometer_meters =
    memory.usage,
    cpu,
    network.incoming.bytes,
    network.outgoing.bytes,
    network.incoming.packets,
    network.outgoing.packets

[api]
port = 9363
logfile = /var/log/aos/monitor/monitor-api.log

[database]
url = mysql+pymysql://aos:password@localhost:3306/monitor

[listener]
logfile = /var/log/aos/monitor/listener.log

[nova_listener]
logfile = /var/log/aos/monitor/nova-listener.log
nova_rabbit_vhost = /

[zabbix]
url = http://localhost/zabbix
username = Admin
password = zabbix
host_group = aos

План восстановления¶

В случае неудачной установки или обновления модуля Monitor выполните возврат к исходному состоянию:

1. Сравните версии миграций в файле /tmp/rollback/monitor/migrations.txt с текущими. При наличии отличий произведите миграцию на предыдущую версию. Пример миграции:

   openstack aos db list -n monitor
   openstack aos db migrate -n monitor --migration 14
   

2. Произведите возврат к предыдущему состоянию пакетов:

   cd /tmp/rollback/monitor
   diff --changed-group-format='%>' --unchanged-group-format='' pip_before.txt pip_after.txt > pip_uninstall.txt
   diff --changed-group-format='%<' --unchanged-group-format='' pip_before.txt pip_after.txt > pip_install.txt
   pip3 uninstall -r pip_uninstall.txt
   pip3 install -r pip_install.txt