👁 Image
Serilog.Sinks.Email 4.2.1

Serilog.Sinks.Email 👁 Build status
 👁 NuGet Version

Sends log events by SMTP email.

ℹ️ Version 3.x of this package changes the name and structure of many configuration parameters from their 2.x names; see below for detailed information.

Package Id: Serilog.Sinks.Email

await using var log = new LoggerConfiguration()
 .WriteTo.Email(
 from: "app@example.com",
 to: "support@example.com",
 host: "smtp.example.com")
 .CreateLogger();

Supported options are:

An overload accepting EmailSinkOptions can be used to specify advanced options such as batched and/or HTML body templates.

Sending batch email

To send batch email, supply WriteTo.Email with a batch size:

await using var log = new LoggerConfiguration()
 .WriteTo.Email(
 options: new()
 {
 From = "app@example.com",
 To = "support@example.com",
 Host = "smtp.example.com",
 },
 batchingOptions: new()
 {
 BatchSizeLimit = 10,
 BufferingTimeLimit = TimeSpan.FromSeconds(30),
 })
 .CreateLogger();

Batch formatting can be customized using options.Body.

Sending HTML email

To send HTML email, specify a custom IBatchTextFormatter in options.Body and set options.IsBodyHtml to true:

await using var log = new LoggerConfiguration()
 .WriteTo.Email(
 options: new()
 {
 From = "app@example.com",
 To = "support@example.com",
 Host = "smtp.example.com",
 Body = new MyHtmlBodyFormatter(),
 IsBodyHtml = true,
 },
 batchingOptions: new()
 {
 BatchSizeLimit = 10,
 BufferingTimeLimit = TimeSpan.FromSeconds(30),
 })
 .CreateLogger();

A simplistic HTML formatter is shown below:

class MyHtmlBodyFormatter : IBatchTextFormatter
{
 public void FormatBatch(IEnumerable<LogEvent> logEvents, TextWriter output)
 {
 output.Write("<table>");
 foreach (var logEvent in logEvents)
 {
 output.Write("<tr>");
 Format(logEvent, output);
 output.Write("</tr>");
 }

 output.Write("</table>");
 }

 public void Format(LogEvent logEvent, TextWriter output)
 {
 using var buffer = new StringWriter();
 logEvent.RenderMessage(buffer);
 output.Write(WebUtility.HtmlEncode(buffer.ToString()));
 }
}