COREmanager Documentation
Documentation
/
COREmanager Documentation
/
Technical articles
/
How to view log-files

How to view log-files


logread is a console application that is provided along with COREmanager and is available in all our software products. It provides a number of functions making it easier for you to read log-files, select data by process ID, search, etc.

How to use

Entering the command

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

or

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

will display the hint about command's syntax

 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

Currently, the following command line options are available:

  • -b
    Informs the application that the "noninteractive mode" is used for working with log-files, i.e. you must send a request and terminate the operation. The result will be sent to stdout.
  • -p
    Informs the application that data should be filtered by the id of the panel's process. This option receives to stdin the parameter with process ID or "process ID :thread ID" separated by ":".
  • -h
    Outputs a brief hint and termination of the operation.

As a data source, you should specify the path to the panel's log-file or a group of files. The file can be both a text log-file of the control panel and the archive created by a log-rotations program.

Example

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

i.e. upload two log-files of ISPmanager, one of which is an archive, and filter the result by ID of the specified process.

Interactive mode

In the interactive mode, you can view log-files in both directions. Besides, it provides easy-to-use functions for search and navigation. By default the text is grouped by requests to control panel like that:

 Feb 20 17:54:38 [21760:24] journal INFO Request [188.120.252.43][root] 'func=keepalive&operafake=1392886478547&sfrom=ajax'
Main commands
  • q and ESC
    Terminate an application.
  • ↓ and ↑
    Vertical scroll.
  • PageUp and PageDown
    Vertical scroll per page.
  • g and Home
    Top of the test.
  • G and End
    Bottom of the text.
  • ENTER and SPACE
    View log of the current request (the one to which the mouse cursor is pointing).