COREmanager Documentation

How to view log-files

ISPSystem


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).
Thank you for your feedback!
Was the article useful?
Tell us why not:

it does not match the title

it was hard to understand

I didn't find the answer

recommendations from the article did not help

other

Tell us what you didn't like in the article: