Диагностика модуля TIONIX.VDIserver¶

Логирование служб, используемых модулем TIONIX.VDIserver¶

Логирование происходит с помощью модуля logging.

По умолчанию, файл логов находится в директории /var/log/tionix/vdi-server/.

В каталоге находятся следующие файлы:

• vdi-server-api.log - файл сбора сообщений службы tionix-vdi-server-api;

• vdi-broker-api.log - файл сбора сообщений службы tionix-vdi-broker-api;

• keystone-listener.log - файл сбора сообщений службы tionix-vdi-keystone-listener;

• project-syncer - файл сбора сообщений службы tionix-vdi-project-syncer;

• user-syncer - файл сбора сообщений службы tionix-vdi-user-syncer;

• nova-listener.log - файл сбора сообщений синхронизации виртуальных машин между базой данных службы Nova и базой данных TIONIX.VDIserver;

• worker.log - файл сбора сообщений асинхронных задач модуля;

• tionix_lntmov.log - файл сбора сообщений о попытках пользователей авторизоваться и получить VDI машину через веб-интерфейс VDI или TIONIX.VDIclient. Логируются как успешные, так и неуспешные попытки. Включение или отключение процесса логирования определяется параметром ALLOW_GETVM_LOG в конфигурационном файле vdi_server.yaml. Подробное описание параметра ALLOW_GETVM_LOG доступно в разделе «Файл конфигурации». Записи в файле имеют следующий формат:

  [ системное время VDI сервера ] - идентификатор запроса - источник подключения (web/cli) - логин пользователя (который осуществляет попытку подключения) - статус получения IP-адреса VDI машины (OK/Error, а также детали ошибки) - ID групп, к которым принадлежит пользователь - проект подключения - IP-адрес пользователя
  

• profiler.log - файл сбора сообщений с идентификаторами запросов к API VDI и tnx_vdi_worker на каждом этапе:

  • получение запроса;
  • создание задачи;
  • запуск задачи;
  • ожидание мьютекса;
  • старт мьютекса;
  • отправка запроса в Nova на создание виртуальной машины;
  • получение ответа (профилирование процесса получения виртуальной машины).

  Также логируется общее время ожидания мьютекса для каждого запроса. Запись сообщений в данный файл осуществляется только в режиме DEBUG.

Отладка модуля TIONIX.VDIserver¶

В случае возникновения проблем в работе модуля существуют следующие пути решения:

1. Выставить уровень логирования в значение DEBUG, что позволит зафиксировать сообщения о событиях в лог-файлах с максимальной детализацией для диагностики и решения проблем.

2. Запустить утилиту самодиагностики модуля openstack tnx tests.

   Пример использования:

   openstack tnx tests --names tnx_vdi_server --modules
   Диагностика модулей TIONIX началась.
   Запускаем тесты для: tnx_vdi_server
   
   +-------------------------+-------------------------------------------------------------------------------------+
   | Дата и время запуска    | Пт 30 апр 2021 13:22:21 MSK                                                         |
   +-------------------------+-------------------------------------------------------------------------------------+
   | Версия OpenStack        | Victoria (22.2.0)                                                                   |
   +-------------------------+-------------------------------------------------------------------------------------+
   | Имя хоста               | test.stand.loc                                                                      |
   +-------------------------+-------------------------------------------------------------------------------------+
   | Дистрибутив             | AlmaLinux 8.4                                                                       |
   +-------------------------+-------------------------------------------------------------------------------------+
   | Управляющие узлы        | 1                                                                                   |
   +-------------------------+-------------------------------------------------------------------------------------+
   | Вычислительные узлы     | 2                                                                                   |
   +-------------------------+-------------------------------------------------------------------------------------+
   | База данных             | mysql  Ver 15.1 Distrib 10.3.28-MariaDB, for Linux (x86_64) using readline 5.1      |
   +-------------------------+-------------------------------------------------------------------------------------+
   | Источник пакетов        | rpm-centos.tionix.ru                                                                |
   +-------------------------+-------------------------------------------------------------------------------------+
   | Версия tionix-licensing | 3.0.0                                                                               |
   +-------------------------+-------------------------------------------------------------------------------------+
   
   ================
   TIONIX.VDIserver
   Версия: 3.0.0 (актуальная: текущая)
   Лицензия: 07-002-972fb12437f60c4a5411 (действительна до 31.09.2021 03:00:00)
   ================
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |N |Название теста                          |Статус  |Причина неудачи                                               |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |1 |test apache config enabled              |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |2 |test apache config existence            |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |3 |test config file existence              |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |4 |test connection to keystone             |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |5 |test connection to nova                 |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |6 |test license validity                   |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |7 |test migrations applied                 |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |8 |test profiler log file accesses         |ПРОПУЩЕН|Тест актуален только в случае, если в LOG_LEVEL указан DEBUG. |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |9 |test registered celery tasks            |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |10|test registered tasks to schedule       |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |11|test request vm log file accesses       |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |12|test vdi api                            |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |13|test vdi server api connection          |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |14|test vdi server api service registration|УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |15|test vdi server systemd services        |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   |16|test vdi web                            |УСПЕХ   |                                                              |
   +--+----------------------------------------+--------+--------------------------------------------------------------+
   Запущено 16 за 47.537сек.
   УСПЕХ (успешно=15, неудачно=0, ошибок=0)
   
   ====
   ИТОГ
   ===
   Запущено 16 за 47.537сек.
   УСПЕХ (успешно=15, неудачно=0, ошибок=0)