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 — просмотр лога текущего запроса, то есть запроса, на который указывает курсор.