Enabling, configuring and disabling trace logs: KAVSHELL TRACE
The KAVSHELL TRACE
command can be used to enable and disable the trace log for all Kaspersky Embedded Systems Security subsystems and to set the log detail level.
Kaspersky Embedded Systems Security writes information to trace files and the dump file in unencrypted form.
KAVSHELL TRACE command syntax
KAVSHELL TRACE </ON /F:<
path to trace log file folder> [/S:<maximum log size in megabytes>] [/LVL:debug|info|warning|error|critical] [/r:<maximum number of trace files for rotation
>] | /OFF>
If the trace log is enabled and you wish to change its settings, enter the KAVSHELL TRACE
command with the /ON option and use the /S and /LVL parameters to specify the trace log settings (see the table below).
KAVSHELL TRACE command keys
Key | Description |
---|---|
| Enables the trace log. |
| This parameter specifies the full path to the folder where trace log files will be saved (required). If a path to a non-existent folder is specified, no trace log will be created. Paths to folders on the network drives of other protected devices cannot be specified. If the path specified by the parameter has a space, it needs to be enclosed in quotes, for example, /F:"C:\Trace Folder". System environment variables can be used when specifying the path to the trace log files; user environment variables are not allowed. |
| This key sets the maximum size of a single trace log file. As soon as the log file reaches the maximum size, Kaspersky Embedded Systems Security will start recording information in a new file; the previous log file will be saved. If the value of this parameter is not specified, the maximum size of one log file will be 50 MB. |
| This parameter sets the log detail level from maximum (All debug information), in which all events are recorded in the log, to minimum (Critical events), in which only critical events are recorded. If this parameter is not specified, all events included in the All debug information level of detail will be recorded in the trace log. |
| This parameter enables the trace files rotation. If the trace files rotation is enabled and the < Available values: from 1 to 999. If the value is not specified, the trace files rotation is not enabled and the application returns an error. |
/OFF | This option disables the trace log. |
KAVSHELL TRACE command examples
To enable the trace log using the All debug information level of detail and a maximum log size of 200MB, saving the log file to the "C:\Trace Folder" folder, execute the command:
KAVSHELL TRACE /ON /F:"C:\Trace Folder" /S:200
To enable the trace log using the Important events level of detail, saving the log file to the "C:\Trace Folder" folder, execute the command:
KAVSHELL TRACE /ON /F:"C:\Trace Folder" /LVL:warning
To enable the trace log using the Important events level of detail, saving the log file to the "C:\Trace Folder" folder, and to enable the trace files rotation after a maximum number of 50 trace files is reached, execute the command:
KAVSHELL TRACE /ON /F:"C:\Trace Folder" /LVL:warning /r:50
To disable the trace log, execute the command:
KAVSHELL TRACE /OFF