README.md

syslog-extensions-logging

Syslog provider for .NET Core 2.0+ logging subsystem. This provider will send log messages to a Syslog server via UDP protocol.

Note: For now it supports .Net Core 2.0+ (versions before 2.0 are not supported yet)

Instructions

Package: Syslog.Extensions.Logging NuGet (master):

Configure your app settings by adding next settings to appsettings.json:

{
  "SyslogSettings": {
    "ServerHost": "127.0.0.1",
    "ServerPort": 514
  }
}

Tell your application's logging subsystem that you want to you Syslog by adding next line to Program.cs:

For .net core 2.0:

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args) 
                .UseStartup<Startup>()
                .ConfigureLogging(builder => builder.AddSyslog()) // <- Add this line
                .Build();

And Syslog provider know which configuration to use by adding next line in your Startup.cs:

        public void ConfigureServices(IServiceCollection services)
        {
            // Add framework services.
            services.AddMvc();
            services.AddOptions();

            services.Configure<SyslogLoggerProviderOptions>(Configuration.GetSection("SyslogSettings")); // <- Add this line
			...
        }

For .net core 2.1:

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder<Startup>(args)
                .ConfigureLogging((hostContext, builder) =>
                {
                    // add next lines (note: configuration should be done here instead of Startup.ConfigureServices method b/c in 2.1 call order was changed as result Provider was constructed without options...)
                    builder.Services.Configure<SyslogLoggerProviderOptions>(hostContext.Configuration.GetSection("SyslogSettings"));                    
                    builder.AddSyslog();
                });

Also you can configure Syslog provider during adding like this:

		public static IWebHost BuildWebHost(string[] args) {
            return WebHost.CreateDefaultBuilder(args) 
                .UseStartup<Startup>()
                .ConfigureLogging((ctx, builder) => 
					builder.AddSyslog(options => {
						options.SyslogServerHost = "127.0.0.1"; // IP of your Syslog Server
						options.SyslogServerPort = 514; // Port on which Syslog Server is listening
					})
				 )
                .Build();

Building from source

Open Syslog.Logging.sln in Visual Studio 2017 and build. See developer documentation for more details.