Serilog Sinks File

Serilog.Sinks.File   

Writes Serilog events to one or more text files.

Getting started

Install the Serilog.Sinks.File package from NuGet:

dotnet add package Serilog.Sinks.File

To configure the sink in C# code, call WriteTo.File() during logger configuration:

var log = new LoggerConfiguration().WriteTo.File("log.txt", rollingInterval: RollingInterval.Day).CreateLogger();

This will append the time period to the filename, creating a file set like:

log20180631.txt

log20180701.txt

log20180702.txt

Important: By default, only one process may write to a log file at a given time. See _Shared log files_ below for information on multi-process sharing.

Limits

To avoid bringing down apps with runaway disk usage the file sink limits file size to 1GB by default. Once the limit is reached, no further events will be written until the next roll point (see also: Rolling policies below).

The limit can be changed or removed using the fileSizeLimitBytes parameter..WriteTo.File("log.txt", fileSizeLimitBytes: null)

For the same reason, only the most recent 31 files are retained by default (i.e. one long month). To change or remove this limit, pass the retainedFileCountLimit parameter..WriteTo.File("log.txt", rollingInterval: RollingInterval.Day, retainedFileCountLimit: null)

Rolling policies

To create a log file per day or other time period, specify a rollingInterval as shown in the examples above.

To roll when the file reaches fileSizeLimitBytes, specify rollOnFileSizeLimit:.WriteTo.File("log.txt", rollOnFileSizeLimit: true)

This will create a file set like:

log.txt

log_001.txt

log_002.txt

Specifying both rollingInterval and rollOnFileSizeLimit will cause both policies to be applied, while specifying neither will result in all events being written to a single file.

Old files will be cleaned up as per retainedFileCountLimit - the default is 31.

XML `` configuration

To use the file sink with the Serilog.Settings.AppSettings package, first install that package if you haven't already done so:

Install-Package Serilog.Settings.AppSettings

Instead of configuring the logger in code, call ReadFrom.AppSettings():

var log = new LoggerConfiguration().ReadFrom.AppSettings().CreateLogger();

In your application's App.config or Web.config file, specify the file sink assembly and required path format under the `` node:

The parameters that can be set through the serilog:write-to:File keys are the method parameters accepted by the WriteTo.File() configuration method. This means, for example, that the fileSizeLimitBytes parameter can be set with:

Omitting the value will set the parameter to null:

In XML and JSON configuration formats, environment variables can be used in setting values. This means, for instance, that the log file path can be based on TMP or APPDATA:

JSON appsettings.json configuration

To use the file sink with _Microsoft.Extensions.Configuration_, for example with ASP.NET Core or.NET Core, use the Serilog.Settings.Configuration package. First install that package if you have not already done so:

Install-Package Serilog.Settings.Configuration

Instead of configuring the file directly in code, call ReadFrom.Configuration():

var configuration = new ConfigurationBuilder().AddJsonFile("appsettings.json").Build();

var logger = new LoggerConfiguration().ReadFrom.Configuration(configuration).CreateLogger();

In your appsettings.json file, under the Serilog node,:

{

"Serilog": {

"WriteTo": [

{ "Name": "File", "Args": { "path": "log.txt", "rollingInterval": "Day" } }

]

}

}

See the XML ` example above for a discussion of available Args` options.

Controlling event formatting

The file sink creates events in a fixed text format by default:

2018-07-06 09:02:17.148 +10:00 [INF] HTTP GET / responded 200 in 1994 ms

The format is controlled using an _output template_, which the file configuration method accepts as an outputTemplate parameter.

The default format above corresponds to an outpu