Лог-файлы платформы
VMmanager сохраняет информацию о работе сервисов в лог-файлы (журнальные файлы, журналы). Данные из лог-файлов могут быть использованы для диагностики работы платформы.
Перечень лог-файлов
Основные лог-файлы
Основные лог-файлы сервисов VMmanager хранятся в контейнере vm_box в директории /var/log/. Обычно имя лог-файла совпадает с названием сервиса. Например, лог-файл сервиса vmwatch называется vmwatch.log.
Имя файла | Содержимое |
---|---|
Общие сервисы | |
vm_writer.log |
|
vm_reader.log | API-запросы, выполненные методом GET |
monitor.log | сервис мониторинга ВМ и узлов кластера |
run_script.log | запуск скриптов |
vmctl.log |
|
vmwatch.log | события libvirt, синхронизация состояния ВМ |
Операции с ВМ | |
check_storage.log | проверка хранилищ ВМ |
connect_storages.log | подключение хранилищ ВМ |
disk_resize.log | операции по изменению дисков ВМ |
gosockify.log | сервис проксирования доступа к ВМ по VNC |
host.log | создание и удаление ВМ |
host_action.log | запуск, остановка, перезапуск ВМ |
host_change_password.log | смена root-пароля для ВМ |
host_firewall.log | настройка файрвола |
host_image_create.log | создание образов ВМ |
host_image_delete.log | удаление образов ВМ |
host_migration.log | миграция ВМ |
host_redefine.log | изменение параметров ВМ, установка пароля VNC |
host_snapshot.log | операции со снимками ВМ |
host_source_copy.log | загрузка и копирование образов ВМ и шаблонов ОС |
image_relocate.log | перемещение образов ВМ |
iso.log | загрузка и подключение ISO-образов |
uploader.log | загрузка ISO-образов |
websockify.log | сервис доступа к ВМ по VNC |
Операции с LXD-контейнерами | |
lxdconsole.log | клонирование LXD-контейнеров |
lxd_init.log | создание LXD-контейнеров |
Операции с узлами кластера | |
hawatch.log | микросервис hawatch. Подробнее см. в статье Принцип работы отказоустойчивых кластеров |
lxd_node_info.log | сбор информации об узлах LXD-кластера |
network_configure.log node_network.log | конфигурация сети на узле кластера |
node_create/{node_id}.log | сбор информации о добавлении узлов кластера и ошибках добавления |
node_info.log | сбор информации об узле кластера (данные об ОС, диске и т.д.) |
Установка платформы
Лог установки платформы сохраняется в файл /opt/ispsystem/vm/install.log.
Различные сервисы
Функция | Контейнер | Путь к файлу |
---|---|---|
Лицензирование | license | stdout контейнера |
Сервис уведомлений | msgsender | /var/log/msgsender_reader.log /var/log/msgsender_writer.log |
Почтовые уведомления о создании, переустановке ОС, смене пароля ВМ | msgsender | /var/log/email.log |
Работа Telegram-бота. Подробнее см. в статье Отправка уведомлений в Telegram | msgsender | /var/log/telegram.log |
Cбор информации об аптайме узла кластера, версиях QEMU, libvirt | nodewatch | /var/log/nodewatch.log |
Миграция из VMmanager 5 | importer | /var/log/importer.log |
Миграция адресного пространства | ipmgr | /var/log/ip_ipmgr5_proxy.log |
Синхронизация с каталогом LDAP | ldap | /var/log/isp_ldap.log |
Выполнение последовательностей запросов | batch | stdout контейнера |
Выдача SSL-сертификатов | input | /var/log/nginxctl.log |
Балансировщик | balancer | /var/log/balancer.log Подробнее см. в статье Балансировщик |
Лог-файлы на узле кластера
Функция | Путь к файлу |
---|---|
Сбор метрик для статистики | /var/log/gomon.log |
Сервис ha-agent. Подробнее см. в статье Принцип работы отказоустойчивых кластеров | /var/log/ha-agent.log |
Работа с логами
Скопировать лог-файл из контейнера
Чтобы скопировать лог-файл из контейнера в текущую директорию, выполните команду:
Пример команды
Просмотр лог-файлов в контейнере
Перейдите в нужный контейнер:
BASHПример команды
BASHПросмотрите лог-файл стандартными утилитами Linux. Например, cat, tail, less и т.д.
Пример команды
BASHЧтобы просмотреть логи конкретной задачи:
- В интерфейсе платформы перейдите в Задачи → выберите задачу → скопируйте значение request_id.
Выполните команду:
CODE
Выйдите из контейнера:
BASH
Просмотр лог-файлов через stdout
Для некоторых сервисов не создаются отдельные лог-файлы. Логи этих сервисов записываются в stdout. Чтобы просмотреть такие логи, выполните команду:
Пример команды: Посмотреть последние 100 строк лога контейнера vm_box, созданные за последние 60 минут
Сбор логов платформы
Чтобы собрать все лог-файлы платформы в одной директории:
- Подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
Создайте bash-скрипт logs_collect.sh следующего содержания:
BASHЗапустите скрипт:
BASH
Лог-файлы будут сохранены в директорию /home/logs/, архив с логами — в директорию /home/.
Логирование в journald
По умолчанию в платформе отключено логирование в системной службе journald. Чтобы включить логирование:
- Подключитесь к серверу с платформой по SSH.
Создайте файл патча /opt/ispsystem/vm/journald.yaml с содержимым:
CODEПримените патч:
BASH
Может быть полезно
Связанные статьи: