An NLog target for Slack - your logs in one place and instantly searchable, everywhere.
Via NuGet: Install-Package NLog.Slack
... or just build it your self!
- Create a new Incoming Webhook integration.
- Configure NLog to use
NLog.Slack:
<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<extensions>
<add assembly="NLog.Slack" />
</extensions>
<targets async="true">
<target xsi:type="Slack"
name="slackTarget"
layout="${message}"
webHookUrl="https://xxx.slack.com/services/hooks/incoming-webhook?token=xxx"
channel="#log"
username="NLog.Slack"
compact="false"
icon=":ghost:" />
</targets>
<rules>
<logger name="*" minlevel="Debug" writeTo="slackTarget" />
</rules>
</nlog>Note: it's recommended to set async="true" on targets so if the HTTP call to Slack fails or times out it doesn't slow down your application.
var config = new LoggingConfiguration();
var slackTarget = new SlackTarget
{
Layout = "${message}",
WebHookUrl = "http://xxx.slack.com/services/hooks/incoming-webhook?token=xxx",
Channel = "#log"
};
config.AddTarget("slack", slackTarget);
var slackTargetRules = new LoggingRule("*", LogLevel.Debug, slackTarget);
config.LoggingRules.Add(slackTargetRules);
LogManager.Configuration = config;
And you're good to go!
| Key | Description |
|---|---|
| WebHookUrl | Grab your Webhook URL (with the token) from your Incoming Webhooks integration in Slack |
| Channel | The channel name (e.g #log) or user (e.g. @eth0) to send NLog messages to. Leave blank to use the integration default |
| Username | Name of the user that NLog messages comes from. Leave blank to use the integration default |
| Compact | Set to true to just send the NLog layout text (no process info, colors, etc) |
| Icon | Leave blank to use the integration default. Can either be a URL or Emoji |