Serilog.Settings.AppSettings
3.0.0
Prefix Reserved
dotnet add package Serilog.Settings.AppSettings --version 3.0.0
NuGet\Install-Package Serilog.Settings.AppSettings -Version 3.0.0
<PackageReference Include="Serilog.Settings.AppSettings" Version="3.0.0" />
paket add Serilog.Settings.AppSettings --version 3.0.0
#r "nuget: Serilog.Settings.AppSettings, 3.0.0"
// Install Serilog.Settings.AppSettings as a Cake Addin #addin nuget:?package=Serilog.Settings.AppSettings&version=3.0.0 // Install Serilog.Settings.AppSettings as a Cake Tool #tool nuget:?package=Serilog.Settings.AppSettings&version=3.0.0
Serilog.Settings.AppSettings
An XML <appSettings>
reader for Serilog.
Getting started
The <appSettings>
support package needs to be installed from NuGet:
Install-Package Serilog.Settings.AppSettings
To read configuration from <appSettings>
use the ReadFrom.AppSettings()
extension method on your LoggerConfiguration
:
Log.Logger = new LoggerConfiguration()
.ReadFrom.AppSettings()
... // Other configuration here, then
.CreateLogger()
You can mix and match XML and code-based configuration, but each sink must be configured either using XML or in code - sinks added in code can't be modified via app settings.
Configuration syntax
To configure the logger, an <appSettings>
element should be included in the program's App.config or Web.config file.
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="serilog:minimum-level" value="Verbose" />
Serilog settings are prefixed with serilog:
.
Setting the minimum level
To set the logging level for the app use the serilog:minimum-level
setting key.
<add key="serilog:minimum-level" value="Verbose" />
Valid values are those defined in the LogEventLevel
enumeration: Verbose
, Debug
, Information
, Warning
, Error
, Fatal
.
Adding a sink
Sinks are added with the serilog:write-to
key. The setting name matches the configuration method name that you'd use in code, so the following are equivalent:
.WriteTo.Console()
In XML:
<add key="serilog:write-to:Console" />
NOTE: When using serilog:*
keys need to be unique.
Sink assemblies must be specified using the serilog:using
syntax. For example, to configure
<add key="serilog:using:Console" value="Serilog.Sinks.Console" />
<add key="serilog:write-to:Console"/>
If the sink accepts parameters, these are specified by appending the parameter name to the setting.
.WriteTo.File(@"C:\Logs\myapp-{Date}.txt", retainedFileCountLimit: 10)
In XML:
<add key="serilog:write-to:File.path" value="C:\Logs\myapp-{Date}.txt" />
<add key="serilog:write-to:File.retainedFileCountLimit" value="10" />
Any environment variables specified in a setting value (e.g. %TEMP%
) will be expanded appropriately when read.
Using sink extensions from additional assemblies
To use sinks and enrichers from additional assemblies, specify them with a serilog:using
key.
For example, to use configuration from the Serilog.Sinks.EventLog
assembly:
<add key="serilog:using:EventLog" value="Serilog.Sinks.EventLog" />
<add key="serilog:write-to:EventLog.source" value="Serilog Demo" />
Enriching with properties
To attach additional properties to log events, specify them with the serilog:enrich:with-property
directive.
For example, to add the property Release
with the value "1.2-develop"
to all events:
<add key="serilog:enrich:with-property:Release" value="1.2-develop" />
Adding minimum level overrides
Since Serilog 2.1, minimum level overrides can be added to change the minimum level for some specific namespaces. This is done with the setting key serilog:minimum-level:override:
followed by the source context prefix.
For instance, the following are equivalent :
Log.Logger = new LoggerConfiguration()
.MinimumLevel.Information()
.MinimumLevel.Override("Microsoft", LogEventLevel.Warning)
.MinimumLevel.Override("Microsoft.AspNetCore.Mvc", LogEventLevel.Error)
and in XML
<add key="serilog:minimum-level" value="Information" />
<add key="serilog:minimum-level:override:Microsoft" value="Warning" />
<add key="serilog:minimum-level:override:Microsoft.AspNetCore.Mvc" value="Error" />
Filtering
Filters can be specified using the Serilog.Filters.Expressions package; see the README there for more information.
Setting values from enumerations
When configuring sink settings with values from enumerations, use the member name, without specifying the name of the enumeration.
For example, to configure the RollingInterval
of the File Sink to create a new log file per day, use Day
instead of RollingInterval.Day
:
<add key="serilog:write-to:File.rollingInterval" value="Day"/>
If you specify the the name of the enumeration, you'll receive an error similar to System.ArgumentException: Requested value 'RollingInterval.Day' was not found
Destructuring
LoggerConfiguration
.Destructure.ToMaximumDepth(maximumDestructuringDepth: 3)
.Destructure.ToMaximumStringLength(maximumStringLength: 3)
.Destructure.ToMaximumCollectionCount(maximumCollectionCount: 3)
.Destructure.AsScalar(typeof(System.Version))
.Destructure.With(new CustomPolicy());
and in XML
<add key="serilog:destructure:ToMaximumDepth.maximumDestructuringDepth" value="3" />
<add key="serilog:destructure:ToMaximumStringLength.maximumStringLength" value="3" />
<add key="serilog:destructure:ToMaximumCollectionCount.maximumCollectionCount" value="3" />
<add key="serilog:destructure:AsScalar.scalarType" value="System.Version" />
<add key="serilog:destructure:With.policy" value="My.CustomPolicy, MyAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 is compatible. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- Serilog (>= 4.0.0)
-
.NETFramework 4.7.1
- Serilog (>= 4.0.0)
-
.NETStandard 2.0
- Serilog (>= 4.0.0)
- System.Configuration.ConfigurationManager (>= 4.4.1)
-
net6.0
- Serilog (>= 4.0.0)
- System.Configuration.ConfigurationManager (>= 4.4.1)
-
net8.0
- Serilog (>= 4.0.0)
- System.Configuration.ConfigurationManager (>= 4.4.1)
NuGet packages (49)
Showing the top 5 NuGet packages that depend on Serilog.Settings.AppSettings:
Package | Downloads |
---|---|
UmbracoCms.Core
Contains the core assemblies needed to run Umbraco Cms. This package only contains assemblies and can be used for package development. Use the UmbracoCms package to setup Umbraco in Visual Studio as an ASP.NET project. |
|
CertiPay.Common
Package Description |
|
UnderTest
Opinionated acceptance testing framework. |
|
DDPlanet.Logging
Simple logging framework developed for ELK stack based on Serilog providing fully configured logging in just a couple lines of code |
|
Slalom.Boost
No description. |
GitHub repositories (9)
Showing the top 5 popular GitHub repositories that depend on Serilog.Settings.AppSettings:
Repository | Stars |
---|---|
win-acme/win-acme
A simple ACME client for Windows (for use with Let's Encrypt et al.)
|
|
jakubgarfield/Bonobo-Git-Server
Bonobo Git Server for Windows is a web application you can install on your IIS and easily manage and connect to your git repositories. Go to homepage for release and more info.
|
|
DaxStudio/DaxStudio
DAX Studio is a tool to write, execute, and analyze DAX queries in Power BI Desktop, Power Pivot for Excel, and Analysis Services Tabular.
|
|
EvilBeaver/OneScript
Исполняющая среда скриптов на языке 1С
|
|
rzander/ruckzuck
software package manager for windows
|
Version | Downloads | Last updated |
---|---|---|
3.0.0 | 96,009 | 7/4/2024 |
3.0.0-dev-00080 | 109 | 7/3/2024 |
2.2.3-dev-00066 | 69,310 | 2/1/2021 |
2.2.3-dev-00063 | 20,250 | 5/10/2020 |
2.2.2 | 21,102,466 | 10/26/2018 |
2.2.2-dev-00059 | 1,619 | 10/26/2018 |
2.2.1-dev-00056 | 1,668 | 10/8/2018 |
2.2.1-dev-00054 | 2,034 | 9/22/2018 |
2.2.1-dev-00052 | 3,630 | 5/9/2018 |
2.2.0-dev-00048 | 2,345 | 3/29/2018 |
2.2.0-dev-00041 | 1,660 | 3/28/2018 |
2.1.2 | 2,595,289 | 9/19/2017 |
2.1.2-dev-00022 | 1,616 | 9/19/2017 |
2.1.1 | 5,326 | 9/18/2017 |
2.1.1-dev-00018 | 1,721 | 9/14/2017 |
2.1.0 | 660,537 | 2/14/2017 |
2.1.0-dev-00014 | 4,803 | 8/17/2016 |
2.1.0-dev-00013 | 1,699 | 8/17/2016 |
2.0.0 | 660,421 | 6/29/2016 |
2.0.0-beta-537 | 2,042 | 5/2/2016 |
2.0.0-beta-533 | 1,657 | 4/29/2016 |
2.0.0-beta-531 | 1,937 | 4/20/2016 |
2.0.0-beta-530 | 1,749 | 4/19/2016 |
2.0.0-beta-523 | 1,694 | 3/18/2016 |
2.0.0-beta-521 | 1,667 | 3/18/2016 |
2.0.0-beta-519 | 1,596 | 3/16/2016 |
2.0.0-beta-516 | 1,658 | 3/15/2016 |
2.0.0-beta-515 | 1,662 | 3/15/2016 |
2.0.0-beta-513 | 1,644 | 3/15/2016 |
2.0.0-beta-511 | 1,589 | 3/14/2016 |
2.0.0-beta-509 | 1,741 | 3/13/2016 |
2.0.0-beta-507 | 1,691 | 3/1/2016 |
2.0.0-beta-505 | 1,946 | 2/25/2016 |
2.0.0-beta-502 | 1,805 | 2/22/2016 |
2.0.0-beta-499 | 1,884 | 2/21/2016 |
2.0.0-beta-495 | 1,691 | 2/19/2016 |