NLog.Fluentd is a custom target of NLog that emits the log entries to a fluentd node.
NLog.Fluentd is available as a NuGet Package. Type the following command into the Nuget Package Manager Console window to install it:
Install-Package NLog.Fluentd
The <target /> configuration section contains three required fields.
| Setting | Type | Required | Description | Default |
|---|---|---|---|---|
| Host | Layout | yes | Host name of the fluentd node | 127.0.0.1 |
| Port | Layout | yes | Port number of the fluentd node | 24224 |
| Tag | Layout | yes | Fluentd tag name | nlog |
| UseSsl | bool | no | Use SSL/TLS to connect to the fluentd node | false |
| ValidateCertificate | bool | no | Validate the certificate returned by the fluentd node | true |
| Enabled | Layout | no | Enables or disables sending messages to fluentd | true |
| ConnectionTimeout | int | no | Sets a custom timeout in case the target is not reachable. | 30000 |
For fluentd use case I recommend using the AsyncWrapper, along with a fallback option.
Note: If using the Buffering Wrapper keep in mind that when the buffer size limit is reached the flushing operation will be synchronous, meaning that the logging thread will be blocked.
<targets>
<default-wrapper xsi:type="BufferingWrapper" bufferSize="1000" flushTimeout="50" slidingTimeout="false" overflowAction="Flush"/>
<target xsi:type="FallbackGroup" name="fluentd-fallback-group" returnToFirstOnSuccess="true">
<target xsi:type="Fluentd"
name="fluentd"
host="127.0.0.1"
port="24224"
tag="nlog.demo"
useSsl="true"
ValidateCertificate="false"
layout="${message}"
ConnectionTimeout=5000
/>
<target xsi:type="File"
name="fluentd-file-fallback"
layout="${message}"
fileName="c:\Temp\nlog\Fluentd\${logger}_${shortdate}.txt"
encoding="utf-8"
/>
</target>
</targets>
This started as a fork of Moriyoshi Koizumi's Nlog.Targets.Fluentd NLog extension.
MIT License