DDPlanet.Logging 1.0.0

The development package for logging configuration

There is a newer version of this package available.
See the version list below for details.
Install-Package DDPlanet.Logging -Version 1.0.0
dotnet add package DDPlanet.Logging --version 1.0.0
<PackageReference Include="DDPlanet.Logging" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add DDPlanet.Logging --version 1.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: DDPlanet.Logging, 1.0.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install DDPlanet.Logging as a Cake Addin
#addin nuget:?package=DDPlanet.Logging&version=1.0.0

// Install DDPlanet.Logging as a Cake Tool
#tool nuget:?package=DDPlanet.Logging&version=1.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

DDPlanet.Logging

Summary

DDPlanet.Logging is simple logging framework developed for ELK stack based on Serilog. It will provide fully configured logging in just a couple lines of code.

Base concept

All logs will be sent on remote ELK server and duplicated to console and small local rolling file.

Installation

NuGet package available

Package manager:

Install-Package DDPlanet.Logging

.NET CLI:

dotnet add package DDPlanet.Logging

Usage

ASP.NET Core

Quick start
ASP.NET Core

In Program.cs:

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseLogging();

In appsettings.json:

"Logging": {
    "ApplicationName": "some.app", // your application name
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "Microsoft": "Warning",
        "System": "Warning",
        "IdentityServer4": "Warning"
      }
    },
    "Remote": {
      "LoggingServerNodes": [
        "http://10.77.111.88:9200/" // your Elasticsearch host
      ]
    }
}

Usage:

public class HomeController : Controller
{
    private readonly ILogger _logger;

    public HomeController(ILogger<HomeController> logger)
    {
        _logger = logger;
    }

    public ActionResult Info()
    {
        _logger.LogInformation("Test message");
        return View();
    }
}

If you use a custom class (not an MVC controller) it must be registered in Startup.cs. ConfigureServices: services.AddScoped<ICustomService, CustomService>();

.NET Core Console app (Not recommended)

It is always better to use ASP.NET Core despite overhead

In Program.cs:

static void Main(string[] args)
{
    Log.Logger = LoggerHelper.GetDefaultLogger();

    Log.Logger.Information("Test message");

    Console.WriteLine("Message sent.");
    Console.ReadLine();
}

In appsettings.json: same as ASP.NET Core

Advanced configuration

.UseLogging() and GetDefaultLogger() both can be additionally configured with parameters configure (main settings) or postConfigure (underlaying Serilog settings). Such configuration has priority under configuration file. All concurrent values from appsettings.json will be overwritten!

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseLogging(
                    configure: settings =>
                    {
                        settings.ApplicationName = "another.name";
                        settings.Environment = "Staging";
                        settings.Remote.FallbackFile.Path = "custom.log";
                    },
                    postConfigure: serilogSettings =>
                    {
                        serilogSettings.Enrich.WithProperty("someProp", "someValue");
                    });

.NET Framework

Quick start
ASP.NET MVC

In Global.asax:

protected void Application_Start()
{
    Log.Logger = LoggerHelper.GetDefaultLogger(
    environment: "Developnemt",
    config =>
    {
        config.ApplicationName = "some.app"; // your application name
        config.Remote.LoggingServerNodes = new List<Uri>
        {
            new Uri("http://10.77.111.88:9200/") // your Elasticsearch host
        };
    });
}

protected void Application_Error()
{
    var ex = Server.GetLastError();
    Log.Error(ex, "Application_Error");
}

Usage:

public ActionResult Info()
{
    Log.Information("Test message");
    return View();
}
Console app

In Program.cs:

static void Main(string[] args)
{
    Log.Logger = LoggerHelper.GetDefaultLogger(
    environment: "Developnemt",
    config =>
    {
        config.ApplicationName = "some.app"; // your application name
        config.Remote.LoggingServerNodes = new List<Uri>
        {
            new Uri("http://10.77.111.88:9200/") // your Elasticsearch host
        };
    });

    Log.Information("Test message");
}
Advanced configuration

Best practices is storing all you configuration values in Web.config or App.config. In Web.config:

<appSettings>
  <add key="Logging:Environment" value="Development"/>
  <add key="Logging:ApplicationName" value="test.app"/>
  <add key="Logging:Remote:LoggingServerNodes" value="http://10.77.111.88:9200/"/>
</appSettings>

In Global.asax:

protected void Application_Start()
{
    Log.Logger = LoggerHelper.GetDefaultLogger(
        ConfigurationManager.AppSettings["Logging:Environment"],
        config =>
        {
            config.ApplicationName = ConfigurationManager.AppSettings["Logging:ApplicationName"];
            var elkNodes = ConfigurationManager.AppSettings["Logging:Remote:LoggingServerNodes"]
                .Split(',')
                .Select(node => new Uri(node.Trim()))
                .ToList();
            config.Remote.LoggingServerNodes = elkNodes;
        });
}

DDPlanet.Logging

Summary

DDPlanet.Logging is simple logging framework developed for ELK stack based on Serilog. It will provide fully configured logging in just a couple lines of code.

Base concept

All logs will be sent on remote ELK server and duplicated to console and small local rolling file.

Installation

NuGet package available

Package manager:

Install-Package DDPlanet.Logging

.NET CLI:

dotnet add package DDPlanet.Logging

Usage

ASP.NET Core

Quick start
ASP.NET Core

In Program.cs:

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseLogging();

In appsettings.json:

"Logging": {
    "ApplicationName": "some.app", // your application name
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "Microsoft": "Warning",
        "System": "Warning",
        "IdentityServer4": "Warning"
      }
    },
    "Remote": {
      "LoggingServerNodes": [
        "http://10.77.111.88:9200/" // your Elasticsearch host
      ]
    }
}

Usage:

public class HomeController : Controller
{
    private readonly ILogger _logger;

    public HomeController(ILogger<HomeController> logger)
    {
        _logger = logger;
    }

    public ActionResult Info()
    {
        _logger.LogInformation("Test message");
        return View();
    }
}

If you use a custom class (not an MVC controller) it must be registered in Startup.cs. ConfigureServices: services.AddScoped<ICustomService, CustomService>();

.NET Core Console app (Not recommended)

It is always better to use ASP.NET Core despite overhead

In Program.cs:

static void Main(string[] args)
{
    Log.Logger = LoggerHelper.GetDefaultLogger();

    Log.Logger.Information("Test message");

    Console.WriteLine("Message sent.");
    Console.ReadLine();
}

In appsettings.json: same as ASP.NET Core

Advanced configuration

.UseLogging() and GetDefaultLogger() both can be additionally configured with parameters configure (main settings) or postConfigure (underlaying Serilog settings). Such configuration has priority under configuration file. All concurrent values from appsettings.json will be overwritten!

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseLogging(
                    configure: settings =>
                    {
                        settings.ApplicationName = "another.name";
                        settings.Environment = "Staging";
                        settings.Remote.FallbackFile.Path = "custom.log";
                    },
                    postConfigure: serilogSettings =>
                    {
                        serilogSettings.Enrich.WithProperty("someProp", "someValue");
                    });

.NET Framework

Quick start
ASP.NET MVC

In Global.asax:

protected void Application_Start()
{
    Log.Logger = LoggerHelper.GetDefaultLogger(
    environment: "Developnemt",
    config =>
    {
        config.ApplicationName = "some.app"; // your application name
        config.Remote.LoggingServerNodes = new List<Uri>
        {
            new Uri("http://10.77.111.88:9200/") // your Elasticsearch host
        };
    });
}

protected void Application_Error()
{
    var ex = Server.GetLastError();
    Log.Error(ex, "Application_Error");
}

Usage:

public ActionResult Info()
{
    Log.Information("Test message");
    return View();
}
Console app

In Program.cs:

static void Main(string[] args)
{
    Log.Logger = LoggerHelper.GetDefaultLogger(
    environment: "Developnemt",
    config =>
    {
        config.ApplicationName = "some.app"; // your application name
        config.Remote.LoggingServerNodes = new List<Uri>
        {
            new Uri("http://10.77.111.88:9200/") // your Elasticsearch host
        };
    });

    Log.Information("Test message");
}
Advanced configuration

Best practices is storing all you configuration values in Web.config or App.config. In Web.config:

<appSettings>
  <add key="Logging:Environment" value="Development"/>
  <add key="Logging:ApplicationName" value="test.app"/>
  <add key="Logging:Remote:LoggingServerNodes" value="http://10.77.111.88:9200/"/>
</appSettings>

In Global.asax:

protected void Application_Start()
{
    Log.Logger = LoggerHelper.GetDefaultLogger(
        ConfigurationManager.AppSettings["Logging:Environment"],
        config =>
        {
            config.ApplicationName = ConfigurationManager.AppSettings["Logging:ApplicationName"];
            var elkNodes = ConfigurationManager.AppSettings["Logging:Remote:LoggingServerNodes"]
                .Split(',')
                .Select(node => new Uri(node.Trim()))
                .ToList();
            config.Remote.LoggingServerNodes = elkNodes;
        });
}

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
4.1.0 10,458 2/9/2021
4.0.2 7,466 11/9/2020
4.0.1 263 11/9/2020
4.0.0 285 10/22/2020
3.1.1 6,352 8/13/2020
3.1.0 1,067 8/5/2020
3.0.1 8,217 3/13/2020
3.0.0 7,418 10/3/2019
2.0.0 244 10/2/2019
1.0.2 1,399 9/9/2019
1.0.1 2,784 8/7/2019
1.0.0 238 8/7/2019
0.1.9 2,606 5/6/2019
0.1.7 335 4/30/2019
0.1.6 266 4/29/2019
0.1.5 444 4/24/2019
Show less