Custom logging

The program uses Serilog for logging which is a powerful extensible library.

Levels

win-acme uses the following five log levels:

Error - Logs fatal or dangerous conditions
Warning - Logs minor errors and suspicious conditions
Information - General information about operations
Debug - Additional information that can be useful for troubleshooting
Verbose - Full logging for submitting bug reports

You can change the log level by adding the following setting:

<add key="serilog:minimum-level" value="Verbose" />

Included sinks

The default sink logs to the console window to provide real time insights.
The event sink writes to the Windows Event Viewer includes Error, Warning and selected Information messages.
The disk sink writes rolling log files to %programdata%\win-acme\$baseuri$\Log (that path can be changed in settings.json)

Custom sinks

There are many types of output channels called sinks for all kinds of different databases, file formats and services.

Example (Seq)

Download Serilog.Sinks.PeriodicBatching.dll and Serilog.Sinks.Seq.dll from NuGet. These files can be found here and here, respectively.
Configure the sink in a file called serilog.json according to the specification here.

Example

The follow piece of code in serilog.json adds the process ID to the output of the file log.

{
	"disk": {
		"WriteTo": [
			{ 
				"Name": "File",
				"Args": { 
					"outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] [PID:{ProcessId}] {Message:lj}{NewLine}{Exception}"
				} 
			}
		]
	}
}