Table of Contents

SHOW LOG

This command retrieves a portion of the specified log file.

Only ADMIN user of a Valentina Server can execute this command.

Usually user is interested in the latest log messages, so simplest form of this command do this job - you need specify just size of info you want to get from the end of log file.

To implement reading of a log file by portions, this command have offset parameter and modifier FROM START or FROM END. A GUI application will prefer to count offset from the start, because the log file constantly grows. If modifier do not present, then FROM END is used.

Since Valentina Server can have many logs in the 'vserver/logs' folder, this command can also specify the name of a log file to use. If not present, then the active log file of Valentina Server is used.

Syntax

SHOW [VSERVER] LOG SIZE 
    [, offset [FROM {START|END}]] 
    [FOR log_name]

Result Columns

TEXT field that contains the text from the LOG file.

ULLong field - contains offset in the LOG file.

ULLong field - contains size of fld_log (size of log's chunk we've read).

ULLong field - contains size of whole log.

Examples

-- This retrieves 1000 bytes of log file from the its end.
SHOW VSERVER LOG 1000
 
-- the same:
SHOW VSERVER LOG 1000 FROM END
-- This retrieves 1000 bytes of log file from the its start.
SHOW VSERVER LOG 1000 FROM START
-- This retrieves 1000 bytes of log file from the its start with offset 4000
SHOW VSERVER LOG 1000, 4000 FROM START