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

Важно

Все команды выполняются только от суперпользователя.

Режим суперпользователя:

sudo -i

Логирование служб, используемых модулем 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 на каждом этапе:

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

Примечание

С описанием процесса логирования, предоставляемого платформой OpenStack, можно ознакомиться в соответствующем разделе официальной документации.

Отладка модуля 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)
    

Примечание

Подробное описание утилиты доступно в разделе «Утилита самодиагностики». Подробное описание кодов ошибок модуля доступно в разделе «Описание ошибок обращений к VDI server».