Settings in the LightAgent.conf file
The LightAgent.conf file contains Light Agent for Linux operation settings. The file is located on the protected virtual machine in the /etc/opt/kaspersky/lightagent/ directory.
Root account permissions are required to view and modify the file.
This section describes the settings in the LightAgent.conf file that allow you to configure logging of Light Agent for Linux traces and dumps and usage of Light Agent for Linux system log. Information about other settings, if necessary, can be obtained from the Technical Support.
Unassisted modification of the application operation settings in the ways not described in the application help or in the recommendations from the Technical Support specialists can lead to slowdowns and malfunctions of the operating system, decrease of the virtual machine protection level, as well as to a violation of the availability and integrity of the processed information.
Expand all | Collapse all
General settings
trace_level = 0
Determines the trace level for all Light Agent for Linux trace files except the avp-cli.log file.
Possible values:
- 0: creation of trace files is disabled.
- 100: "Always" – informational messages about application components being started and stopped.
- 200: "Critical" – messages about critical errors, which can result in the application termination.
- 300: "Error" – messages about errors, which can result in partial inoperability of the application.
- 400 ("Danger"): warnings about the possibility of critical errors.
- 500 ("Warning"): warnings about possible errors.
- 600 ("Important"): important messages.
- 700 ("Information"): informational messages.
- 800 ("Debug"): debug messages used by developers.
- 900 ("Paranoiac"): debug messages with more detailed information used by developers.
- 1000 ("Any"): all possible messages and warnings.
After changing the trace level, restart the lightagent service by running the following command:
systemctl reload lightagent
trace_file = /var/log/kaspersky/lightagent/LightAgent.log
Name of the main Light Agent for Linux trace file. The date is appended to the file name, for example, LightAgent.2020-11-30T094058.log. The rotation settings are controlled by the lightagent service.
The trace file is used if system log usage is disabled (see section [syslog]).
trace_format = %Y-%m-%dT%X %I %p:
The format for logging lines in the main Light Agent for Linux trace file.
Qualifiers: %Y = year, %m = month, %d = day, %H = hour, %M = minute, %S = second, %i = millisecond, %p = trace level, %N = device name, %P = process identifier (PID), %I = thread ID, %C = component ID, %D = component instance ID, %X = time.
The trace file is used if system log usage is disabled.
[rotation_settings] section
This section contains processing and rotation settings for Light Agent for Linux main trace file (LightAgent.log).
period = 3
File rotation frequency.
Possible values: 1 – monthly, 2 – weekly, 3 – daily, 4 – hourly.
max_file_size = 1073741824
The maximum trace file size in bytes. When reached, rotation is performed.
Possible values: 0 – unlimited, 1073741824 – 1 GB.
max_file_count = 25
The maximum number of the trace files. When the limit is reached, old files are deleted.
Possible values: number or 0 – unlimited.
new_file_on_start = 1
Logging to a new file or to the last available trace file when the application starts.
Possible values: 1 – write to a new file, 0 – write to the last created file.
[extra_tracing] section
enabled = 1
Logging general information to trace files every time the trace level is changed (information about the license, KSN usage, and the anti-virus databases used). Possible values: 0 – disabled, 1 – enabled.
[syslog] section
This section contains the system log usage settings.
enabled = 0
System log usage. Possible values: 1 – enable, 0 – disable.
If the system log usage is disabled, data is logged to the main Light Agent for Linux trace file. The file name is specified by the trace_file setting (see the General settings section).
program_name = avp-daemon
System log name.
facility = 176
System log category (LOG_LOCAL6 = 176).
format = %I %p:
Syslog entry format: %Y = year, %m = month, %d = day, %H = hour, %M = minute, %S = second, %i = millisecond, %p = trace level, %N = device name, %P = process identifier (PID), %I = thread ID, %C = component ID, %D = component instance ID, %X = time.
[dumps] section
This section contains dump file settings for Light Agent for Linux.
dir = /var/opt/kaspersky/lightagent/dumps
Directory for logging dumps.
schema = LightAgent_%d_%p_%n.dmp
Name configuration:
- %d – date and time (for example, 08.27_19.39);
- %p – process ID;
- %n – dump number in the session.
max = 4
The maximum number of dumps in the repository.
freeMiB = 1024
The minimum amount of free disk space required to write the dump (in MB).