Документация COREmanager

Просмотр log-файлов

 

logread — это консольное приложение поставляемое вместе с COREmanager и доступное во всех наших панелях. Данное приложение предоставляет ряд функций для более удобного чтения log-файлов, выборки данных по ID процесса, поиск и т.п.

Использование

При вводе команды:

/usr/local/mgr5/sbin/logread -h

или

/usr/local/mgr5/sbin/logread --help

на экран выводится справка о синтаксисе команды:

 Usage: logread [OPTION] [FILE]...
 Options:
   -b, --batch             run program in noninteractively mode
   -p, --pid=PID[:THREAD]  filter output by process ID
   -h, --help              display this help and exit

На данный момент доступны следующие опции командной строки:

  • -b — указывает приложению, что работа с log-файлами производится в "неинтерактивном режиме", то есть необходимо выполнить запрос и завершить работу. Результат будет выгружен в стандартный поток вывода;
  • -p — указывает приложению, что необходимо отфильтровать данные по идентификатору (ID) процесса панели. Данная опция принимает на вход параметр с ID процесса, либо пару "ID процесса:ID потока" разделенные знаком ":";
  • -h — вывод краткой справки и завершение работы.

В качестве источника данных, приложению необходимо указать путь до log-файла панели, либо группу файлов. Причем файлом может быть как текстовый log-файл панели, так и архив созданный программой ротации log-файлов:

Пример

/usr/local/mgr5/sbin/logread -p21760:3 /usr/local/mgr5/var/ispmgr.log /usr/local/mgr5/var/ispmgr.log.0

То есть загрузить два log-файла ISPmanager, один из которых архивный, и отфильтровать результат по ID указанного процесса.

Интерактивный режим

В интерактивном режиме, приложение позволяет просматривать log-файлы как в прямом, так и в обратном направлении. Кроме того, обладает удобными средствами для поиска и навигации по тексту. По умолчанию весь текст сгруппирован по запросам к панели, то есть строкам вида:

Feb 20 17:54:38 [21760:24] journal INFO Request [188.120.252.43][root] 'func=keepalive&operafake=1392886478547&sfrom=ajax'

Основные команды:

  • q и ESC — завершение работы приложения;
  • и — вертикальная прокрутка;
  • PageUp и PageDown — постраничная вертикальная прокрутка;
  • g и Home — переход в начало текста;
  • G и End — переход в конец текста;
  • ENTER и SPACE — просмотр лога текущего запроса, то есть запроса, на который указывает курсор.