{"id":26377,"date":"2023-06-25T22:07:29","date_gmt":"2023-06-25T22:07:29","guid":{"rendered":"https:\/\/www.gencayyildiz.com\/blog\/?p=26377"},"modified":"2023-06-25T22:07:29","modified_gmt":"2023-06-25T22:07:29","slug":"nette-serilog-ile-amazon-cloudwatchta-logging-islemleri","status":"publish","type":"post","link":"https:\/\/www.gencayyildiz.com\/blog\/nette-serilog-ile-amazon-cloudwatchta-logging-islemleri\/","title":{"rendered":".NET’te Serilog \u0130le Amazon CloudWatch’ta Logging \u0130\u015flemleri"},"content":{"rendered":"
<\/div>\n

Merhaba,<\/p>\n

Bu i\u00e7eri\u011fimizde Amazon CloudWatch servisi \u00fczerine odaklanacak ve .NET’te Serilog ile Amazon CloudWatch’a logging i\u015flemlerini ele al\u0131yor olaca\u011f\u0131z. Her \u015feyden \u00f6nce loglama s\u00fcre\u00e7lerinde kulland\u0131\u011f\u0131m\u0131z g\u00fc\u00e7l\u00fc bir k\u00fct\u00fcphane olan Serilog ve g\u00f6rselle\u015ftirme arac\u0131 olan Seq ile ilgili daha \u00f6nceden klavyeye alm\u0131\u015f oldu\u011fu Asp.NET Core \u2013 Serilog \u0130le Veri Loglama ve Seq \u0130le G\u00f6rselle\u015ftirme<\/a> ba\u015fl\u0131kl\u0131 makaleme g\u00f6z atabilir, ard\u0131ndan bu makaleye devam edebilirsiniz. Bizler ise bu konulara vak\u0131f olanlarla yol al\u0131p, bu i\u00e7eri\u011fin ta\u015flar\u0131n\u0131 d\u00f6\u015femeye ba\u015flayal\u0131m…<\/p>\n

Amazon CloudWatch Nedir?<\/h3>\n

Amazon CloudWatch, Amazon Web Services(AWS) taraf\u0131ndan \u00fcretilen bir izleme(monitoring) ve y\u00f6netim hizmetidir. CloudWatch; AWS servislerinin ve bu servislerde \u00e7al\u0131\u015fan uygulamalar\u0131n\u0131z\u0131n canl\u0131 s\u00fcre\u00e7lerde nas\u0131l tepki verdiklerini izlemek i\u00e7in kullan\u0131lmakta ve b\u00f6ylece uygulaman\u0131za dair altyap\u0131 sonu\u00e7lar\u0131n\u0131, performans durumlar\u0131n\u0131 ve g\u00fcvenilirli\u011fi de\u011ferlendirebilmenizi sa\u011flamaktad\u0131r. Ayr\u0131ca CloudWatch ile \u00e7e\u015fitli AWS kaynaklar\u0131n\u0131 da izleyebilir ve bu kaynaklardan istedi\u011finiz metrikleri ve loglar\u0131 kendi uygulama \u00e7er\u00e7evelerinizde kullanabilirsiniz.<\/p>\n

CloudWatch’\u0131n temel i\u015flevi; \u00f6l\u00e7\u00fcmler ve metriklerle ilgili veriler toplamak ve bu verileri bir aray\u00fczde yahut API arac\u0131l\u0131\u011f\u0131yla kullan\u0131labilir hale getirmektir. Toplad\u0131\u011f\u0131 metrikler; CPU kullan\u0131m\u0131, a\u011f b\u00f6l\u00fcmleri, depolama alan\u0131 kullan\u0131m\u0131 vs. gibi performans g\u00f6r\u00fcnt\u00fcs\u00fc temsil eden de\u011ferlerdir diyebiliriz. Bunlar\u0131n yan\u0131nda s\u0131kl\u0131kla kulland\u0131\u011f\u0131m\u0131z uygulamaya dair hatalar\u0131, uyar\u0131lar\u0131 ve loglar\u0131 da toplamakta ve bu verileri kullan\u0131labilir veya izlenebilir hale getirmektedir.<\/p>\n

T\u00fcm bunlar\u0131n d\u0131\u015f\u0131nda, CloudWatch ile belli olaylara kar\u015f\u0131l\u0131k tepki olarak otomatik i\u015flemleri ger\u00e7ekle\u015ftirebilir, filanca bir metri\u011fin belirlenmi\u015f bir adil s\u0131n\u0131r\u0131 a\u015f\u0131m\u0131 durumunda otomatik olarak k\u0131s\u0131tlamalar ba\u015flatabilir veya hata durumlar\u0131nda bildirimler g\u00f6nderebilirsiniz.<\/p>\n

.NET’te Serilog \u0130le Amazon CloudWatch’ta Logging<\/h3>\n

.NET’te Serilog ile Amazon CloudWatch’ta loggin i\u015flemini ele alabilmek i\u00e7in basit bir uygulama \u00fczerinden pratik yapmam\u0131z gayet yeterli olacakt\u0131r kanaatindeyim. \u015eimdi bunun i\u00e7in bir Asp.NET Core API projesi olu\u015fturunuz ve ilgili projeye a\u015fa\u011f\u0131daki k\u00fct\u00fcphaneleri y\u00fckleyiniz.<\/p>\n\n\n\n\n\n\n\n\n
K\u00fct\u00fcphane<\/th>\nA\u00e7\u0131klama<\/th>\n<\/tr>\n<\/thead>\n
AWS.Logger.SeriLog<\/a><\/td>\nBu k\u00fct\u00fcphane, .NET uygulamalar\u0131nda Serilog kullanarak AWS CloudWatch’a loglama i\u015flemi i\u00e7in kullan\u0131lan ve AWS taraf\u0131ndan resmi olarak tan\u0131t\u0131lan bir k\u00fct\u00fcphanedir.<\/td>\n<\/tr>\n
Serilog.AspNetCore<\/a><\/td>\nBu k\u00fct\u00fcphane, Asp.NET Core uygulamalar\u0131 i\u00e7in loglama s\u00fcre\u00e7lerinde Serilog’u kullanmay\u0131 sa\u011flar.<\/td>\n<\/tr>\n
Serilog.Settings.Configuration<\/a><\/td>\nBu k\u00fct\u00fcphane, Serilog’un loglama yap\u0131land\u0131rmalar\u0131n\u0131 okumak i\u00e7in kullan\u0131lmaktad\u0131r.<\/td>\n<\/tr>\n
Serilog.Sinks.Console<\/a><\/td>\nBu k\u00fct\u00fcphane ise Serilog’un toplad\u0131\u011f\u0131 bilgileri console’a yazd\u0131rmak i\u00e7in kullan\u0131lmaktad\u0131r.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

K\u00fct\u00fcphaneleri y\u00fckledikten sonra uygulaman\u0131n ‘Program.cs’ dosyas\u0131nda a\u015fa\u011f\u0131daki gibi Serilog i\u00e7in temel yap\u0131land\u0131rmay\u0131 ger\u00e7ekle\u015ftirelim.<\/p>\n

\n
\r\nbuilder.Host.UseSerilog((_, logger) => logger.WriteTo.Console().ReadFrom.Configuration(builder.Configuration));\r\n<\/pre>\n<\/div>\n
Ard\u0131ndan bu yap\u0131land\u0131rmay\u0131 besleyebilmek i\u00e7in ‘appsettings.json’ dosyas\u0131na da a\u015fa\u011f\u0131daki konfig\u00fcrasyonel de\u011ferleri ekleyelim:<\/p>\n
\n
\r\n{\r\n  "Logging": {\r\n    "LogLevel": {\r\n      "Default": "Information",\r\n      "Microsoft.AspNetCore": "Warning",\r\n      "Microsoft": "Warning"\r\n    }\r\n  },\r\n  "AllowedHosts": "*",\r\n  "Serilog": {\r\n    "LogGroup": "\/logs\/example",\r\n    "Region": "ap-south-1",\r\n    "MinimumLevel": {\r\n      "Default": "Debug",\r\n      "Override": {\r\n        "Microsoft": "Error",\r\n        "System": "Error",\r\n        "Microsoft.Hosting.Lifetime": "Information"\r\n      }\r\n    },\r\n    "WriteTo": [\r\n      {\r\n        "Name": "AWSSeriLog",\r\n        "Args": {\r\n          "textFormatter": "Serilog.Formatting.Json.JsonFormatter, Serilog"\r\n        }\r\n      }\r\n    ]\r\n  }\r\n}\r\n\r\n<\/pre>\n<\/div>\n
Yukar\u0131daki konfig\u00fcrasyonel \u00e7al\u0131\u015fmaya g\u00f6z atarsan\u0131z e\u011fer; 11.<\/strong><\/em> sat\u0131rdaki ‘LogGroup’, her uygulama veya kullan\u0131m durumu i\u00e7in CloudWatch’da ayr\u0131 bir log blo\u011funa kar\u015f\u0131l\u0131k gelen ay\u0131r\u0131c\u0131 \u00f6zelli\u011fi ifade etmekte ve bu uygulamaya \u00f6zel de ‘\/logs\/example’ de\u011ferinde grup ad\u0131 konfig\u00fcre edilmektedir. Bunun haricinde opsiyonel olan 12.<\/strong><\/em> sat\u0131rdaki ‘Region’ tan\u0131m\u0131n\u0131n d\u0131\u015f\u0131ndakiler klasik Serilog konfig\u00fcrasyonuyla alakal\u0131 yap\u0131land\u0131rmalard\u0131r.<\/p>\n
Esas\u0131nda yap\u0131lmas\u0131 gereken t\u00fcm i\u015flemler bundan ibarettir. Bundan sonra kurulumu test edebilmek i\u00e7in basit bir controller olu\u015ftural\u0131m ve i\u00e7erisinde bir ka\u00e7 loglamayla ilgili \u00e7al\u0131\u015fma yapal\u0131m.<\/p>\n
\n
\r\n    [Route("api\/[controller]")]\r\n    [ApiController]\r\n    public class ValuesController : ControllerBase\r\n    {\r\n        private readonly ILogger<ValuesController> _logger;\r\n\r\n        public ValuesController(ILogger<ValuesController> logger)\r\n            => _logger = logger;\r\n\r\n        [HttpGet]\r\n        public IActionResult Get()\r\n        {\r\n            _logger.LogDebug("Debug Log");\r\n            _logger.LogInformation("Information Log");\r\n            _logger.LogError("Error Log");\r\n            return Ok();\r\n        }\r\n    }\r\n<\/pre>\n<\/div>\n
Yap\u0131lan bu \u00e7al\u0131\u015fma neticesinde ilgili controller’a istek g\u00f6nderdi\u011fimizde Amazon CloudWatch’ta a\u015fa\u011f\u0131daki g\u00f6rseldeki gibi yap\u0131land\u0131rmaya uygun Log Group olu\u015fturulacak ve gerekli loglama ger\u00e7ekle\u015ftirilmi\u015f olunacakt\u0131r.\".NET'te<\/a>\".NET'te<\/a>\".NET'te<\/a>Ayr\u0131ca Amazon CloudWatch’a kaydedilecek loglar\u0131n hata d\u00fczeyini de belirlemek istiyorsan\u0131z a\u015fa\u011f\u0131daki gibi restrictedToMinimumLevel<\/code> \u00fczerinden bir konfig\u00fcrasyon ger\u00e7ekle\u015ftirebilirsiniz.<\/p>\n
\n
\r\n  .\r\n  .\r\n  .\r\n    "WriteTo": [\r\n      {\r\n        "Name": "AWSSeriLog",\r\n        "Args": {\r\n          "textFormatter": "Serilog.Formatting.Json.JsonFormatter, Serilog",\r\n          "restrictedToMinimumLevel": "Error"\r\n        }\r\n      }\r\n    ]\r\n<\/pre>\n<\/div>\n
Yukar\u0131daki gibi bir yap\u0131land\u0131rma neticesinde uygulama sadece hata(error) olan loglar\u0131 CloudWatch’a g\u00f6nderecek, di\u011ferlerini eleyecektir.<\/p>\n
Son olarak; geli\u015ftirdi\u011fimiz uygulaman\u0131n herhangi bir noktas\u0131nda AWS’ye dair bir kimlik do\u011frulama ger\u00e7ekle\u015ftirilmedi\u011fi halde, nas\u0131l oluyor da AWS CloudWatch’a loglar g\u00f6nderiliyor diye sorarsan\u0131z e\u011fer bunun AWS SDK’s\u0131 ile ger\u00e7ekle\u015ftirildi\u011fini bilmenizde fayda vard\u0131r. Asp.NET Core uygulamalar\u0131nda, Serilog ile yazd\u0131r\u0131lan log’lar\u0131n AWS CloudWatch’a g\u00f6nderilmesini sa\u011flamak i\u00e7in, AWS SDK’s\u0131 kullan\u0131lmakta ve b\u00f6ylece ekstradan bir yap\u0131land\u0131rmaya gerek duyulmamaktad\u0131r.<\/p>\n
Yap\u0131land\u0131rma dosyas\u0131ndaki ‘AWSSeriLog’ b\u00f6l\u00fcm\u00fc, Serilog taraf\u0131ndan gelen log’lar\u0131n AWS CloudWatch’a g\u00f6nderilmesi gerekti\u011fini ifade etmekte ve bunun i\u00e7in uygulaman\u0131n \u00e7al\u0131\u015ft\u0131\u011f\u0131 ortamdaki AWS IAM(Identity Access Management)’den kimlik do\u011frulama i\u00e7in gerekli bilgiler edinilerek, AWS SDK’i taraf\u0131ndan kullan\u0131lmaktad\u0131r. Yani uzun laf\u0131n k\u0131sas\u0131, uygulama Serilog yap\u0131land\u0131rmas\u0131nda AWS CloudWatch hedefi i\u00e7in, AWS SDK’si sayesinde otomatik olarak IAM kimlik bilgilerini kullanarak loglar\u0131 Amazon CloudWatch’a g\u00f6ndermektedir.<\/p>\n
Haliyle uygulamay\u0131 ilk etapta localhost \u00fczerinde test etti\u011fimiz i\u00e7in ee do\u011fal olarak local’de ki AWS IAM profil bilgilerinin do\u011fru oldu\u011fundan emin olman\u0131z gerekmektedir.<\/p>\n
\u0130lgilenenlerin faydalanmas\u0131 dile\u011fiyle…
\nSonraki yaz\u0131lar\u0131mda g\u00f6r\u00fc\u015fmek \u00fczere…
\n\u0130yi \u00e7al\u0131\u015fmalar…<\/p>\n
Not : \u00d6rnek projeye a\u015fa\u011f\u0131daki github adresinden eri\u015febilirsiniz.
\nhttps:\/\/github.com\/gncyyldz\/AWS.CloudWatch.Serilog.Example<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Merhaba, Bu i\u00e7eri\u011fimizde Amazon CloudWatch servisi \u00fczerine odaklanacak ve .NET’te Serilog ile Amazon CloudWatch’a logging i\u015flemlerini ele al\u0131yor olaca\u011f\u0131z. Her \u015feyden \u00f6nce loglama s\u00fcre\u00e7lerinde kulland\u0131\u011f\u0131m\u0131z g\u00fc\u00e7l\u00fc bir k\u00fct\u00fcphane olan Serilog ve g\u00f6rselle\u015ftirme arac\u0131 olan...<\/p>\n","protected":false},"author":1,"featured_media":3014,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4730],"tags":[4879,4881,4731,4734,4747,4882,4880],"class_list":["post-26377","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-aws","tag-amazon-cloudwatch","tag-amazon-web-services","tag-aws","tag-aws-iam","tag-cloudwatch","tag-identity-access-management","tag-serilog"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/26377","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=26377"}],"version-history":[{"count":7,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/26377\/revisions"}],"predecessor-version":[{"id":26388,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/26377\/revisions\/26388"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media\/3014"}],"wp:attachment":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media?parent=26377"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=26377"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=26377"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}