KissLog.Sdk

KO | EN

gitlite — search

#ai #typescript #machine-learning #rust #deep-learning #linux #docker #macos #cli #kubernetes #awesome-list #security #ios #open-source

(★ 37)

KissLog is the default .NET integration for saving the logs to logbee.net.

KissLog.Sdk Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# KissLog

[![KissLog](https://img.shields.io/nuget/v/KissLog.svg?style=flat-square&label=KissLog)](https://www.nuget.org/packages?q=kisslog)
[![KissLog.AspNetCore](https://img.shields.io/nuget/v/KissLog.svg?style=flat-square&label=KissLog.AspNetCore)](https://www.nuget.org/packages?q=kisslog)
[![KissLog.AspNet.WebApi](https://img.shields.io/nuget/v/KissLog.svg?style=flat-square&label=KissLog.AspNet.WebApi)](https://www.nuget.org/packages?q=kisslog)
[![KissLog.AspNet.Mvc](https://img.shields.io/nuget/v/KissLog.svg?style=flat-square&label=KissLog.AspNet.Mvc)](https://www.nuget.org/packages?q=kisslog)<br>
[![Downloads](https://img.shields.io/nuget/dt/KissLog.svg?style=flat-square&label=Downloads)](https://www.nuget.org/packages?q=kisslog)

KissLog is the default .NET integration for saving the logs to [logbee.net](https://logbee.net).

Check the [Wiki page](https://github.com/catalingavan/KissLog.Sdk/wiki) for a complete list of features.

## .NET support

- [.NET Web App](https://github.com/catalingavan/KissLog.Sdk/wiki/dotnet-WebApp)
- [.NET Console App](https://github.com/catalingavan/KissLog.Sdk/wiki/dotnet-ConsoleApp)
- [ASP.NET MVC](https://github.com/catalingavan/KissLog.Sdk/wiki/ASP.NET-MVC)
- [ASP.NET WebApi](https://github.com/catalingavan/KissLog.Sdk/wiki/ASP.NET-WebApi)

## 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).

Centralized logging using [logbee.net](https://logbee.net) or [Logbee on-premises](https://github.com/catalingavan/logbee-app).

## Basic usage

```csharp
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](https://github.com/catalingavan/KissLog.Sdk/wiki/MongoDB-listener).

Using [interceptors](https://github.com/catalingavan/KissLog.Sdk/wiki/Filtering-the-logs), log listeners can apply conditional filtering rules before saving the events.

```csharp
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](https://github.com/catalingavan/KissLog.Sdk/wiki/Configuration) using the ``KissLogConfiguration.Options`` configuration object.

```csharp
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](https://raw.githubusercontent.com/wiki/catalingavan/KissLog.Sdk/images/AppendExceptionDetails.png)

## Samples

Different use cases and examples can be found on the [KissLog integrations page](https://github.com/catalingavan/logbee-integrations-examples/tree/main/KissLog).

## Feedback

Please use the [issues](https://github.com/KissLog-net/KissLog.Sdk/issues) section to report bugs, suggestions and general feedback.

## Contributing

All contributions are very welcomed: code, documentation, samples, bug reports, feature requests.

## License

[Apache-2.0](LICENSE.md)

KissLog.Sdk

KissLog.Sdk Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

KissLog.Sdk

KissLog.Sdk Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README