# Logovanie

> Ako napojiť vlastný logovací nástroj (Serilog, log4net, Seq) na .NET knižnicu eKasa cez Microsoft.Extensions.Logging.Abstractions.

Zdroj: https://ekasa.ninedigit.sk/docs/dotnet/logging

Knižnica eKasa sa na logovanie napája cez abstrakciu
[*Microsoft.Extensions.Logging.Abstractions*](https://www.nuget.org/packages/Microsoft.Extensions.Logging.Abstractions/).
Trieda `Client` prijíma inštanciu `ILoggerFactory`, takže knižnica nepredpisuje logovací nástroj: použijete ten,
ktorý už má vaša aplikácia.

## Podporované nástroje

Môžete použiť ľubovoľný logovací nástroj, ktorý vytvorí `ILoggerFactory`, napríklad:

| Nástroj | Napojenie na `ILoggerFactory` |
|---|---|
| Serilog | [serilog-extensions-logging](https://github.com/serilog/serilog-extensions-logging) |
| log4net | [Microsoft.Extensions.Logging.Log4Net.AspNetCore](https://github.com/huorswords/Microsoft.Extensions.Logging.Log4Net.AspNetCore) |
| Seq | [Seq.Extensions.Logging](https://www.nuget.org/packages/Seq.Extensions.Logging/) |

## Príklad so Serilogom

1. **Nainštalujte NuGet balíky**
   `Serilog.Extensions.Logging` a `Serilog.Sinks.Console`.
2. **Vytvorte logger Serilogu**
   Nastavte úroveň podrobnosti logovaných správ a výstup do konzoly.
3. **Zabaľte ho do `ILoggerFactory`**
   Triedou `SerilogLoggerFactory`.
4. **Odovzdajte ho klientovi**
   Konštruktoru `Client(configuration, loggerFactory)`, pozri [Vytvorenie klienta](https://ekasa.ninedigit.sk/docs/dotnet/instantiation).

```csharp
using Microsoft.Extensions.Logging;
using NineDigit.eKasa;
using Serilog;
using Serilog.Extensions.Logging;

namespace SerilogExampleApp
{
    class SerilogLoggerExample
    {
        public void Demo(ClientConfiguration configuration)
        {
            // Trieda Client prijíma inštanciu ILoggerFactory.
            // Vďaka tejto abstrakcii môžete použiť svoj obľúbený logovací nástroj.

            // V tomto príklade používame Serilog s NuGet balíkmi:
            // - Serilog.Extensions.Logging
            // - Serilog.Sinks.Console

            Serilog.ILogger serilogLogger = new LoggerConfiguration()
                .MinimumLevel.Debug() // úroveň podrobnosti logovaných správ
                .WriteTo.Console()
                .CreateLogger();

            // vytvorenie univerzálnej inštancie Microsoft.Extensions.Logging.ILoggerFactory
            ILoggerFactory loggerFactory = new SerilogLoggerFactory(serilogLogger);

            // otestovanie loggera
            loggerFactory.CreateLogger(nameof(SerilogLoggerExample)).LogDebug("Hello from SerilogExampleApp!");

            // vytvorenie vstupného bodu celého riešenia, inštancie triedy Client
            Client client = new NineDigit.eKasa.Client(configuration, loggerFactory);
        }
    }
}
```

Ďalšie možnosti nastavenia Serilogu nájdete v
[dokumentácii Serilogu](https://github.com/serilog/serilog/wiki/Configuration-Basics).

## Kam ďalej

- [Vytvorenie klienta](https://ekasa.ninedigit.sk/docs/dotnet/instantiation): Konštruktory triedy Client a jedna inštancia počas behu aplikácie.
- [Konfigurácia](https://ekasa.ninedigit.sk/docs/dotnet/configuration): Načítanie nastavení z aplikácie Portos eKasa Servis.
