Диагностика модуля RSserver¶
Логирование служб, используемых модулем 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
на каждом этапе:- получение запроса;
- создание задачи;
- запуск задачи;
- ожидание мьютекса;
- старт мьютекса;
- отправка запроса в Nova на создание виртуальной машины;
- получение ответа (профилирование процесса получения виртуальной машины).
Также логируется общее время ожидания мьютекса для каждого запроса. Запись сообщений в данный файл осуществляется только в режиме
DEBUG
.
Примечание
С описанием процесса логирования, предоставляемого платформой OpenStack, можно ознакомиться в соответствующем разделе официальной документации.
Отладка модуля RSserver¶
В случае возникновения проблем в работе модуля существуют следующие пути решения:
Выставить уровень логирования в значение DEBUG, что позволит зафиксировать сообщения о событиях в лог-файлах с максимальной детализацией для диагностики и решения проблем.
Запустить утилиту самодиагностики модуля
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».