NLog.Fluentd

NLog.Fluentd is a custom target of NLog that emits the log entries to a fluentd node.

Installation

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

Usage

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>

Acknowledgements

This started as a fork of Moriyoshi Koizumi's Nlog.Targets.Fluentd NLog extension.

License

MIT License