.NET API’lerini Prometheus ile Monit\u00f6r Etme<\/p>\n
Modern bir .NET API’sinin performans\u0131n\u0131 ve sa\u011fl\u0131\u011f\u0131n\u0131 izlemek, uygulaman\u0131z\u0131n ba\u015far\u0131s\u0131 i\u00e7in kritik \u00f6neme sahiptir. Uygulaman\u0131z\u0131n beklenmedik hatalardan kaynaklanan kesintilere u\u011framamas\u0131 ve kullan\u0131c\u0131 deneyiminin olumsuz etkilenmemesi i\u00e7in ger\u00e7ek zamanl\u0131 izleme \u015fartt\u0131r. Bu makalede, .NET API’lerinizi Prometheus kullanarak nas\u0131l etkili bir \u015fekilde izleyebilece\u011finizi ad\u0131m ad\u0131m \u00f6\u011freneceksiniz. Prometheus’un g\u00fc\u00e7l\u00fc metrik toplama yetenekleri sayesinde, uygulaman\u0131z\u0131n performans\u0131n\u0131 detayl\u0131 bir \u015fekilde analiz edebilir, potansiyel sorunlar\u0131 \u00f6nceden tespit edebilir ve daha sa\u011flam bir sistem in\u015fa edebilirsiniz.<\/p>\n
Prometheus, a\u00e7\u0131k kaynakl\u0131 bir izleme ve alarm sistemidir. Sisteminize kurdu\u011funuz exporter’lar arac\u0131l\u0131\u011f\u0131yla metrikler toplar ve bu metrikleri g\u00f6rselle\u015ftirmenizi ve analiz etmenizi sa\u011flar. .NET uygulaman\u0131zda Prometheus ile izleme yapmak i\u00e7in genellikle bir .NET Prometheus k\u00fct\u00fcphanesi kullan\u0131r\u0131z. Bu k\u00fct\u00fcphane, API’nizdeki \u00f6nemli metrikleri (istek s\u00fcresi, hata oran\u0131, i\u015flem say\u0131s\u0131 gibi) Prometheus’un anlayabilece\u011fi bir formatta sunar. Ba\u015fka bir deyi\u015fle, Prometheus bir veri toplama arac\u0131d\u0131r ve bu verileri \u00e7e\u015fitli panolarda ve ara\u00e7larda g\u00f6rselle\u015ftirmenizi sa\u011flar. Grafana, Prometheus ile s\u0131k\u00e7a kullan\u0131lan pop\u00fcler bir g\u00f6rselle\u015ftirme arac\u0131d\u0131r.<\/p>\n
\u00d6ncelikle, Prometheus’un \u00e7al\u0131\u015fma prensiplerini anlamak \u00f6nemlidir. Prometheus, belirli aral\u0131klarla hedef sistemlerdeki (yani, .NET API’niz) tan\u0131mlanm\u0131\u015f u\u00e7 noktalara (endpoints) istek g\u00f6ndererek metrikleri \u00e7eker. Bu u\u00e7 noktalar, genellikle Bunun yan\u0131nda, Prometheus’un sundu\u011fu \u00f6nemli kavramlar \u015funlard\u0131r:<\/p>\n * Metrikler (Metrics):<\/strong> Sisteminizin durumunu temsil eden say\u0131sal verilerdir (\u00f6rne\u011fin, istek say\u0131s\u0131, i\u015flem s\u00fcresi, bellek kullan\u0131m\u0131). Bu temel kavramlar\u0131 anlad\u0131ktan sonra, .NET API’nizi Prometheus ile izleme s\u00fcrecine ge\u00e7ebilirsiniz.<\/p>\n Bu b\u00f6l\u00fcmde, .NET API’nizi Prometheus ile izlemek i\u00e7in ad\u0131m ad\u0131m bir k\u0131lavuz sunaca\u011f\u0131z. \u00d6ncelikle, gerekli k\u00fct\u00fcphaneleri projenize eklemeniz gerekiyor. Daha sonra, uygulaman\u0131zda metrikleri toplayacak ve Prometheus’a sunacak kodlar\u0131 yazman\u0131z gerekecek. Son olarak, Prometheus sunucusunu yap\u0131land\u0131rman\u0131z ve Grafana gibi bir g\u00f6rselle\u015ftirme arac\u0131 kullanarak metrikleri g\u00f6r\u00fcnt\u00fclemeniz gerekecektir.<\/p>\n 1. Gerekli K\u00fct\u00fcphanelerin Eklenmesi:<\/strong><\/p>\n \u00d6ncelikle, NuGet paket y\u00f6neticisi arac\u0131l\u0131\u011f\u0131yla projenize <\/code><\/p>\n <\/code>using Prometheus;<\/p>\n \/\/ ... di\u011fer kodlar ...<\/p>\n var requestDuration = Metrics.CreateHistogram(\"request_duration_seconds\", \"Request duration in seconds\");<\/p>\n \/\/ ... istek i\u015fleme kodu ...<\/p>\n requestDuration.Observe(elapsedTime); \/\/elapsedTime istek s\u00fcresini tutan de\u011fi\u015fken<\/code><\/p>\n Bu kod, 3. Metriklerin Sunulmas\u0131:<\/strong><\/p>\n Prometheus, metrikleri <\/code><\/p>\n Bu kod, 9100 portunda bir sunucu ba\u015flat\u0131r ve Prometheus'un metrikleri buradan almas\u0131n\u0131 sa\u011flar.<\/p>\n 4. Prometheus Sunucusunun Yap\u0131land\u0131r\u0131lmas\u0131:<\/strong><\/p>\n Prometheus sunucusunu \u00e7al\u0131\u015ft\u0131rman\u0131z ve uygulaman\u0131z\u0131n <\/code><\/p>\n 5. Grafana ile G\u00f6rselle\u015ftirme:<\/strong><\/p>\n Toplanan metrikleri g\u00f6rselle\u015ftirmek i\u00e7in Grafana gibi bir ara\u00e7 kullanabilirsiniz. Grafana'y\u0131 Prometheus veritaban\u0131na ba\u011flayarak, \u00f6zelle\u015ftirilebilir g\u00f6sterge panolar\u0131 olu\u015fturabilirsiniz.<\/p>\n \u015eimdi, ger\u00e7ek d\u00fcnya senaryolar\u0131nda .NET API izleme uygulamalar\u0131na bakal\u0131m.<\/p>\n Senaryo 1: E-ticaret Platformu:<\/strong><\/p>\n Bir e-ticaret platformunun API'sini ele alal\u0131m. Prometheus ile izlenebilecek \u00f6nemli metrikler \u015funlard\u0131r:<\/p>\n * \u00dcr\u00fcn sayfalar\u0131na yap\u0131lan isteklerin s\u00fcresi:<\/strong> Yava\u015f yan\u0131t s\u00fcreleri, \u00fcr\u00fcn sayfalar\u0131n\u0131n performans\u0131n\u0131 etkiler. Senaryo 2: Sosyal Medya Uygulamas\u0131:<\/strong><\/p>\n Bir sosyal medya uygulamas\u0131n\u0131n API'sinde izlenebilecek \u00f6nemli metrikler \u015funlard\u0131r:<\/p>\n * Post yay\u0131nlama i\u015flemlerinin s\u00fcresi:<\/strong> Yava\u015f yay\u0131nlama s\u00fcreleri, kullan\u0131c\u0131 etkile\u015fimini d\u00fc\u015f\u00fcr\u00fcr. Bu senaryolar, Prometheus'un .NET API'lerin performans\u0131n\u0131 ve g\u00fcvenilirli\u011fini izlemekte ne kadar etkili oldu\u011funu g\u00f6stermektedir. Prometheus sayesinde, potansiyel sorunlar\u0131 \u00f6nceden tespit edebilir ve kullan\u0131c\u0131 deneyimini iyile\u015ftirebilirsiniz.<\/p>\n Bu b\u00f6l\u00fcmde, deneyimli geli\u015ftiriciler i\u00e7in baz\u0131 ileri d\u00fczey teknikler ele alaca\u011f\u0131z.<\/p>\n 1. Performans Optimizasyonu:<\/strong><\/p>\n Prometheus'un performans\u0131n\u0131 etkilememesi i\u00e7in metrik toplama i\u015flemlerini optimize etmeniz \u00f6nemlidir. \u00c7ok say\u0131da metrik toplaman\u0131z gerekiyorsa, toplama frekans\u0131n\u0131 ayarlayabilir veya baz\u0131 metrikleri \u00f6rnekleme yapabilirsiniz. Ayr\u0131ca, metrik isimlerini ve etiketlerini k\u0131sa ve \u00f6z tutarak performans\u0131 art\u0131rabilirsiniz.<\/p>\n 2. G\u00fcvenlik:<\/strong><\/p>\n Prometheus sunucusunun g\u00fcvenli\u011fini sa\u011flamak \u00f6nemlidir. Sunucuya yetkisiz eri\u015fimi engellemek i\u00e7in g\u00fcvenlik duvar\u0131 kullanabilir ve yetkilendirme mekanizmalar\u0131 uygulayabilirsiniz. Ayr\u0131ca, Prometheus'un toplad\u0131\u011f\u0131 metrikleri hassas veriler i\u00e7erip i\u00e7ermedi\u011fini kontrol edin ve gerekti\u011finde hassas bilgileri maskeleyin.<\/p>\n\/metrics<\/code> gibi bir yolda bulunur ve Prometheus’un okuyup anlayabilece\u011fi \u00f6zel bir formatta (OpenMetrics) metrik verilerini i\u00e7erir. Bu metrikler, etiketlerle (label) zenginle\u015ftirilebilir ve b\u00f6ylece daha ayr\u0131nt\u0131l\u0131 analizler yapman\u0131za olanak tan\u0131r. \u00d6rne\u011fin, bir istek s\u00fcresi metri\u011fi i\u00e7in, HTTP metodu, URL yolu gibi etiketler kullanarak farkl\u0131 istek t\u00fcrlerinin performans\u0131n\u0131 kar\u015f\u0131la\u015ft\u0131rabilirsiniz.<\/p>\n
\n* Etiketler (Labels):<\/strong> Metrikleri daha ayr\u0131nt\u0131l\u0131 olarak s\u0131n\u0131fland\u0131rmak i\u00e7in kullan\u0131lan anahtar-de\u011fer \u00e7iftleridir.
\n* G\u00f6sterge Panolar\u0131 (Dashboards):<\/strong> Toplanan metrikleri g\u00f6rselle\u015ftirmek ve analiz etmek i\u00e7in kullan\u0131l\u0131r.
\n* Uyar\u0131lar (Alerts):<\/strong> Belirli metrik de\u011ferlerine ula\u015f\u0131ld\u0131\u011f\u0131nda tetiklenen bildirimlerdir.<\/p>\n.NET API’nizi Prometheus ile \u0130zlemek \u0130\u00e7in Ad\u0131m Ad\u0131m K\u0131lavuz<\/h2>\n
Prometheus.Client<\/code> k\u00fct\u00fcphanesini eklemeniz gerekir. Bu k\u00fct\u00fcphane, .NET uygulamalar\u0131n\u0131zda Prometheus metriklerini toplaman\u0131z\u0131 sa\u011flar.<\/p>\ndotnet add package Prometheus.Client<\/pre>\n2. Metriklerin Tan\u0131mlanmas\u0131 ve Toplanmas\u0131:<\/strong>\n\nUygulaman\u0131zda izlemek istedi\u011finiz metrikleri tan\u0131mlaman\u0131z ve bunlar\u0131 Prometheus'a bildirmeniz gerekir. \u00d6rne\u011fin, istek s\u00fcresini izlemek i\u00e7in a\u015fa\u011f\u0131daki kodu kullanabilirsiniz:<\/pre>\nrequest_duration_seconds<\/code> adl\u0131 bir histogram metri\u011fi olu\u015fturur. Histogram, olaylar\u0131n da\u011f\u0131l\u0131m\u0131n\u0131 izlemek i\u00e7in idealdir. Observe<\/code> metodu, \u00f6l\u00e7\u00fclen de\u011feri histograma ekler.<\/p>\n\/metrics<\/code> u\u00e7 noktas\u0131ndan alacakt\u0131r. Bu u\u00e7 noktay\u0131 uygulaman\u0131zda sunman\u0131z gerekir. Bunun i\u00e7in, MetricServer<\/code> s\u0131n\u0131f\u0131n\u0131 kullanabilirsiniz:<\/p>\nvar server = new MetricServer(new MetricServerOptions { Port = 9100 });\nserver.Start();<\/pre>\n\/metrics<\/code> u\u00e7 noktas\u0131n\u0131 hedefleyecek \u015fekilde yap\u0131land\u0131rmal\u0131s\u0131n\u0131z. Prometheus yap\u0131land\u0131rma dosyas\u0131nda (genellikle prometheus.yml<\/code>) a\u015fa\u011f\u0131daki gibi bir hedef tan\u0131mlayabilirsiniz:<\/p>\nscrape_configs:\n - job_name: 'my_dotnet_api'\n static_configs:\n - targets: ['localhost:9100']<\/pre>\nGer\u00e7ek D\u00fcnya Senaryolar\u0131: Vaka Analizleri<\/h2>\n
\n* Sepet i\u015flemlerinin ba\u015far\u0131 oran\u0131:<\/strong> Hata oran\u0131 y\u00fcksekse, al\u0131\u015fveri\u015f sepeti i\u015flemlerinde sorunlar olabilir.
\n* \u00d6deme i\u015flemlerinin ortalama s\u00fcresi:<\/strong> Uzun \u00f6deme s\u00fcreleri, kullan\u0131c\u0131 deneyimini olumsuz etkiler.<\/p>\n
\n* Kullan\u0131c\u0131 yetkilendirme i\u015flemlerinin ba\u015far\u0131 oran\u0131:<\/strong> Hata oran\u0131 y\u00fcksekse, kullan\u0131c\u0131 giri\u015finde sorunlar olabilir.
\n* Yorum ekleme i\u015flemlerinin s\u00fcresi:<\/strong> Yava\u015f yorum ekleme s\u00fcreleri, kullan\u0131c\u0131 deneyimini olumsuz etkiler.<\/p>\n\u0130leri D\u00fczey Teknikler: Performans Optimizasyonu ve G\u00fcvenlik<\/h2>\n