Serilog.Extensions.Logging 8.0.1-dev-10382
Serilog.Extensions.Logging
A Serilog provider for Microsoft.Extensions.Logging, the logging subsystem used by ASP.NET Core.
ASP.NET Core Instructions
ASP.NET Core applications should prefer Serilog.AspNetCore and UseSerilog()
instead.
Non-web .NET Core Instructions
Non-web .NET Core applications should prefer Serilog.Extensions.Hosting and UseSerilog()
instead.
.NET Core 1.0, 1.1 and Default Provider Integration
The package implements AddSerilog()
on ILoggingBuilder
and ILoggerFactory
to enable the Serilog provider under the default Microsoft.Extensions.Logging implementation.
First, install the Serilog.Extensions.Logging NuGet package into your web or console app. You will need a way to view the log messages - Serilog.Sinks.Console writes these to the console.
dotnet add package Serilog.Extensions.Logging
dotnet add package Serilog.Sinks.Console
Next, in your application's Startup
method, configure Serilog first:
using Serilog;
public class Startup
{
public Startup(IHostingEnvironment env)
{
Log.Logger = new LoggerConfiguration()
.Enrich.FromLogContext()
.WriteTo.Console()
.CreateLogger();
// Other startup code
Finally, for .NET Core 2.0+, in your Startup
class's Configure()
method, remove the existing logger configuration entries and
call AddSerilog()
on the provided loggingBuilder
.
public void ConfigureServices(IServiceCollection services)
{
services.AddLogging(loggingBuilder =>
loggingBuilder.AddSerilog(dispose: true));
// Other services ...
}
For .NET Core 1.0 or 1.1, in your Startup
class's Configure()
method, remove the existing logger configuration entries and call AddSerilog()
on the provided loggerFactory
.
public void Configure(IApplicationBuilder app,
IHostingEnvironment env,
ILoggerFactory loggerfactory,
IApplicationLifetime appLifetime)
{
loggerfactory.AddSerilog();
// Ensure any buffered events are sent at shutdown
appLifetime.ApplicationStopped.Register(Log.CloseAndFlush);
That's it! With the level bumped up a little you should see log output like:
[22:14:44.646 DBG] RouteCollection.RouteAsync
Routes:
Microsoft.AspNet.Mvc.Routing.AttributeRoute
{controller=Home}/{action=Index}/{id?}
Handled? True
[22:14:44.647 DBG] RouterMiddleware.Invoke
Handled? True
[22:14:45.706 DBG] /lib/jquery/jquery.js not modified
[22:14:45.706 DBG] /css/site.css not modified
[22:14:45.741 DBG] Handled. Status code: 304 File: /css/site.css
Including the log category in text-format sink output
All Microsoft.Extensions.Logging.ILogger implementations are created with a specified log category string, which is then attached as structured data to each log message created by that ILogger
instance. Typically, the log category is the fully-qualified name of the class generating the log messages. This convention is implemented by the ILogger<TCategoryName>
interface, which is commonly used as an injected dependency in frameworks that use Microsoft.Extensions.Logging.
Serilog.Extensions.Logging captures the ILogger
's log category, but it's not included in the default output templates for text-based sinks, such as Console, File and Debug.
To include the log category in the final written messages, add the {SourceContext}
named hole to a customised outputTemplate
parameter value when configuring the relevant sink(s). For example:
.WriteTo.Console(
outputTemplate: "[{Timestamp:HH:mm:ss} {Level:u3}] {SourceContext}: {Message:lj}{NewLine}{Exception}")
.WriteTo.File("log.txt",
outputTemplate: "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {SourceContext}: {Message:lj}{NewLine}{Exception}")
Notes on Log Scopes
Microsoft.Extensions.Logging provides the BeginScope
API, which can be used to add arbitrary properties to log events within a certain region of code. The API comes in two forms:
- The method:
IDisposable BeginScope<TState>(TState state)
- The extension method:
IDisposable BeginScope(this ILogger logger, string messageFormat, params object[] args)
Using the extension method will add a Scope
property to your log events. This is most useful for adding simple "scope strings" to your events, as in the following code:
using (_logger.BeginScope("Transaction")) {
_logger.LogInformation("Beginning...");
_logger.LogInformation("Completed in {DurationMs}ms...", 30);
}
// Example JSON output:
// {"@t":"2020-10-29T19:05:56.4126822Z","@m":"Beginning...","@i":"f6a328e9","SourceContext":"SomeNamespace.SomeService","Scope":["Transaction"]}
// {"@t":"2020-10-29T19:05:56.4176816Z","@m":"Completed in 30ms...","@i":"51812baa","DurationMs":30,"SourceContext":"SomeNamespace.SomeService","Scope":["Transaction"]}
If you simply want to add a "bag" of additional properties to your log events, however, this extension method approach can be overly verbose. For example, to add TransactionId
and ResponseJson
properties to your log events, you would have to do something like the following:
// WRONG! Prefer the dictionary or value tuple approach below instead
using (_logger.BeginScope("TransactionId: {TransactionId}, ResponseJson: {ResponseJson}", 12345, jsonString)) {
_logger.LogInformation("Completed in {DurationMs}ms...", 30);
}
// Example JSON output:
// {
// "@t":"2020-10-29T19:05:56.4176816Z",
// "@m":"Completed in 30ms...",
// "@i":"51812baa",
// "DurationMs":30,
// "SourceContext":"SomeNamespace.SomeService",
// "TransactionId": 12345,
// "ResponseJson": "{ \"Key1\": \"Value1\", \"Key2\": \"Value2\" }",
// "Scope":["TransactionId: 12345, ResponseJson: { \"Key1\": \"Value1\", \"Key2\": \"Value2\" }"]
// }
Not only does this add the unnecessary Scope
property to your event, but it also duplicates serialized values between Scope
and the intended properties, as you can see here with ResponseJson
. If this were "real" JSON like an API response, then a potentially very large block of text would be duplicated within your log event!
Moreover, the template string within BeginScope
is rather arbitrary when all you want to do is add a bag of properties, and you start mixing enriching concerns with formatting concerns.
A far better alternative is to use the BeginScope<TState>(TState state)
method. If you provide any IEnumerable<KeyValuePair<string, object>>
to this method, then Serilog will output the key/value pairs as structured properties without the Scope
property, as in this example:
var scopeProps = new Dictionary<string, object> {
{ "TransactionId", 12345 },
{ "ResponseJson", jsonString },
};
using (_logger.BeginScope(scopeProps) {
_logger.LogInformation("Transaction completed in {DurationMs}ms...", 30);
}
// Example JSON output:
// {
// "@t":"2020-10-29T19:05:56.4176816Z",
// "@m":"Completed in 30ms...",
// "@i":"51812baa",
// "DurationMs":30,
// "SourceContext":"SomeNamespace.SomeService",
// "TransactionId": 12345,
// "ResponseJson": "{ \"Key1\": \"Value1\", \"Key2\": \"Value2\" }"
// }
Alternatively provide a ValueTuple<string, object?>
to this method, where Item1
is the property name and Item2
is the property value. Note that T2
must be object?
.
using (_logger.BeginScope(("TransactionId", (object?)12345)) {
_logger.LogInformation("Transaction completed in {DurationMs}ms...", 30);
}
// Example JSON output:
// {
// "@t":"2020-10-29T19:05:56.4176816Z",
// "@m":"Completed in 30ms...",
// "@i":"51812baa",
// "DurationMs":30,
// "SourceContext":"SomeNamespace.SomeService",
// "TransactionId": 12345
// }
Versioning
This package tracks the versioning and target framework support of its Microsoft.Extensions.Logging dependency.
Credits
This package evolved from an earlier package Microsoft.Framework.Logging.Serilog provided by the ASP.NET team.
Showing the top 20 packages that depend on Serilog.Extensions.Logging.
Packages | Downloads |
---|---|
Seq.Extensions.Logging
Add centralized structured log collection to ASP.NET Core apps with one line of code.
|
9 |
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
|
8 |
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
|
9 |
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
|
10 |
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
|
11 |
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
|
17 |
Serilog.Extensions.Hosting
Serilog support for .NET Core logging in hosted services
|
8 |
Serilog.Extensions.Hosting
Serilog support for .NET Core logging in hosted services
|
10 |
Serilog.Extensions.Hosting
Serilog support for .NET Core logging in hosted services
|
12 |
.NET Framework 4.6.2
- Microsoft.Extensions.Logging (>= 8.0.0)
- Serilog (>= 3.1.1)
.NET Standard 2.1
- Serilog (>= 3.1.1)
- Microsoft.Extensions.Logging (>= 8.0.0)
.NET Standard 2.0
- Microsoft.Extensions.Logging (>= 8.0.0)
- Serilog (>= 3.1.1)
.NET 8.0
- Serilog (>= 3.1.1)
- Microsoft.Extensions.Logging (>= 8.0.0)
.NET 7.0
- Microsoft.Extensions.Logging (>= 8.0.0)
- Serilog (>= 3.1.1)
.NET 6.0
- Serilog (>= 3.1.1)
- Microsoft.Extensions.Logging (>= 8.0.0)
Version | Downloads | Last updated |
---|---|---|
9.0.1-dev-02308 | 1 | 25.12.2024 |
9.0.0 | 0 | 09.12.2024 |
9.0.0-dev-02305 | 0 | 06.12.2024 |
9.0.0-dev-02304 | 0 | 06.12.2024 |
9.0.0-dev-02302 | 0 | 26.11.2024 |
9.0.0-dev-02301 | 0 | 26.11.2024 |
8.0.1-dev-10410 | 0 | 16.11.2024 |
8.0.1-dev-10407 | 0 | 15.11.2024 |
8.0.1-dev-10398 | 6 | 21.09.2024 |
8.0.1-dev-10391 | 0 | 22.05.2024 |
8.0.1-dev-10389 | 7 | 20.10.2024 |
8.0.1-dev-10382 | 4 | 20.10.2024 |
8.0.1-dev-10377 | 4 | 19.10.2024 |
8.0.1-dev-10373 | 8 | 22.09.2024 |
8.0.1-dev-10370 | 7 | 22.09.2024 |
8.0.0 | 22 | 21.02.2024 |
8.0.0-dev-10367 | 6 | 22.09.2024 |
8.0.0-dev-10359 | 10 | 21.10.2024 |
7.0.1-dev-10354 | 7 | 19.10.2024 |
7.0.0 | 15 | 30.04.2024 |
7.0.0-dev-10353 | 9 | 22.09.2024 |
7.0.0-dev-10346 | 7 | 22.10.2024 |
3.1.1-dev-10338 | 0 | 13.03.2023 |
3.1.1-dev-10337 | 7 | 21.10.2024 |
3.1.1-dev-10301 | 0 | 07.04.2022 |
3.1.0 | 9 | 28.02.2024 |
3.1.0-dev-10295 | 9 | 19.10.2024 |
3.0.2-dev-10289 | 7 | 22.09.2024 |
3.0.2-dev-10286 | 0 | 06.05.2021 |
3.0.2-dev-10284 | 8 | 21.10.2024 |
3.0.2-dev-10281 | 8 | 22.09.2024 |
3.0.2-dev-10280 | 3 | 20.10.2024 |
3.0.2-dev-10272 | 22 | 01.03.2024 |
3.0.2-dev-10269 | 7 | 21.10.2024 |
3.0.2-dev-10265 | 7 | 22.09.2024 |
3.0.2-dev-10260 | 9 | 27.08.2024 |
3.0.2-dev-10257 | 6 | 19.10.2024 |
3.0.2-dev-10256 | 8 | 29.10.2024 |
3.0.1 | 20 | 20.03.2024 |
3.0.1-dev-10252 | 6 | 19.10.2024 |
3.0.0 | 5 | 19.10.2024 |
3.0.0-dev-10248 | 6 | 22.09.2024 |
3.0.0-dev-10244 | 5 | 22.09.2024 |
3.0.0-dev-10240 | 5 | 22.09.2024 |
3.0.0-dev-10237 | 0 | 21.05.2019 |
3.0.0-dev-10234 | 9 | 22.09.2024 |
3.0.0-dev-10232 | 7 | 20.10.2024 |
2.0.5-dev-10226 | 9 | 22.09.2024 |
2.0.5-dev-10225 | 0 | 02.05.2019 |
2.0.4 | 0 | 23.04.2019 |
2.0.3 | 0 | 23.04.2019 |
2.0.3-dev-10220 | 0 | 23.04.2019 |
2.0.3-dev-10215 | 3 | 15.12.2024 |
2.0.2 | 10 | 01.03.2024 |
2.0.2-dev-10199 | 0 | 28.08.2017 |
2.0.1 | 7 | 21.10.2024 |
2.0.1-dev-10207 | 0 | 22.09.2018 |
2.0.1-dev-10205 | 9 | 22.09.2024 |
2.0.1-dev-10204 | 6 | 21.10.2024 |
2.0.1-dev-10195 | 2 | 29.10.2024 |
2.0.0 | 9 | 27.08.2024 |
2.0.0-dev-10187 | 8 | 22.09.2024 |
2.0.0-dev-10185 | 9 | 19.10.2024 |
2.0.0-dev-10180 | 0 | 17.08.2017 |
2.0.0-dev-10177 | 0 | 16.08.2017 |
2.0.0-dev-10174 | 3 | 26.11.2024 |
2.0.0-dev-10172 | 5 | 19.10.2024 |
2.0.0-dev-10169 | 7 | 22.09.2024 |
2.0.0-dev-10164 | 0 | 17.07.2017 |
1.4.1-dev-10155 | 0 | 22.04.2017 |
1.4.1-dev-10152 | 0 | 22.04.2017 |
1.4.1-dev-10147 | 0 | 15.02.2017 |
1.4.0 | 0 | 14.02.2017 |
1.4.0-dev-10144 | 7 | 20.10.2024 |
1.4.0-dev-10138 | 0 | 16.01.2017 |
1.4.0-dev-10136 | 4 | 19.10.2024 |
1.4.0-dev-10133 | 4 | 22.09.2024 |
1.3.1 | 9 | 22.09.2024 |
1.3.0 | 9 | 22.09.2024 |
1.3.0-dev-10129 | 0 | 15.11.2016 |
1.3.0-dev-10125 | 6 | 22.09.2024 |
1.2.0 | 0 | 08.08.2016 |
1.2.0-dev-10122 | 6 | 19.10.2024 |
1.1.0 | 5 | 19.10.2024 |
1.1.0-dev-10116 | 10 | 20.10.2024 |
1.1.0-dev-10114 | 7 | 22.09.2024 |
1.0.0 | 7 | 19.10.2024 |
1.0.0-rc2-10110 | 5 | 19.10.2024 |
1.0.0-rc2-10108 | 6 | 21.10.2024 |
1.0.0-rc2-10104 | 0 | 19.05.2016 |
1.0.0-rc2-10102 | 8 | 19.10.2024 |
1.0.0-rc2-10099 | 6 | 21.10.2024 |
1.0.0-rc2-10096 | 5 | 22.09.2024 |
1.0.0-rc1-final-10092 | 4 | 19.10.2024 |
1.0.0-rc1-final-10091 | 3 | 20.10.2024 |
1.0.0-rc1-final-10088 | 5 | 22.09.2024 |
1.0.0-rc1-final-10087 | 7 | 20.10.2024 |
1.0.0-rc1-final-10086 | 0 | 26.01.2016 |