C# - Usando o Serilog


 Neste artigo vou apresentar o Serilog uma biblioteca para registro de diagnósticos, e log para arquivos que pode ser usada via console ou em outros locais.

O Serilog é uma biblioteca que você pode usar em aplicações .NET para realizar o logging. Ela é simples, fácil de configurar, tem uma API limpa e é portátil entre plataformas .NET recentes.

Os modelos de mensagem do Serilog são uma DSL simples que estende cadeias de string .NET. Os parâmetros podem ser nomeados e seus valores são serializados como propriedades no evento para uma incrível flexibilidade de pesquisa e classificação.

O Serilog usa uma API C# simples para configurar o log. Quando a configuração externa é desejável, você pode  usar o pacote Serilog.Settings.AppSettings (.NET Framework) ou o pacote Serilog.Settings.Configuration (.NET Core).

Os coletores de eventos de log geralmente registram eventos de log em alguma representação externa, geralmente o console,

A seguir temos um exemplo que usará o pacote de coletor de console, que imprime dados de registro e o pacote de coletor de arquivo, que grava eventos de registro em um conjunto de arquivos de texto com data e hora.

Install-Package Serilog.Sinks.Console
Install-Package Serilog.Sinks.File 

Os coletores são configurados usando o objeto de configuração WriteTo.

Criando uma aplicação Console .NET Core e instalando os dois pacotes:

Então se você quer criar apenas um simples log de arquivos basta usar o código abaixo:

using Serilog;
using System;
namespace ConsoleCore_Serilog
{
    class Program
    {
        static void Main(string[] args)
        {
            Log.Logger = new LoggerConfiguration()
                .WriteTo.Console()
                .CreateLogger();
            Log.Information("Usando Serilog...");
        }
    }
}

A seguir temos os principais os alvos de atributos:

Vários coletores podem estar ativos ao mesmo tempo. Para adicionar outros coletores  basta encadear blocos WriteTo:

using Serilog;
using System;
namespace ConsoleCore_Serilog
{
    class Program
    {
        static void Main(string[] args)
        {
            Log.Logger = new LoggerConfiguration()
                .WriteTo.Console()
                .CreateLogger();
            Log.Information("Usando Serilog...");           
            Log.Logger = new LoggerConfiguration()
            .WriteTo.Console()
            .WriteTo.File("log-.txt", rollingInterval: RollingInterval.Day)
            .CreateLogger();
            Log.Information("Usando mais um Serilog");
            Console.ReadKey();
        }
    }
}

Existem diversos outros recursos que você pode conferir.

No exemplo abaixo temos o registro em um aplicativo de console simples, com eventos enviados para o console, bem como um arquivo de log de rolagem com data e hora.

using Serilog;
using System;

namespace ConsoleCore_Serilog
{
    class Program
    {
        static void Main(string[] args)
        {
            Log.Logger = new LoggerConfiguration()
               .MinimumLevel.Debug()
               .WriteTo.Console()
               .WriteTo.File("logs\\meuLogapp.txt", rollingInterval: RollingInterval.Day)
               .CreateLogger();

            Log.Information("Olá, Serilog !");

            int a = 10, b = 0;
            try
            {
                Log.Debug("Dividindo {A} por {B}", a, b);
                Console.WriteLine(a / b);
            }
            catch (Exception ex)
            {
                Log.Error(ex, "Alguma coisa deu errado...");
            }

            Log.CloseAndFlush();
            Console.ReadKey();

        }
    }
}

O resultado obtido é mostrado a seguir:

Assim, o Serilog é um Logging que vale a pena estudar com mais carinho.

Configura a documentação em : https://serilog.net/

E estamos conversados...

"Naquele tempo, respondendo Jesus, disse: Graças te dou, ó Pai, Senhor do céu e da terra, que ocultaste estas coisas aos sábios e entendidos, e as revelaste aos pequeninos."
Mateus 11:25

Veja os Destaques e novidades do SUPER DVD Visual Basic (sempre atualizado) : clique e confira !

Quer migrar para o VB .NET ?

Quer aprender C# ??

Quer aprender os conceitos da Programação Orientada a objetos ?

Quer aprender o gerar relatórios com o ReportViewer no VS 2013 ?

Referências:


José Carlos Macoratti