Alternative Mail target for NLog using MailKit.

The NLog MailKit Target is able to replace the original NLog Mail Target and provides the same options.

See the NLog Wiki for available options and examples.

• Combine with FallbackGroup to fallback to alternative SMTP-server on error.
• Combine with BufferingWrapper and AutoFlushWrapper to group multiple logevents into a single email.
• Combine with LimitingWrapper to throttle the number of emails.
• Combine with FilteringWrapper to avoid repeating identical emails.

If having trouble with output, then check NLog InternalLogger for clues. See also Troubleshooting NLog

This library is integration tested with the SmtpServer NuGet package

1. Install the package:

   Install-Package NLog.MailKit or in your csproj:

   <PackageReference Include="NLog.MailKit" Version="6.*" />

2. Add to your nlog.config:

   <extensions>
       <add assembly="NLog.MailKit"/>
   </extensions>

   Alternative register from code using fluent configuration API:

   LogManager.Setup().SetupExtensions(ext => ext.RegisterTarget<NLog.MailKit.MailTarget>());

Note that the option skipCertificateValidation="true" can prevent AuthenticationException if your remote certificate for smtpServer is invalid - not recommend!

Mailkit supports OAuth2 authentication by specifying SmtpAuthentication = OAuth2 together with:

• SmtpUserName = ${gdc:OAuthClientId}
• SmtpPassword = ${gdc:OAuthClientSecret}

Before using OAuth2 authentication, make sure to acquire an access token from your email provider (e.g., Gmail, Outlook). This can be implemented with a Custom NLog Layout Renderer, or by storing the details in environment variable or NLog Global Diagnostics Context (GDC) and point SmtpUserName and SmtpPassword to these locations.

• Using OAuth2 With Microsoft Outlook Exchange
• Using OAuth2 With Google GMail

BSD. License of MailKit is MIT

Build, test, and NuGet publishing run on GitHub Actions. See ci.yml.