Плагин для просмотра журналов ВМ

Предупреждение

Раздел в процессе разработки!

Общая информация

В разделе Виртуальные машины-Просмотр логов пользователь может просматривать записи журналов виртуальных машин. Этот раздел доступен в меню, если включен UI-плагин Log View, который работает на основе бэкенд-плагина Log View. Это API плагин разработанный для обработки и просмотра журналов виртуальных машин. Он использует стек ELK для организации хранения журналов виртуальных машин. Экспорт журналов из виртуальной машины в хранилище организуется с помощью Filebeat. Плагин разработан и протестирован только с Apache CloudStack 4.11.1.

Чтобы подключить раздел Просмотр логов, нужно сначала установить бэкенд-плагин Log View, а затем подключить UI-плагин через файл конфигурации config.json .

Установка плагина

Полная инструкция по установке бэкенд-плагина Log View представлена на странице описания плагина.

Чтобы подключить UI-плагин Log View, необходимо:

  1. Установить бэкенд-плагин в CloudStack.
  2. Установить необходимые компоненты: ElasticSearch, Filebeat, Logstash, Curator.
  3. Подключить UI-расширение через файл конфигурации config.json.

Просмотр логов в UI

После успешного подключения плагина в UI вы увидите раздел Просмотр логов в разделе Вируальные машины основного меню слева. В этом разделе можно просматривать записи журналов ВМ за указанный период времени или в режиме реального времени . Для просмотра журналов необходимо указать аккаунт (доступно для Администраторов), машину и журнал этой машины, записи из которого нужно просмотреть. Подробнее см. описание ниже.

Фильтрация записей

Для просмотра логов в списке задайте параметры фильтрации.

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

  • Аккаунты * - Позволяют Администратору в следующем шаге выбрать машину конкретного(ых) аккаунта(ов), для которой необходимо просмотреть журналы . Выберите из ниспадающего списка один или несколько аккаунтов.
  • ВМ * - Позволяют выбрать журнылы конкретной ВМ. Выберите ВМ из ниспадающего списка. Список доступных ВМ определяется аккаунтом(ами), выбранным(и) на предыдущем шаге, если вы Администратор. Если вы пользователь, в списке вы увидите те машины, которые принадлежат вашему пользователю.
  • Журнал * - Позволяет просматривать записи конкретного журнала. Выберите из ниспадающего списка журнал для показа записей из него. Если не выбирать конкретный журнал, в списке будут отображены записи из всех журналов выбранной машины.
  • Дата - позволяет просматривать журналы за определенный период времени. Нажмите date icon и в появившемся календаре выберите начальную и конечную дату. По умолчанию показываются логи за последние сутки.
_images/Logs_Datepicker.png
  • Время - Позволяет задать конкретный промежуток времени в рамках заданного периода. По умолчанию, для начального времени установлено значение 00:00, а для конечного - 23:59. Вы можете ввести желаемое время в полях для начального и конечного времени.
_images/Logs_Timepicker1.png

Нажмите «Показать логи» для вывода логов согласно параметрам фильтрации.

_images/Logs_Filtering1.png

В списке будут отражены логи за указанный период.

Можно изменить параметры фильтрации и обновить список логов, нажав «ПОКАЗАТЬ ЛОГИ».

Список логов

Кликом на «ПОКАЗАТЬ ЛОГИ» пользователь может просматривать записи из журналов в соответствии с параметрами фильтрации. Записи в списке показаны в хронологическом порядке, от самых ранних до самых поздних.

По умолчанию, отображаются записи за последние сутки.

Пользователь может просматривать логи только для своих машин. Администратор может просматривать логи для машин всех аккаунтов в домене.

_images/Logs_List1.png

Для каждой записи в таблице представлена следующая информация:

  • Дата
  • Журнал
  • Текст

Можно изменить параметры фильтрации и обновить список логов, нажав «ПОКАЗАТЬ ЛОГИ».

Сортировка записей

Для сортировки записей можно активировать опцию «Новые сверху» справа и обновить список кликом на «ПОКАЗАТЬ ЛОГИ».

_images/Logs_Newest1.png

Поиск по записям

Для быстрого поиска по списку записей воспользуйтесь строкой поиска, расположенной над списком. Введите слово или текст и нажмите «ПОКАЗАТЬ ЛОГИ», чтобы обновить список. Записи будут отфильтрованы по заданным критериям поиска.

_images/Logs_Search2.png

Просмотр записей в режиме реального времени

После определения параметров фильтрации и нажатия на «ПОКАЗАТЬ ЛОГИ» пользователь может включить просмотр записей в режиме реального времени, чтобы отслеживать записи журналов машины.

Нажмите «Отслеживать» follow icon , список начнет обновляться автоматически с заданной регулярностью. По умолчанию установлена частота обновления - 1 раз в 1 секунду.

_images/Logs_Follow.png

Кнопка «Отслеживать» меняет положение в зависимости от применения режима сортировки. Если сортировка «Новые сверху» отключена, кнопка находится в правом нижнем углу, как на изображении выше. Если сортировка «Новые сверху» включена, кнопка отображается в правом верхнем углу, и записи в списке будут отображаться в обратном хронологическом порядке - от более ранних к более поздним.

_images/Logs_FollowUp.png

По умолчанию, в списке отображаются записи за последнюю минуту. Максимальное количество записей - 1000.

Если в списке большое количество записей, они будут подгружаться частями при «прокрутке» списка вниз.

Вы можете изменить параметры по умолчанию в разделе настроек “Просмотр логов (режим реального времени)”:

  • Показывать за последние (минуты) - время, за которое вы желаете видеть записи; доспустимые значения - от 1 (по умолчанию) до 10 минут.
  • Максимальное количество отображаемых записей - позволяет задать максимальное число записей для показа; допустимые значения - от 1 до бесконечности. По умолчанию, показываются 1000 записей.

Нажмите «Обновить» для применения заданных значений.

_images/RN_Logs_ViewOnlineSettings.png

Чтобы остановить отслеживание записей, нажмите unfollow icon.