Serilog.Sinks.Email 4.0.0

Serilog.Sinks.Email

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 - 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,
            Period = 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,
            Period = 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()));
    }
}