Skip to content

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

License

Notifications You must be signed in to change notification settings

ALFNeT/NLog.Fluentd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

66 Commits
 
 
 
 
 
 
 
 

Repository files navigation

NLog.Fluentd

NuGet

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

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages