EmfSeriLogLogging 1.0.9

EmfSeriLogLogging

Author / Yazar: Mehmet SEYİTOĞLU
Company / Şirket: EMF BİLGİSAYAR YAZILIM YÖNETİM VE DANIŞMANLIK HİZMETLERİ
Target Framework: .NET 10
License / Lisans: MIT

🇹🇷 Türkçe Dokümantasyon

Genel Bakış

EmfSeriLogLogging, .NET Core uygulamaları için Serilog kütüphanesi ile çoklu log hedefine yapılandırılmış loglama desteği sunan bir kütüphanedir. Console, Dosya (JSON) ve MSSQL Server olmak üzere üç farklı hedefe aynı anda log yazmayı sağlar.

Ne İşe Yarar?

• ✅ Console Log — Uygulama konsoluna renkli log çıktısı
• ✅ File Log — Günlük döndürülen JSON formatında dosya logu
• ✅ MSSQL Log — SQL Server veritabanına yapılandırılmış log kaydı
• ✅ Otomatik Logs tablosu oluşturma (autoCreateSqlTable)
• ✅ Kullanıcı adı/e-postası ile log zenginleştirme (UserNameEnricher)
• ✅ Makine adı ile log zenginleştirme (MachineName)
• ✅ Yapılandırılabilir log seviyesi
• ✅ Yapılandırılabilir log dosya yolu
• ✅ Tek satır kod ile tüm loglama altyapısını kurma

Kurulum

dotnet add package EmfSeriLogLogging

appsettings.json Konfigürasyonu

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=.;Database=MyApp;Trusted_Connection=True;TrustServerCertificate=True"
  },
  "Logging": {
    "LogFilePath": "logs/myapp.json",
    "LogLevel": {
      "Default": "Information"
    }
  }
}

DI Kaydı ve Yapılandırma

// Program.cs

// Tek satırda tüm loglama altyapısını kur
Logger.ConfigureLogging(builder.Services, builder.Configuration);

Özelleştirilmiş bölüm adları ile:

Logger.ConfigureLogging(
    builder.Services,
    builder.Configuration,
    connectionStringSection: "ConnectionStrings:LogDatabase",
    logFilePathSection: "Logging:CustomLogPath",
    logLevelSection: "Logging:LogLevel:Default"
);

Detaylı Kullanım

Otomatik SQL Tablosu

Kütüphane, MSSQL Server'da Logs tablosunu otomatik olarak oluşturur. Tablo şu sütunları içerir:

Kullanıcı Bilgisi Zenginleştirme

UserNameEnricher, HttpContext üzerinden oturum açmış kullanıcının bilgisini otomatik olarak her log kaydına ekler:

1. Önce ClaimTypes.Email değerini arar
2. Bulunamazsa ClaimTypes.Name değerini arar
3. Hiçbiri bulunamazsa "Anonymous" olarak kaydeder

Controller/Servis İçinde Loglama

public class ProductController : ControllerBase
{
    private readonly ILogger<ProductController> _logger;

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

    [HttpGet]
    public IActionResult GetProducts()
    {
        _logger.LogInformation("Ürünler listeleniyor...");

        try
        {
            // iş mantığı...
            _logger.LogInformation("Ürünler başarıyla listelendi. Toplam: {Count}", products.Count);
            return Ok(products);
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "Ürünler listelenirken hata oluştu");
            return StatusCode(500);
        }
    }

    [HttpPost]
    public IActionResult CreateProduct(ProductDto dto)
    {
        _logger.LogInformation("Yeni ürün oluşturuluyor: {ProductName}", dto.Name);

        // ...

        _logger.LogWarning("Ürün fiyatı çok düşük: {Price}", dto.Price);
    }
}

Log Seviyeleri

Log Çıktı Hedefleri

🇬🇧 English Documentation

Overview

EmfSeriLogLogging is a logging library for .NET Core applications that provides structured logging support via the Serilog library with multiple log sinks. It simultaneously writes logs to Console, File (JSON), and MSSQL Server.

What Does It Do?

• ✅ Console Log — Colorful output to the application console
• ✅ File Log — Daily rolling JSON formatted file log
• ✅ MSSQL Log — Structured log records to SQL Server database
• ✅ Automatic Logs table creation (autoCreateSqlTable)
• ✅ Log enrichment with user name/email (UserNameEnricher)
• ✅ Log enrichment with machine name (MachineName)
• ✅ Configurable log level
• ✅ Configurable log file path
• ✅ Setup entire logging infrastructure with a single line of code

Installation

dotnet add package EmfSeriLogLogging

appsettings.json Configuration

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=.;Database=MyApp;Trusted_Connection=True;TrustServerCertificate=True"
  },
  "Logging": {
    "LogFilePath": "logs/myapp.json",
    "LogLevel": {
      "Default": "Information"
    }
  }
}

DI Registration and Configuration

// Program.cs

// Setup entire logging infrastructure in a single line
Logger.ConfigureLogging(builder.Services, builder.Configuration);

With custom section names:

Logger.ConfigureLogging(
    builder.Services,
    builder.Configuration,
    connectionStringSection: "ConnectionStrings:LogDatabase",
    logFilePathSection: "Logging:CustomLogPath",
    logLevelSection: "Logging:LogLevel:Default"
);

Detailed Usage

Automatic SQL Table

The library automatically creates the Logs table in MSSQL Server. The table includes the following columns:

User Information Enrichment

UserNameEnricher automatically adds the authenticated user's information from HttpContext to every log entry:

1. First looks for ClaimTypes.Email
2. If not found, looks for ClaimTypes.Name
3. If neither is found, records as "Anonymous"

Logging in Controllers/Services

public class ProductController : ControllerBase
{
    private readonly ILogger<ProductController> _logger;

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

    [HttpGet]
    public IActionResult GetProducts()
    {
        _logger.LogInformation("Listing products...");

        try
        {
            // business logic...
            _logger.LogInformation("Products listed successfully. Total: {Count}", products.Count);
            return Ok(products);
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "Error occurred while listing products");
            return StatusCode(500);
        }
    }

    [HttpPost]
    public IActionResult CreateProduct(ProductDto dto)
    {
        _logger.LogInformation("Creating new product: {ProductName}", dto.Name);

        // ...

        _logger.LogWarning("Product price is too low: {Price}", dto.Price);
    }
}

Log Levels

Log Output Sinks

API Reference / API Referansı

Method Signature / Metot İmzası

public static void ConfigureLogging(
    IServiceCollection services,
    IConfiguration configuration,
    string connectionStringSection = "ConnectionStrings:DefaultConnection",
    string logFilePathSection = "Logging:LogFilePath",
    string logLevelSection = "Logging:LogLevel:Default"
)

Dependencies / Bağımlılıklar

• Serilog (4.3.1)
• Serilog.AspNetCore (10.0.0)
• Serilog.Sinks.Console (6.1.1)
• Serilog.Sinks.File (7.0.0)
• Serilog.Sinks.MSSqlServer (9.0.3)