Диагностика модуля RSserver

Важно

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

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

sudo -i

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

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

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

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

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

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

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

  • project-syncer.log - файл сбора сообщений службы синхронизации проектов;

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

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

  • trs_requests.log - файл сбора сообщений о попытках пользователей авторизоваться и получить TRS машину через веб-интерфейс TRS или RSclient. Логируются как успешные, так и неуспешные попытки. Включение или отключение процесса логирования определяется параметром allow_getvm_log секции broker в конфигурационном файле rs_server.conf. Подробное описание параметра allow_getvm_log доступно в разделе «Файл конфигурации». Записи в файле имеют следующий формат:

    [ системное время RSserver ] - идентификатор запроса - источник подключения (web/cli) - логин пользователя (который осуществляет попытку подключения) - статус получения IP-адреса TRS машины (OK/Error, а также детали ошибки) - ID групп, к которым принадлежит пользователь - проект подключения - IP-адрес пользователя
    
  • profiler.log - файл сбора сообщений с идентификаторами запросов к API и aos-rs-worker на каждом этапе:

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

Примечание

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

Отладка модуля RSserver

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

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

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

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

    openstack aos tests --names rs_server --modules
    Диагностика модулей началась.
    Запускаем тесты для: rs_server
    
    +-------------------------+-------------------------------------------------------------------------------------+
    | Дата и время запуска    | Пт 14 02 2020 13:22:21 MSK                                                          |
    +-------------------------+-------------------------------------------------------------------------------------+
    | Версия OpenStack        | Train (17.0.9)                                                                      |
    +-------------------------+-------------------------------------------------------------------------------------+
    | Имя хоста               | test.stand.loc                                                                      |
    +-------------------------+-------------------------------------------------------------------------------------+
    | Дистрибутив             | Debian 10                                                                           |
    +-------------------------+-------------------------------------------------------------------------------------+
    | Управляющие узлы        | 1                                                                                   |
    +-------------------------+-------------------------------------------------------------------------------------+
    | Вычислительные узлы     | 2                                                                                   |
    +-------------------------+-------------------------------------------------------------------------------------+
    | База данных             | mysql  Ver 15.1 Distrib 10.1.20-MariaDB, for Linux (x86_64) using  EditLine wrapper |
    +-------------------------+-------------------------------------------------------------------------------------+
    | Источник пакетов        | N\A                                                                                 |
    +-------------------------+-------------------------------------------------------------------------------------+
    
    ================
    RSserver
    Версия: 2.3.0 (актуальная: текущая)
    Лицензия: 07-002-972fb12437f60c4a5411 (действительна до 31.09.2019 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 rs api                             |УСПЕХ   |                                                              |
    +--+----------------------------------------+--------+--------------------------------------------------------------+
    |13|test rs server api connection           |УСПЕХ   |                                                              |
    +--+----------------------------------------+--------+--------------------------------------------------------------+
    |14|test rs server api service registration |УСПЕХ   |                                                              |
    +--+----------------------------------------+--------+--------------------------------------------------------------+
    |15|test rs server systemd services         |УСПЕХ   |                                                              |
    +--+----------------------------------------+--------+--------------------------------------------------------------+
    |16|test rs web                             |УСПЕХ   |                                                              |
    +--+----------------------------------------+--------+--------------------------------------------------------------+
    Запущено 16 за 47.537сек.
    УСПЕХ (успешно=15, неудачно=0, ошибок=0)
    
    ====
    ИТОГ
    ===
    Запущено 16 за 47.537сек.
    УСПЕХ (успешно=15, неудачно=0, ошибок=0)
    

Примечание

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