Serilog.Settings.AppSettings 3.0.0-dev-00080

Prefix Reserved
This is a prerelease version of Serilog.Settings.AppSettings.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Serilog.Settings.AppSettings --version 3.0.0-dev-00080                
NuGet\Install-Package Serilog.Settings.AppSettings -Version 3.0.0-dev-00080                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Serilog.Settings.AppSettings" Version="3.0.0-dev-00080" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Serilog.Settings.AppSettings --version 3.0.0-dev-00080                
#r "nuget: Serilog.Settings.AppSettings, 3.0.0-dev-00080"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Serilog.Settings.AppSettings as a Cake Addin
#addin nuget:?package=Serilog.Settings.AppSettings&version=3.0.0-dev-00080&prerelease

// Install Serilog.Settings.AppSettings as a Cake Tool
#tool nuget:?package=Serilog.Settings.AppSettings&version=3.0.0-dev-00080&prerelease                

Serilog.Settings.AppSettings Build status NuGet Version Join the chat at https://gitter.im/serilog/serilog

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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 313,608 7/4/2024
3.0.0-dev-00080 134 7/3/2024
2.2.3-dev-00066 75,708 2/1/2021
2.2.3-dev-00063 21,180 5/10/2020
2.2.2 22,612,493 10/26/2018
2.2.2-dev-00059 1,636 10/26/2018
2.2.1-dev-00056 1,687 10/8/2018
2.2.1-dev-00054 2,055 9/22/2018
2.2.1-dev-00052 3,652 5/9/2018
2.2.0-dev-00048 2,369 3/29/2018
2.2.0-dev-00041 1,681 3/28/2018
2.1.2 2,645,210 9/19/2017
2.1.2-dev-00022 1,635 9/19/2017
2.1.1 5,520 9/18/2017
2.1.1-dev-00018 1,739 9/14/2017
2.1.0 673,586 2/14/2017
2.1.0-dev-00014 4,844 8/17/2016
2.1.0-dev-00013 1,717 8/17/2016
2.0.0 676,012 6/29/2016
2.0.0-beta-537 2,059 5/2/2016
2.0.0-beta-533 1,676 4/29/2016
2.0.0-beta-531 1,955 4/20/2016
2.0.0-beta-530 1,770 4/19/2016
2.0.0-beta-523 1,711 3/18/2016
2.0.0-beta-521 1,685 3/18/2016
2.0.0-beta-519 1,618 3/16/2016
2.0.0-beta-516 1,676 3/15/2016
2.0.0-beta-515 1,679 3/15/2016
2.0.0-beta-513 1,663 3/15/2016
2.0.0-beta-511 1,607 3/14/2016
2.0.0-beta-509 1,759 3/13/2016
2.0.0-beta-507 1,712 3/1/2016
2.0.0-beta-505 1,962 2/25/2016
2.0.0-beta-502 1,825 2/22/2016
2.0.0-beta-499 1,902 2/21/2016
2.0.0-beta-495 1,733 2/19/2016