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

Установка¶

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

   mkdir -p /tmp/tionix_rollback/monitor
   pip freeze > /tmp/tionix_rollback/monitor/pip_before.txt
   

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

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

   openstack tnx db list -n tnx_monitor > /tmp/tionix_rollback/monitor/migrations.txt
   

   Где:

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

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

   • из репозитория Python-пакетов:

     # Ubuntu, CentOS:
     pip install tionix-monitor
     

   • из репозитория RPM пакетов:

     # ALT Linux 7:
     apt-get -y install python-module-tionix_monitor
     
     # CentOS:
     yum -y install python-tionix_monitor
     

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

   pip freeze > /tmp/tionix_rollback/monitor/pip_after.txt
   

Настройка¶

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

   openstack tnx configure -n tnx_monitor tnx_client
   

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

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

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

   cp /etc/tionix/monitor.yaml.example /etc/tionix/monitor.yaml
   

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

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

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

   openstack tnx db migrate -n tnx_monitor
   

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

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

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

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

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

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

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

   systemctl daemon-reload
   systemctl enable tionix-monitor-api.service
   systemctl start tionix-monitor-api.service
   systemctl enable tionix-monitor-nova-listener.service
   systemctl start tionix-monitor-nova-listener.service
   

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

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

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

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

Настройка Zabbix¶

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

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

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

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

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

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

DB:
    NAME: 'tionix_monitor'
LOG_LEVEL: 'INFO'
CEILOMETER_METERS:
    - 'memory.usage'
    - 'cpu_util'
    - 'disk.read.requests.rate'
    - 'disk.write.requests.rate'
    - 'disk.read.bytes.rate'
    - 'disk.write.bytes.rate'
    - 'disk.latency'
    - 'disk.iops'
    - 'network.incoming.bytes.rate'
    - 'network.outgoing.bytes.rate'
    - 'network.incoming.packets.rate'
    - 'network.outgoing.packets.rate'

ZABBIX:
    HOST: 'localhost'
    ADMIN_USER: 'Admin'
    PASSWORD: 'zabbix'
    HOST_GROUP: 'tionix'

ENABLE_CEILOMETER_MONITORING: True
ENABLE_ZABBIX_MONITORING: True
ENABLE_BACKUP: False
MONITOR_API_LISTEN: '0.0.0.0'
MONITOR_API_LISTEN_PORT: 9363

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

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

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

   openstack tnx db list -n tnx_monitor
   openstack tnx db migrate -n tnx_monitor --migration 14
   

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

   cd /tmp/tionix_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
   pip uninstall -r pip_uninstall.txt
   pip install -r pip_install.txt