Logs Settings
Use the logs.xml file to define the severity level of data that is logged, the number of files to back up, the maximum file size, and whether the logged information should be saved as a file or sent to Windows Event Viewer.
These settings are relevant to the following processes:
| n | Votiro.Sanitization.API |
| n | Votiro.SNMC |
| n | Sanitization Nodes |
| n | Votiro.Sandbox |
The logs configuration file is located in [installation_path]\Votiro\SDS Web Service\Config. In the case of the Votiro.Sandbox service, the logs file is in
[installation_path]\Votiro\Sandbox\Config.
In addition to the logs that are configured in logs.xml, Disarmer logs can be sent to a SIEM in CEF format. For more information, see Sending Logs to SIEM in CEF Format.
The attributes that are described in Log Configuration File Attributes and Log Configuration Event Viewer Attributes appear in the logs.xml file. The tables provide a description of the attribute, considerations to make when specifying a value, and the permissible values.
The logs.xml attributes are divided into two tables, according to whether they relate to a log file or content that is being sent to the Windows Event Viewer.
Note
To apply changes to settings in the logs.xml file, you must save the file and restart the Votiro.Sanitization.API and Votiro.SNMC Windows services. This is true for all parameters except for LogLevel. In the case of LogLevel, immediately upon saving the file, the new log level is applied.
Log Configuration File Attributes
Description | Value | |
|---|---|---|
| AppenderConfig | ||
LogLevel | Specifies the severity level of data that is logged. You can have more than one LogLevel attribute in the file. For example, you might choose to log Warning, Error, and Fatal events.
| Values Default is Debug. |
NumberOfBackups | Specifies the number of files that can be backed up before file rotation occurs. When files are rotated, the first file that was created (the oldest file) is overwritten first.
| A positive integer. Default is 10. |
MaxFileSize | Specifies how large the log file can be before a new file is created. | A file size greater than zero, including the measurement being used, for example 40 MB (the default). |
FileName | Specifies the name of the file. Use ASCII characters when specifying a file name.
Values The default is Note Do not change this setting unless instructed to by Votiro Support. | The default file name for sandbox logs is: VotiroSandbox_%ComputerName%.log |
FileFolder | Specifies the name and location of the folder where the log files are stored. If the value is empty, the folder is defined by the system as %HomeDirectory%\SDS Web Service\Logs. If you specify a value, it must be the full path of the folder. The default is Logs\%Service%. Note Do not change this setting unless instructed to by Votiro Support. | The name of the folder, in the format [drive]:\[path]\[folder], for example, C:\Votiro\Logs\. |
| xsi:type | XML schema attribute. Note Do not change this setting unless instructed to by Votiro Support. | Default is File. |
Log Configuration Event Viewer Attributes
Attribute | Description | Value |
|---|---|---|
AppenderConfig | ||
LogLevel | Specifies the severity level of data that is logged. You can have more than one LogLevel attribute in the file. For example, you might choose to log Warning, Error, and Fatal events.
| Any one of the following: Verbose, Debug, Info, Notice, Warning, Error, Fatal. Default is Notice. |
ApplicationName | Specifies the name of the application that appears under Applications and Services in the Event Viewer.
| The name of the application, for example SDS. You must use ASCII characters when specifying the application name. Default is SDS. |
| xsi:type | XML schema attribute. Default is EventViewer. Note Do not change this setting unless instructed to by Votiro Support. | |
Comments
0 comments
Please sign in to leave a comment.