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

Yapılandırılmış Günlük

Serilog'un öne çıkan özelliklerinden biri, yapılandırılmış günlüğü desteklemesidir. Serilog, mesajları düz metin olarak günlüğe almak yerine, yapılandırılmış veri olarak günlüğe almanıza olanak tanır. Bu yapılandırılmış veri, bir JSON nesnesi, bir sözlük veya serileştirilebilecek başka herhangi bir tür olabilir. Yapılandırılmış veri günlüğe alarak, Elasticsearch veya Splunk gibi araçlarla 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ük davranışını özelleştirmenize olanak tanıyan esnek yapılandırma seçenekleri sunar. Serilog'u programlı olarak veya yapılandırma dosyalarını kullanarak yapılandırabilirsiniz. Bu esneklik, uygulama yeniden başlatmaları gerektirmeden günlük davranışını çalışırken ayarlamanıza olanak tanır.

Sink Kitaplıkları

Serilog, günlük olaylarını farklı hedeflere göndermeye olanak tanıyan çeşitli sink kitaplıkları sağlar. Bazı popüler sink kitaplıkları ş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: Günlük olaylarını yapılandırılmış bir günlük sunucusu olan Seq'ye gönderir.
• Serilog.Sinks.Elasticsearch: Günlük olaylarını Elasticsearch'e gönderir.

Bu sink kitaplıkları, Serilog'u farklı günlük altyapıları ve araçlarıyla entegre etmeyi kolaylaştırır.

Günlüğü Zenginleştirme

Günlüğü zenginleştirme, günlük olaylarınıza ek bağlamsal bilgi eklemenize olanak tanıyan bir özelliktir. Serilog, tarih-saat, işlem ID'si veya günlük seviyesi gibi bilgileri otomatik olarak günlük olaylarınıza ekleyebilen çeşitli zenginleştiriciler sunar. Ayrıca, uygulamanıza özgü bilgileri eklemek için özel zenginleştiriciler oluşturabilirsiniz.

Günlük Filtreleme

Serilog, çeşitli kriterlere göre günlük olaylarını filtrelemenize izin verir. Günlük seviyesine, özelliğe, veya başka bir duruma bağlı olarak günlük olaylarını hariç tutmak veya dahil etmek için filtreler yapılandırabilirsiniz. Bu filtreleme yeteneği, analiz veya sorun giderme için en önemli olan günlük olaylarına odaklanmanızı sağlar.

Bu özellikleri anlamak ve kullanmak, Serilog'u etkin bir şekilde kullanarak günlük yeteneklerinizi geliştirebilir ve uygulamanızın davranışına dair değerli bilgiler elde edebilirsiniz.

Yapılandırılmış Günlük: Temel Bir Özellik

Serilog'un ana gücü, günlük mesajlarını yapılandırılmış veriye dönüştürmekte yatar. Diğer günlük kitaplıkları düz metin çıktısı sağlarken, Serilog, log verilerini daha kolay analiz etmek ve sorgulamak için JSON formatında yapılandırılmış günlükler üretir. Bu yetenek, günümüz uygulamaları için, log analizi ve izleme işlem yeteneklerinin operasyonel zekanın ayrılmaz parçası olduğu yerlerde kritik öneme sahiptir. Yapılandırılmış günlükler, bir günlük mesajının ELK (Elasticsearch, Logstash, Kibana) yığını gibi sistemlere ileri düzey analiz için dahil edilmesi durumunda özellikle faydalıdır.

Zengin Günlük Olayı Detayları

Serilog, günlük olaylarını bağlamsal bilgilerle zenginleştirir, bir uygulama içinde neler olduğunu kapsamlı bir şekilde gösterir. Her günlük olayı, basit bir günlük mesajının ötesinde çok sayıda ayrıntı içerebilir; bunlar arasında zaman damgaları, günlük seviyeleri, hata detayları ve özel özellikler bulunur. Bu, Serilog'u, log derinliği ve netliği açısından diğer günlük kitaplıklarına kıyasla üstün kılar ve geliştiricilere uygulamanın davranışı ve performansı hakkında kritik bilgiler sunar.

Yapılandırma Dosyasıyla

Günlük seviyelerini, çıktı noktalarını (örneğin günlük dosyaları veya konsol) ve günlük çıktısı 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ük davranışını değiştirme esnekliği sunar. Bu, log çıktılarını bir konsol, bir dosya veya bulut tabanlı log yönetim hizmetleri gibi çeşitli hedeflere yönlendirmenize olanak tanıyan appsettings.json dosyasına ayarları belirleyerek yapılır.

Kod İçinde Programatik Olarak

Alternatif olarak, Serilog'u doğrudan kodda LoggerConfiguration sınıfını kullanarak yapılandırın. Bu yöntem genellikle daha karmaşık günlük senaryolarını, örneğin dinamik günlük seviyeleri veya özel günlük hedeflerini ayarlamak için kullanılır. Örneğin, belirli aralıklarla veya belirli bir boyuta ulaştığında yeni bir günlük dosyası oluşturan bir döner günlük dosyası yapılandırabilir, böylece etkili günlük dosyası yönetimi sağlanabilir.

// 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 Entegre Etme

Serilog'u ASP.NET Core ile entegre etmek, Package Manager Console aracılığıyla Serilog paketini eklemeyi ve logger'ı Program.cs dosyasında kurmayı içerir. .NET 6'da var builder ve var app ifadeleri, Serilog'un uygulamanın logging altyapısına sorunsuz şekilde bağlanmasını sağlar. Bu işlem, varsayılan günlüğü Serilog ile değiştirir ve tüm günlük mesajlarının Serilog boru 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'lerin oluşturulmasını, okunmasını ve düzenlenmesini sağlar. Bu, günlük verilerinin PDF raporlarını oluşturmak için Serilog ile birleştirildiğinde özellikle yararlı olabilir, bu sayede günlük bilgilerinin standart bir formatta kolayca dağıtılması ve görüntülenmesi mümkün kılınır.

IronOCR

IronOCR, 125 dildeki metinleri resimlere çeviren bir Optik Karakter Tanıma (OCR) kütüphanesidir. Bu özellik, metin verilerinin görüntülerden veya taranmış belgelerden çıkarılması gereken günlük senaryolarında kullanılabilir ve böylece günlük verilere daha fazla bağlamsal bilgi kazandırılabilir.

IronXL

IronXL, Office Interop'a ihtiyaç duymadan Excel ile çalışma işlevselliği sağlar. Bu, günlük verilerinin analiz ve raporlama için Excel'e aktarılması gibi günlük amaçlar için özellikle faydalı olabilir ve veri manipülasyonu ve görselleştirme için tanıdık bir arayüz sunar.

IronBarcode

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