About KissLog SDK

KissLog SDK is a lightweight and highly customizable logging and monitoring framework for .NET applications.

Some of the main features of KissLog SDK are:

  • Automatically captures all the exceptions

  • Captures all the HTTP traffic

  • Logs and exceptions are grouped per HTTP request

  • Fully compatible with non-web (console) ASP.NET applications

  • Built-in centralized logging integration with kisslog.net or with KissLog server on-premises

Check the documentation for a complete list of features.

kisslog.net centralized logging

Framework support

Why KissLog?

KissLog implements three main components: logging functionality, exceptions tracking and application insights.

For web applications, KissLog automatically captures all the HTTP properties.

KissLog keeps the log events in memory and sends them to the registered listeners all at once. This can help reduce the load of the persistence implementation (such as Disk I/O, database operations or network throughput).

View a captured log example

Basic usage

using KissLog;
using KissLog.Listeners.FileListener;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            KissLogConfiguration.Listeners
                .Add(new LocalTextFileListener("logs", FlushTrigger.OnFlush));

            var logger = new Logger();

            logger.Trace("Hey, I am a log message");

            Logger.NotifyListeners(logger);
        }
    }
}

Saving the logs

KissLog saves the logs to multiple output locations by using log listeners.

Log listeners are registered at application startup using the KissLogConfiguration.Listeners container.

Custom log listeners can be easily implemented.

Using interceptors, log listeners can apply conditional filtering rules before saving the events.

using KissLog;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            KissLogConfiguration.Listeners
                .Add(new LocalTextFileListener("logs", FlushTrigger.OnMessage))
                .Add(new CustomMongoDbListener("mongodb://localhost:27017", "Logs")
                {
                    Interceptor = new LogLevelInterceptor(LogLevel.Information)
                });

            var logger = new Logger();
            logger.Trace("Hey, I am a log message");

            Logger.NotifyListeners(logger);
        }
    }
}

Configuration

KissLog supports various configuration options using the KissLogConfiguration.Options configuration object.

private void ConfigureKissLog
{
    KissLogConfiguration.Options
        .AppendExceptionDetails((Exception ex) =>
        {
            if (ex is DivideByZeroException zeroDivisionEx)
                return ">>> Should check if the denominator is zero before dividing";

            return null;
        });
}
AppendExceptionDetails