Serilog.Sinks.Email 4.0.0

Serilog.Sinks.Email

通过SMTP电子邮件发送日志事件。

ℹ️ 此包的3.x版本将许多配置参数的名称和结构从2.x名称更改为新名称；有关详细信息，请见下文。

包 - Serilog.Sinks.Email

await using var log = new LoggerConfiguration()
    .WriteTo.Email(
        from: "[email protected]",
        to: "[email protected]",
        host: "smtp.example.com")
    .CreateLogger();

支持选项包括

可以使用接受EmailSinkOptions的重载来指定高级选项，例如批量发送和/或HTML正文模板。

发送批量邮件

要发送批量邮件，请向WriteTo.Email提供批量大小

await using var log = new LoggerConfiguration()
    .WriteTo.Email(
        options: new()
        {
            From = "[email protected]",
            To = "[email protected]",
            Host = "smtp.example.com",
        },
        batchingOptions: new()
        {
            BatchSizeLimit = 10,
            Period = TimeSpan.FromSeconds(30),
        })
    .CreateLogger();

可以使用options.Body自定义批量格式。

发送HTML邮件

要发送HTML邮件，请在options.Body中指定自定义的IBatchTextFormatter并将options.IsBodyHtml设置为true

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

以下是一个简单的HTML格式化示例

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