Logging to text files is managed through the Serilog service. The following image shows the available options.
You can read more about Serilog aquí.
Field |
Type |
Description |
Serilog Path |
Required |
The complete system path to the log configuration file. The LOGS folder inside the LinkarWS installation folder will be used by default. The default file name will be "LinkarWS.log". Serilog will add the date at the end of the file name. |
Output Template |
Optional |
A template for the line structure of the log text file. This template accepts literal values and Serilog standard properties, as well as properties created specifically for LinkarWS. The properties have to go in braces, e.g. {ResponseDuration}. The full list of properties can be found here. |
Filesize Limit in Bytes |
Number |
The max size in bytes for each log file. When this size is reached no more data will be stored in the log file. |
Retained File Count Limit |
Number |
The max number of log files that will be kept. |
Rolling Interval |
Button |
Specifies the interval at which new log files will be created. |
Roll on Filesize Limit |
Button |
Enabling this option will create a new file when the log file reaches the max file defined in the "Filesize Limite in Bytes" property. If not enabled no new log file will be created until reached the next interval defined in the "Rolling Interval" property. |
Minimun Level |
Select |
Serilog categorizes the information sent to the logs in different levels, according to the impact and importance of each entry. Setting the minimum level will exclude information above this level from the logs. For example a minimum level of "Warning" means Serilog will only log "Warning", "Error" and "Fatal" messages. LinkarServer sends data at the levels of "Information", "Warning" and "Error". |
In order to apply these changes they must first be saved via the "Save" button. The options that can be changed without having to restart LinkarServer are marked in green, any change to other options will require LinkarWS to be restarted.
Once the File Logs have been configured and LinkarServer is running any activity will start sending data to the log files. If the "Minimum Level" was configured to "Warning" data will only be logged when warnings or errors occur. You can test if the logging is working by setting the "Minimum Level" to "Information", which will log any operation to the file.
A simple text editor can be used to view the log file contents.
