<\/div>\n

Merhaba,<\/p>\n

Nas\u0131l ki; bir kaya par\u00e7as\u0131 tarihsel bir muammay\u0131 g\u00fcn\u00fcm\u00fcze ayd\u0131nlat\u0131c\u0131 bir bilgi ta\u015f\u0131yabiliyorsa, nas\u0131l ki; insan v\u00fccudundaki bir reaksiyon sa\u011fl\u0131\u011f\u0131na dair ge\u00e7mi\u015fini g\u00f6zler \u00f6n\u00fcne serebiliyorsa yahut nas\u0131l ki; be\u015feri hayatta devletler vatanda\u015flar\u0131 hakk\u0131nda istedi\u011fi zaman istedi\u011fi -zamana dair- verilere eri\u015febiliyorsa i\u015fte bunlara benzer bir \u015fekilde herhangi bir yaz\u0131l\u0131mda yar\u0131nlar\u0131na, ge\u00e7mi\u015fine dair izler b\u0131rakabilmelidir… En nihayetinde yukar\u0131da verilen bu \u00f6rnekler nihai olarak t\u00fcm varolu\u015fun d\u00fcn\u00fcne dair bizlere b\u0131rakt\u0131\u011f\u0131 ayd\u0131nlat\u0131c\u0131 bilgilerdir. \u0130\u015fte biz yaz\u0131l\u0131mc\u0131lar, nesnenin yahut olaylar\u0131n tabiat\u0131nda olan do\u011fal iz mekanizmalar\u0131n\u0131 irademizle yaz\u0131l\u0131mlar\u0131m\u0131za i\u015fleyerek sistemin i\u015fleyi\u015fini ad\u0131m ad\u0131m kay\u0131t alt\u0131na almakta ve bu yap\u0131lan\u0131da “Raporlama” ya da birba\u015fka deyi\u015fle “Loglama” \u015feklinde ifade ederek, yaz\u0131l\u0131m\u0131n bug\u00fcn\u00fcndeki i\u015fleyi\u015fi hakk\u0131nda yar\u0131nlara bilgiler ta\u015f\u0131maktay\u0131z.<\/p>\n

Asl\u0131nda yukar\u0131daki giri\u015fin biraz derin oldu\u011funu d\u00fc\u015f\u00fcnebilirsiniz, hatta aran\u0131zdan b\u00f6yle bir konuya abart\u0131l\u0131 bir giri\u015f oldu\u011funu dahi s\u00f6yleyenler olabilir. T\u00fcm bu fikirlere a\u00e7\u0131k ve sayg\u0131l\u0131 oldu\u011fum kadar bir o kadar da susam\u0131\u015f oldu\u011fumu bilmenizi isterim. Lakin bunun yan\u0131nda da \u015funu ifade etmek isterim ki, \u015fahsen ben bir konunun ya kuramsal ya da kavramsal olarak alt\u0131n\u0131 doldurmad\u0131k\u00e7a yapt\u0131\u011f\u0131m i\u015fin dayand\u0131\u011f\u0131 kolonlardan birinin eksik oldu\u011funu d\u00fc\u015f\u00fcnmekteyim. “Evet” birazdan Asp.NET Core mimarisinde Logging mekanizmas\u0131na dair –nas\u0131l uygulan\u0131r?<\/em>– sorusunun cevab\u0131 i\u00e7in hususi didiniyor olaca\u011f\u0131z ama bunun yan\u0131nda kavramsal a\u00e7\u0131dan raporlama yahut loglama terimlerini hi\u00e7 bilmeyenler i\u00e7in m\u00fcmk\u00fcn mertebe olay\u0131 tabiatla ili\u015fkilendirmenin eksiltici yan\u0131n\u0131 g\u00f6rmemekteyim.<\/p>\n

Her neyse…<\/p>\n

\u015eunu unutmamak gerekiyor ki loglama bir stratejidir. Yani sistemin herhangi bir ‘T’ zaman\u0131nda yapt\u0131\u011f\u0131 i\u015flemleri ad\u0131m ad\u0131m kayda almas\u0131d\u0131r. Ve yine herhangi bir ‘T + n’ zamanda ise ge\u00e7mi\u015fe dair -s\u00fcre\u00e7te neler olmu\u015f?- sorusuna kar\u015f\u0131l\u0131k metinsel ya da say\u0131sal istatiksel bilgiler veren mekanizmay\u0131 in\u015fa etmektir. \u0130\u015fte bizler bu stratejiyi bir\u00e7ok y\u00f6ntemle icra edebilece\u011fimiz gibi bu i\u00e7eri\u011fimizde bunlardan (iyi k\u00f6t\u00fc) birini ele alaca\u011f\u0131z. Asp.NET Core mimarisinde Logging mekanizmas\u0131n\u0131…<\/p>\n

Asp.NET Core \u0130le Logging<\/h3>\n
Bir uygulama i\u00e7in olmazsa olmaz \u00f6zelliklerinden birisi olan log mekanizmas\u0131, Asp.NET Core mimarisinde Logging framework\u00fc ile mod\u00fcler bir \u015fekilde uygulamaya dahil edilebilmekte ve sisteme entegresyonu ger\u00e7ekle\u015ftirilebilmektedir.<\/p>\n
Asp.NET Core mimarisinde Logging ara\u00e7lar\u0131na Microsoft.Extensions.Logging<\/span> k\u00fct\u00fcphanesinden eri\u015filmektedir.<\/p><\/blockquote>\n
Tabi devam etmeden \u00f6nce \u015funu belirtmek isterim ki, Asp.NET Core mimarisindeki dahili Logging mekanizmas\u0131 haz\u0131r sistemler i\u00e7erisinde genellikle kullan\u0131lan bir mekanizmaya sahip olmakla beraber olmazsa olmaz \u015feklinde d\u00fc\u015f\u00fcn\u00fclecek i\u015flevselli\u011fide sahip de\u011fildir. Bizler bu i\u00e7eri\u011fimizde bir Asp.NET Core uygulamas\u0131nda log i\u015flemleri i\u00e7in dahili olan Logging k\u00fct\u00fcphanesini sadece inceleyecek ve nas\u0131l entegrasyonun ger\u00e7ekle\u015ftirilece\u011fi \u00fczerine konu\u015faca\u011f\u0131z. Zira yaz\u0131l\u0131m projelerinde loglama mekanizmalar\u0131n\u0131 ilgili ekibin\/geli\u015fticinin ihtiyaca d\u00f6n\u00fck bir \u015fekilde kendilerinin tasarlamas\u0131 ve in\u015fa etmesi taraf\u0131mca tavsiye edilmektedir.<\/p>\n
Evet… \u015eimdi konumuza d\u00f6nersek e\u011fer Logging k\u00fct\u00fcphanesinde kullanaca\u011f\u0131m\u0131z enstr\u00fcnmanlar\u0131 inceleyerek ba\u015flayal\u0131m;<\/p>\n
\n
\nILogger<\/strong>
\nLoglama sorumlulu\u011funu \u00fcstlenecek olan s\u0131n\u0131f\u0131n imzas\u0131d\u0131r.\n<\/li>\n
\nLogger<\/strong>
\nLoglama sorumlulu\u011funu \u00fcstlenecek olan s\u0131n\u0131ft\u0131r.\n<\/li>\n
\nILoggerProvider<\/strong>
\nSa\u011flay\u0131c\u0131 sorumlulu\u011funu \u00fcstlenecek olan s\u0131n\u0131f\u0131n imzas\u0131d\u0131r.\n<\/li>\n
\nLoggerProvider<\/strong>
\nSa\u011flay\u0131c\u0131 sorumlulu\u011funu \u00fcstlenecek olan s\u0131n\u0131ft\u0131r. G\u00f6revi “Logger” s\u0131n\u0131f\u0131n\u0131 \u00fcretmektir.\n<\/li>\n
\nILoggerFactory<\/strong>
\nLog mekanizmas\u0131n\u0131 uygulamaya dahil eden ve g\u00f6rev olarakta “LoggerProvider” s\u0131n\u0131f\u0131n\u0131 \u00fcreterek sisteme dahil eden aray\u00fczd\u00fcr. Esas\u0131nda Asp.NET Core \u00e7ekirde\u011fi bu aray\u00fcz\u00fc implement eden “LoggerFactory”<\/em> isimli bir s\u0131n\u0131f bar\u0131nd\u0131rmaktad\u0131r. Runtime’da uygulama bu s\u0131n\u0131ftan olu\u015fturulan bir instance \u00fczerinden gerekli tan\u0131mlamalar\u0131 sa\u011flamaktad\u0131r.\n<\/li>\n<\/ul>\n
\u00d6rnek Uygulama<\/h3>\n
\u015eimdi yukar\u0131daki yap\u0131lanmay\u0131 g\u00f6z \u00f6n\u00fcne alarak bir \u00f6rnek icra edelim. \u0130lgili i\u00e7eri\u011fimizde Asp.NET Core 3.0 \u00e7ekirde\u011finde bir uygulama ile birlikte MVC deseni kullan\u0131lacakt\u0131r.<\/p>\n
\n
\nAd\u0131m 1<\/em><\/strong>
\n\u0130lk olarak loglama sorumlulu\u011funu \u00fcstlenecek olan “Logger” s\u0131n\u0131f\u0131n\u0131 olu\u015ftural\u0131m.<\/p>\n
\r\n public class Logger : ILogger\r\n {\r\n IHostingEnvironment _hostingEnvironment;\r\n public Logger(IHostingEnvironment hostingEnvironment) => _hostingEnvironment = hostingEnvironment;\r\n public IDisposable BeginScope<TState>(TState state) => null;\r\n public bool IsEnabled(LogLevel logLevel) => true;\r\n public async void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception exception, Func<TState, Exception, string> formatter)\r\n {\r\n using (StreamWriter streamWriter = new StreamWriter($"{_hostingEnvironment.ContentRootPath}\/log.txt", true))\r\n {\r\n await streamWriter.WriteLineAsync($"Log Level : {logLevel.ToString()} | Event ID : {eventId.Id} | Event Name : {eventId.Name} | Formatter : {formatter(state, exception)}");\r\n streamWriter.Close();\r\n await streamWriter.DisposeAsync();\r\n }\r\n }\r\n }\r\n<\/pre>\n
Dikkat ederseniz e\u011fer “Logger” s\u0131n\u0131f\u0131 “ILogger” aray\u00fcz\u00fcn\u00fc implemente etmekte ve “Log” isimli generic metot i\u00e7erisinde proje dizininde bulunan bir “.txt” uzant\u0131l\u0131 dosyaya gerekli loglamay\u0131 ger\u00e7ekle\u015ftirmektedir.\n<\/li>\n
\nAd\u0131m 2<\/em><\/strong>
\nSa\u011flay\u0131c\u0131 sorumlulu\u011funu \u00fcstlenecek olan “LoggerProvider” s\u0131n\u0131f\u0131n\u0131 \u00fcretelim.<\/p>\n
\r\n public class LoggerProvider : ILoggerProvider\r\n {\r\n public IHostingEnvironment _hostingEnvironment;\r\n public LoggerProvider(IHostingEnvironment hostingEnvironment) => _hostingEnvironment = hostingEnvironment;\r\n public ILogger CreateLogger(string categoryName) => new Logger(_hostingEnvironment);\r\n public void Dispose() => throw new NotImplementedException();\r\n }\r\n<\/pre>\n
Buradaki \u00f6nemli nokta, “CreateLogger” metodu i\u00e7erisinde yukar\u0131da olu\u015fturdu\u011fumuz “Logger” s\u0131n\u0131f\u0131ndan bir nesne \u00fcretilip geriye d\u00f6nd\u00fcr\u00fclmesidir.\n<\/li>\n
\nAd\u0131m 3<\/em><\/strong>
\nOlu\u015fturdu\u011fumuz yap\u0131lar neticesinde yukar\u0131daki “LoggerProvider” isimli sa\u011flay\u0131c\u0131 s\u0131n\u0131f\u0131 arac\u0131l\u0131\u011f\u0131yla “Logger” s\u0131n\u0131f\u0131ndan bir instance’i uygulamaya dahil etmemiz gerekmektedir. Bunun i\u00e7in “Startup.cs” dosyas\u0131ndaki “Configure” metodunda a\u015fa\u011f\u0131daki \u00e7al\u0131\u015fmay\u0131 yapmam\u0131z gerekmektedir.<\/p>\n
\r\n public class Startup\r\n {\r\n public Microsoft.AspNetCore.Hosting.IHostingEnvironment _hostingEnvironment { get; set; }\r\n public Startup(Microsoft.AspNetCore.Hosting.IHostingEnvironment hostingEnvironment) => _hostingEnvironment = hostingEnvironment;\r\n public void ConfigureServices(IServiceCollection services)\r\n {\r\n services.AddControllersWithViews();\r\n }\r\n public void Configure(IApplicationBuilder app, IWebHostEnvironment env, ILoggerFactory loggerFactory)\r\n {\r\n loggerFactory.AddProvider(new LoggerProvider(_hostingEnvironment));\r\n if (env.IsDevelopment())\r\n app.UseDeveloperExceptionPage();\r\n app.UseRouting();\r\n app.UseEndpoints(_ => _.MapControllerRoute("default", "{controller=Home}\/{action=Index}\/{id?}"));\r\n }\r\n }\r\n<\/pre>\n
Yukar\u0131daki kod blo\u011funu incelerseniz e\u011fer “Configure” metoduna “ILoggerFactory” parametresi eklenmi\u015ftir. \u0130lgili parametreye uygulama \u00e7ekirde\u011finden Runtime’da bir adet “LoggerFactory” instance’\u0131 ba\u011flanacak ve bu instance \u00fczerinden sisteme “LoggerProvider” nesnesi ile log mekanizmas\u0131 entegre edilmi\u015f olacakt\u0131r.\n<\/li>\n
\nAd\u0131m 4<\/em><\/strong>
\nArt\u0131k uygulamada hali haz\u0131rda kullan\u0131lmay\u0131 bekleyen bir log mekanizmas\u0131 mevcuttur. \u015eimdi yapmam\u0131z gereken ilgili Controller’da Dependency Injection ile “Logger” nesnesine talepte bulunmak ve istenilen noktada bu nesne \u00fczerinden gerekli loglar\u0131 almakt\u0131r.<\/p>\n
\r\n public class HomeController : Controller\r\n {\r\n public ILogger<HomeController> _logger;\r\n public HomeController(ILogger<HomeController> logger) => _logger = logger;\r\n public IActionResult Information()\r\n {\r\n _logger.LogInformation("Information mesaj\u0131...");\r\n return View();\r\n }\r\n public IActionResult Error()\r\n {\r\n _logger.LogError("Error mesaj\u0131...");\r\n return View();\r\n }\r\n public IActionResult Warning()\r\n {\r\n _logger.LogWarning("Warning mesaj\u0131...");\r\n return View();\r\n }\r\n }\r\n<\/pre>\n
Yukar\u0131daki kod blo\u011funda g\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere “Home(Controller).cs” s\u0131n\u0131f\u0131 i\u00e7erisinde “Information”, “Error” ve “Warning” olmak \u00fczere \u00fc\u00e7 farkl\u0131 action \u00fczerinde farkl\u0131 log fonksiyonlar\u0131 \u00e7a\u011fr\u0131lm\u0131\u015ft\u0131r. Uygulamaya derlenip, \u00e7al\u0131\u015ft\u0131r\u0131ld\u0131\u011f\u0131 vakit yukar\u0131daki actionlara yap\u0131lan birer request neticesinde uygulama dizininde olu\u015fturulan “log.txt” dosyas\u0131n\u0131n i\u00e7eri\u011fi a\u015fa\u011f\u0131daki gibi doldurulmu\u015f olacakt\u0131r.
\n $\"Asp.NET$ <\/a>\n<\/li>\n<\/ul>\n
Nihai olarak; hangi platform yahut proje olursa olsun bir uygulaman\u0131n olmazsa olmaz ana organlar\u0131ndan biri olan log mekanizmas\u0131 sisteme uygun e\u015flik edebilecek \u015fekilde tasarlanmal\u0131 ve yukar\u0131da belirtti\u011fim gibi tekrar ifade ediyorum ki m\u00fcmk\u00fcnse ilgili proje ihtiya\u00e7lar\u0131na \u00f6zel bir log mekanizmas\u0131 ortaya koyulmal\u0131d\u0131r. Tabi isterseniz de bu i\u00e7eri\u011fimizde oldu\u011fu gibi haz\u0131r olan Logging mekanizmas\u0131yla birlikte piyasada bulunan bir\u00e7ok haz\u0131r log mekanizmas\u0131n\u0131 uygulamalar\u0131n\u0131za entegre ederek kullanabilirsiniz.<\/p>\n
\u0130lgilenenlerin faydalanmas\u0131 dile\u011fiyle…
\nSonraki yaz\u0131lar\u0131mda g\u00f6r\u00fc\u015fmek \u00fczere…
\n\u0130yi \u00e7al\u0131\u015fmalar…<\/p>\n","protected":false},"excerpt":{"rendered":"
Merhaba, Nas\u0131l ki; bir kaya par\u00e7as\u0131 tarihsel bir muammay\u0131 g\u00fcn\u00fcm\u00fcze ayd\u0131nlat\u0131c\u0131 bir bilgi ta\u015f\u0131yabiliyorsa, nas\u0131l ki; insan v\u00fccudundaki bir reaksiyon sa\u011fl\u0131\u011f\u0131na dair ge\u00e7mi\u015fini g\u00f6zler \u00f6n\u00fcne serebiliyorsa yahut nas\u0131l ki; be\u015feri hayatta devletler vatanda\u015flar\u0131 hakk\u0131nda...<\/p>\n","protected":false},"author":1,"featured_media":9596,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2898],"tags":[2891,2893,2897,2895,2894,2896,2892],"class_list":["post-11242","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-asp-net-core-3-0","tag-asp-net-core-3-0","tag-ilogger","tag-iloggerfactory","tag-iloggerprovider","tag-logger","tag-loggerprovider","tag-logging"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/11242","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/comments?post=11242"}],"version-history":[{"count":40,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/11242\/revisions"}],"predecessor-version":[{"id":11283,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/11242\/revisions\/11283"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media\/9596"}],"wp:attachment":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media?parent=11242"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=11242"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=11242"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}