Serilog .NET (Geliştiriciler İçin Nasıl Çalışır)

Yapılandırılmış Kayıt

Serilog'un öne çıkan özelliklerinden biri, yapısal günlükleme desteğidir. Serilog, basitçe mesajları düz metin olarak kaydetmek yerine, yapılandırılmış verileri kaydetmenize olanak tanır. Bu yapılandırılmış veri bir JSON nesnesi, bir sözlük veya serileştirilebilen herhangi bir tür olabilir. Yapılandırılmış verileri kaydederek, Elasticsearch veya Splunk gibi araçları kullanarak günlük olaylarını kolayca analiz edebilir ve sorgulayabilirsiniz.

Esnek Yapılandırma

Serilog, uygulamanızın ihtiyaçlarına göre günlükleme davranışını özelleştirmenizi sağlayan esnek yapılandırma seçenekleri sunar. Serilog'u programla veya yapılandırma dosyaları kullanarak yapılandırabilirsiniz. Bu esneklik, uygulama yeniden başlatmalarına gerek kalmadan çalışma zamanında günlük kaydı davranışını ayarlamanıza olanak tanır.

Sink Kütüphaneleri

Serilog, log olaylarını farklı hedeflere göndermenizi sağlayan çeşitli sink kütüphaneleri sunar. Popüler sink kütüphanelerinden bazıları şunlardır:

• Serilog.Sinks.Console: Günlük olaylarını konsola gönderir. Serilog.Sinks.File: Günlük olaylarını metin dosyalarına yazar. Serilog.Sinks.Seq: Seq'ye, yapılandırılmış bir günlük sunucusuna, günlük olaylarını gönderir.
• Serilog.Sinks.Elasticsearch: Log etkinliklerini Elasticsearch'e gönderir.

Bu sink kütüphaneleri, Serilog'u farklı loglama altyapısı ve araçlarıyla entegre etmeyi kolaylaştırır.

Günlük Zenginleştirme

Günlük zenginleştirme, günlük olaylarınıza ek bağlamsal bilgi eklemenize olanak tanıyan bir özelliktir. Serilog, log olaylarınıza zaman damgası, thread ID'si veya log seviyesi gibi bilgileri otomatik olarak ekleyebilen çeşitli zenginleştiriciler sağlar. Uygulamaya özel bilgileri eklemek için özel zenginleştiriciler de oluşturabilirsiniz.

Log Filtreleme

Serilog, çeşitli kriterlere göre günlük olaylarını filtrelemenize olanak tanır. Günlük olaylarını günlük seviyesi, özellik değerleri veya başka herhangi bir koşula göre hariç tutmak veya dahil etmek için filtreler yapılandırabilirsiniz. Bu filtreleme yeteneği, analiziniz veya sorun giderme işlemleriniz için en ilgili olan günlük olaylarına odaklanmanıza olanak tanır.

Bu özellikleri anlayarak ve kullanarak, Serilog'un gücünden yararlanabilir, günlükleme yeteneklerinizi geliştirebilir ve uygulamanızın davranışları hakkında değerli içgörüler elde edebilirsiniz.

Yapılandırılmış Kayıt: Temel Bir Özellik

Serilog'un başlıca gücü, günlük mesajlarını yapılandırılmış verilere dönüştürmesinde yatar. Diğer günlükleme kütüphanelerinin düz metin çıktısı vermesinin aksine, Serilog, günlük verilerini ayrıştırmayı ve sorgulamayı basitleştirerek yapılandırılmış JSON formatında günlükler oluşturur. Günümüz uygulamaları için bu yetenek, operasyonel zekanın bir parçası olarak log analizi ve izleme açısından kritik öneme sahiptir. Yapılandırılmış günlükler, gelişmiş analiz için ELK (Elasticsearch, Logstash, Kibana) yığını gibi sistemlere bir günlük mesajı alındığında özellikle faydalıdır.

Zengin Log Olay Detayları

Serilog, günlük olaylarını bağlamsal bilgilerle zenginleştirir ve bir uygulamanın içindeki olayların kapsamlı bir görünümünü sunar. Her günlük olayı, basit bir günlük mesajının ötesinde, zaman damgaları, günlük seviyeleri, istisna detayları ve özel özellikler dahil birçok detay içerebilir. Bu, Serilog'u logun derinliği ve netliği açısından diğer log kütüphanelerinden üstün kılar, geliştiricilere uygulamanın davranışı ve performansı hakkında kritik içgörüler sunar.

Yapılandırma Dosyası ile

Günlük seviyelerini, çıktı hedeflerini (örneğin, günlük dosyaları veya konsol) ve günlük çıktı formatını tanımlamak için yapılandırma JSON dosyasını kullanın. Yapılandırma dosyası yaklaşımı, kodu değiştirmeden günlükleme davranışını değiştirme esnekliği sunar. Bu işlem, appsettings.json dosyasındaki ayarları belirterek yapılır ve günlük çıktınızı bir konsol, bir dosya veya hatta bulut tabanlı günlük yönetim hizmetleri gibi çeşitli çıkışlara yönlendirmenizi sağlar.

Kodda Programatik Olarak

Alternatif olarak, LoggerConfiguration sınıfını kullanarak Serilog'u doğrudan kodda yapılandırın. Bu yöntem, dinamik log seviyesi veya özel log hedefleri gibi daha karmaşık log senaryolarını yapılandırmak için sıklıkla kullanılır. Örneğin, belirli aralıklarla veya belirli bir boyuta ulaşıldığında yeni bir günlük dosyası oluşturan bir döner günlük dosyasını yapılandırarak, günlük dosyası yönetimini verimli bir şekilde sağlayabilirsiniz.

// Create a logger instance with a rolling log file that creates a new log file every day
var logger = new LoggerConfiguration()
    .WriteTo.File("logs/myapp.txt", rollingInterval: RollingInterval.Day) 
    .CreateLogger();

// Create a logger instance with a rolling log file that creates a new log file every day
var logger = new LoggerConfiguration()
    .WriteTo.File("logs/myapp.txt", rollingInterval: RollingInterval.Day) 
    .CreateLogger();

' Create a logger instance with a rolling log file that creates a new log file every day
Dim logger = (New LoggerConfiguration()).WriteTo.File("logs/myapp.txt", rollingInterval:= RollingInterval.Day).CreateLogger()

ASP.NET Core ile Entegrasyon

Serilog'u ASP.NET Core ile entegre etmek, Serilog paketini Paket Yöneticisi Konsolu aracılığıyla eklemek ve Program.cs dosyasında günlüğü ayarlamak ile ilgilidir. .NET 6'daki var builder ve var app ifadeleri, Serilog'u uygulamanın günlük kaydı altyapısına sorunsuz bir şekilde entegre eder. Bu işlem, varsayılan logger'ı Serilog ile değiştirir ve tüm günlük mesajlarının Serilog hattı üzerinden işlenmesini sağlar.

var builder = WebApplication.CreateBuilder(args);

// Configure Serilog to use settings from appsettings.json and write logs to the console
builder.Host.UseSerilog((ctx, lc) => lc
    .WriteTo.Console()
    .ReadFrom.Configuration(ctx.Configuration));

var app = builder.Build();

var builder = WebApplication.CreateBuilder(args);

// Configure Serilog to use settings from appsettings.json and write logs to the console
builder.Host.UseSerilog((ctx, lc) => lc
    .WriteTo.Console()
    .ReadFrom.Configuration(ctx.Configuration));

var app = builder.Build();

Dim builder = WebApplication.CreateBuilder(args)

' Configure Serilog to use settings from appsettings.json and write logs to the console
builder.Host.UseSerilog(Function(ctx, lc) lc.WriteTo.Console().ReadFrom.Configuration(ctx.Configuration))

Dim app = builder.Build()

IronPDF

IronPDF, .NET uygulamaları içinde PDF dosyalarının oluşturulmasına, okunmasına ve düzenlenmesine olanak tanır. Bu, özellikle log verilerinin PDF raporlarını oluşturmak ve log bilgilerini standart bir formatta kolayca dağıtmak ve görüntülemek için Serilog ile birleştirildiğinde oldukça faydalı olabilir.

IronOCR

IronOCR, görüntüleri 125 dilde metne çevirebilen bir Optik Karakter Tanıma (OCR) kütüphanesidir. Bu özellik, metin verilerinin görüntülerden veya taranmış belgelerden çıkarılması gerektiği kayıt senaryolarında kullanılabilir, böylece log verileri daha fazla bağlamsal bilgi ile zenginleştirilir.

IronXL

IronXL, Office Interop gerekmeden Excel ile çalışma işlevselliği sağlar. Bu, özellikle log verilerinin Excel'e aktarılıp daha fazla analiz ve raporlama için kullanılabileceği için kayıt amaçları için faydalı olabilir, veri manipülasyonu ve görselleştirme için tanıdık bir arayüz sunar.

IronBarcode

IronBarcode, QR kodları ve barkodları okuma ve yazmayı kolaylaştırır. Bu kütüphane, günlük dosyaları içinde kodlanmış bilgileri gömebilir veya çıkarabilir, kaydedilen bilgilerin güvenliğini ve izlenebilirliğini artırır.