mcp-mermaid logger.ts Dosyas\u0131: Derinlemesine Bir \u0130nceleme<\/p>\n
mcp-mermaid projesinin kalbinde yer alan \u00d6ncelikle, g\u00fcnl\u00fck kay\u0131tlar\u0131n\u0131n (logging) yaz\u0131l\u0131m geli\u015ftirmedeki \u00f6nemini anlamak gerekir. G\u00fcnl\u00fck kay\u0131tlar\u0131, bir uygulaman\u0131n \u00e7al\u0131\u015fmas\u0131 s\u0131ras\u0131nda olu\u015fan olaylar\u0131, hatalar\u0131 ve di\u011fer \u00f6nemli bilgileri kaydeder. Bu bilgiler, uygulaman\u0131n performans\u0131n\u0131 izlemek, hatalar\u0131 ay\u0131klamak ve g\u00fcvenlik a\u00e7\u0131klar\u0131n\u0131 tespit etmek i\u00e7in son derece de\u011ferlidir. Bu kod blo\u011fu, hata mesajlar\u0131n\u0131 hem konsola hem de Yeni ba\u015flayan seviyesinin \u00fczerine \u00e7\u0131kmak i\u00e7in, A\u015fa\u011f\u0131daki tabloda, farkl\u0131 loglama y\u00f6ntemlerinin performans kar\u015f\u0131la\u015ft\u0131rmas\u0131 g\u00f6sterilmektedir:<\/p>\n Bir e-ticaret uygulamas\u0131 d\u00fc\u015f\u00fcn\u00fcn. Bu uygulamada, \u00fcr\u00fcn sipari\u015fleri, \u00f6deme i\u015flemleri ve kullan\u0131c\u0131 oturumlar\u0131 gibi bir\u00e7ok olay ger\u00e7ekle\u015fir. logger.ts<\/code> dosyas\u0131, uygulaman\u0131n g\u00fcnl\u00fck kay\u0131tlar\u0131n\u0131 (log) y\u00f6netmek i\u00e7in kritik bir rol oynar. Bu dosya, hata ay\u0131klama, izleme ve performans analizi gibi \u00e7e\u015fitli ama\u00e7lar i\u00e7in detayl\u0131 bilgiler sa\u011flar. Bu makale, logger.ts<\/code> dosyas\u0131n\u0131n i\u015flevselli\u011fini, yap\u0131s\u0131n\u0131 ve kullan\u0131m\u0131n\u0131 ad\u0131m ad\u0131m a\u00e7\u0131klayarak, hem yeni ba\u015flayanlar hem de deneyimli geli\u015ftiriciler i\u00e7in kapsaml\u0131 bir rehber sunmay\u0131 ama\u00e7lamaktad\u0131r. Ba\u015ftan sona, kod \u00f6rnekleri ve pratik senaryolarla desteklenen bu rehber, logger.ts<\/code> dosyas\u0131n\u0131 etkili bir \u015fekilde anlaman\u0131za ve kullanman\u0131za yard\u0131mc\u0131 olacakt\u0131r.<\/p>\nlogger.ts<\/code> Dosyas\u0131n\u0131n Temel Kavramlar\u0131 Nedir?<\/h2>\nlogger.ts<\/code> dosyas\u0131, mcp-mermaid projesinde bu g\u00fcnl\u00fck kay\u0131tlar\u0131n\u0131 y\u00f6netmek i\u00e7in \u00f6zel olarak tasarlanm\u0131\u015ft\u0131r. Basit\u00e7e s\u00f6ylemek gerekirse, uygulaman\u0131n i\u00e7erisinde ne olup bitti\u011fini anlamam\u0131z\u0131 sa\u011flayan bir penceredir. Bu dosya, farkl\u0131 seviyelerde (\u00f6rne\u011fin, hata, uyar\u0131, bilgi) log kay\u0131tlar\u0131n\u0131 olu\u015fturman\u0131za ve bunlar\u0131 \u00e7e\u015fitli hedeflere (konsol, dosya vb.) y\u00f6nlendirmenize olanak tan\u0131r. Daha sonra, bu kay\u0131tlar\u0131 analiz ederek uygulama davran\u0131\u015f\u0131n\u0131 daha iyi anlayabilir ve sorunlar\u0131 daha h\u0131zl\u0131 \u00e7\u00f6zebilirsiniz. \u00d6rne\u011fin, bir hata olu\u015ftu\u011funda, logger.ts<\/code> dosyas\u0131n\u0131n \u00fcretti\u011fi hata mesaj\u0131, hatan\u0131n kayna\u011f\u0131n\u0131 belirlemenize yard\u0131mc\u0131 olabilir.<\/p>\nlogger.ts<\/code> Dosyas\u0131n\u0131 Nas\u0131l Kullan\u0131r\u0131m? (Yeni Ba\u015flayanlar \u0130\u00e7in)<\/h2>\nlogger.ts<\/code> dosyas\u0131n\u0131 kullanmaya ba\u015flamak olduk\u00e7a basittir. Genellikle, bir logging k\u00fct\u00fcphanesi (\u00f6rne\u011fin, Winston, Bunyan) kullanarak farkl\u0131 seviyelerde log mesajlar\u0131 kaydedebilirsiniz. \u00d6rne\u011fin, Winston k\u00fct\u00fcphanesi kullan\u0131larak bir hata mesaj\u0131 \u015fu \u015fekilde kaydedilebilir:<\/p>\n\nimport * as winston from 'winston';\n\nconst logger = winston.createLogger({\n level: 'info',\n format: winston.format.json(),\n transports: [\n new winston.transports.Console(),\n new winston.transports.File({ filename: 'error.log', level: 'error' }),\n ],\n});\n\nlogger.error('Bu bir hata mesaj\u0131d\u0131r!');\nlogger.warn('Bu bir uyar\u0131 mesaj\u0131d\u0131r!');\nlogger.info('Bu bir bilgi mesaj\u0131d\u0131r!');\n<\/code><\/pre>\nerror.log<\/code> dosyas\u0131na kaydederken, uyar\u0131 ve bilgi mesajlar\u0131n\u0131 yaln\u0131zca konsola kaydeder. Bu \u00f6rnekte, farkl\u0131 log seviyeleri ve \u00e7\u0131kt\u0131 hedefleri g\u00f6sterilmi\u015ftir. Daha fazla \u00f6zelle\u015ftirme i\u00e7in Winston k\u00fct\u00fcphanesinin dok\u00fcmanlar\u0131na bakabilirsiniz. Ba\u015flang\u0131\u00e7 i\u00e7in basit bir \u015fekilde loglama i\u015flemlerini ger\u00e7ekle\u015ftirmek olduk\u00e7a kolayd\u0131r ve h\u0131zl\u0131 bir \u015fekilde projenize entegre edebilirsiniz. Bu sayede, kodunuzun hangi a\u015famalar\u0131nda sorunlar oldu\u011funu kolayca tespit edebilirsiniz.<\/p>\nOrta Seviye Kullan\u0131m: \u00d6zelle\u015ftirme ve \u0130leri Teknikler<\/h2>\n
logger.ts<\/code> dosyas\u0131n\u0131 projenizin \u00f6zel ihtiya\u00e7lar\u0131na g\u00f6re \u00f6zelle\u015ftirmeniz gerekebilir. \u00d6rne\u011fin, log mesajlar\u0131na zaman damgas\u0131 eklemek, \u00f6zel formatlar kullanmak veya log kay\u0131tlar\u0131n\u0131 uzak bir sunucuya g\u00f6ndermek isteyebilirsiniz. Bunun i\u00e7in, kullanmakta oldu\u011funuz logging k\u00fct\u00fcphanesinin sa\u011flad\u0131\u011f\u0131 \u00f6zelle\u015ftirme se\u00e7eneklerini kullanman\u0131z gerekir. \u00d6rne\u011fin, log mesajlar\u0131na \u00e7a\u011fr\u0131 y\u0131\u011f\u0131n\u0131n\u0131n (stack trace) eklenmesi, hata ay\u0131klamay\u0131 kolayla\u015ft\u0131r\u0131r. Ayr\u0131ca, farkl\u0131 ortamlar (geli\u015ftirme, test, \u00fcretim) i\u00e7in farkl\u0131 loglama yap\u0131land\u0131rmalar\u0131 kullanmak, uygulaman\u0131n performans\u0131n\u0131 ve g\u00fcvenli\u011fini art\u0131r\u0131r. Bunun i\u00e7in, \u00e7evre de\u011fi\u015fkenlerini kullanarak veya yap\u0131land\u0131rma dosyalar\u0131yla farkl\u0131 ortamlara g\u00f6re loglama ayarlar\u0131n\u0131 de\u011fi\u015ftirebilirsiniz. \u00d6rne\u011fin, geli\u015ftirme ortam\u0131nda daha ayr\u0131nt\u0131l\u0131 log kay\u0131tlar\u0131 tutarken, \u00fcretim ortam\u0131nda daha az ayr\u0131nt\u0131l\u0131 log kay\u0131tlar\u0131 tutabilirsiniz. Bu da hem geli\u015ftirme s\u00fcrecinizi kolayla\u015ft\u0131r\u0131r hem de \u00fcretim ortam\u0131n\u0131n performans\u0131n\u0131 olumsuz etkilemesini engeller. \u00d6nemli bir nokta da, log mesajlar\u0131n\u0131 okunabilir ve analiz edilebilir hale getirmek i\u00e7in uygun bir format kullanmakt\u0131r.<\/p>\n\u0130leri D\u00fczey Kullan\u0131m: Performans Optimizasyonu ve G\u00fcvenlik<\/h2>\n
logger.ts<\/code> dosyas\u0131n\u0131n performans\u0131, \u00f6zellikle y\u00fcksek y\u00fck alt\u0131nda \u00e7al\u0131\u015fan uygulamalar i\u00e7in kritik \u00f6nem ta\u015f\u0131r. A\u015f\u0131r\u0131 miktarda log kayd\u0131 olu\u015fturmak, uygulaman\u0131n performans\u0131n\u0131 olumsuz etkileyebilir. Bu nedenle, loglama i\u015flemlerini optimize etmek \u00f6nemlidir. \u00d6rne\u011fin, gereksiz log kay\u0131tlar\u0131n\u0131 olu\u015fturmaktan ka\u00e7\u0131nmal\u0131, performans gerektiren i\u015flemlerin loglar\u0131n\u0131 ayr\u0131nt\u0131l\u0131 bir \u015fekilde kaydetmekten ka\u00e7\u0131nmal\u0131 ve log mesajlar\u0131n\u0131 \u00f6nbelle\u011fe alarak (batch logging) performans\u0131 art\u0131rabilirsiniz. Bununla birlikte, loglama i\u015flemlerinde g\u00fcvenlik de olduk\u00e7a \u00f6nemlidir. Log kay\u0131tlar\u0131nda hassas bilgiler (\u00f6rne\u011fin, \u015fifreler, kredi kart\u0131 numaralar\u0131) bulunmamas\u0131na dikkat edilmelidir. Hassas bilgilerin loglanmas\u0131n\u0131 \u00f6nlemek i\u00e7in, bu bilgileri masklemek veya loglama i\u015flemlerinden tamamen hari\u00e7 tutmak gerekir. Ayr\u0131ca, log dosyalar\u0131n\u0131n g\u00fcvenli bir \u015fekilde saklanmas\u0131 ve yetkisiz eri\u015fimden korunmas\u0131 gerekmektedir. Uygulamada, log kay\u0131tlar\u0131n\u0131n d\u00fczenli olarak kontrol edilmesi ve gerekirse ar\u015fivlenmesi, g\u00fcvenlik a\u00e7\u0131s\u0131ndan \u00f6nemli bir ad\u0131md\u0131r. Ayr\u0131ca, log kay\u0131tlar\u0131n\u0131 analiz ederek potansiyel g\u00fcvenlik a\u00e7\u0131klar\u0131n\u0131 tespit edebilirsiniz. Bu konuda, kullan\u0131lan logging k\u00fct\u00fcphanesinin g\u00fcvenlik a\u00e7\u0131klar\u0131n\u0131 d\u00fczenli olarak kontrol etmek ve g\u00fcncellemek \u00f6nemlidir.<\/p>\nPerformans Kar\u015f\u0131la\u015ft\u0131rmas\u0131: Farkl\u0131 Loglama Y\u00f6ntemleri<\/h3>\n
\n\n
\n \nY\u00f6ntem<\/th>\n Performans<\/th>\n Avantajlar<\/th>\n Dezavantajlar<\/th>\n<\/tr>\n<\/thead>\n \n Konsol Loglama<\/td>\n D\u00fc\u015f\u00fck<\/td>\n Basit ve h\u0131zl\u0131<\/td>\n Y\u00fcksek y\u00fck alt\u0131nda performans sorunlar\u0131na yol a\u00e7abilir<\/td>\n<\/tr>\n \n Dosya Loglama<\/td>\n Orta<\/td>\n Kal\u0131c\u0131 kay\u0131t tutar<\/td>\n Dosya boyutlar\u0131 b\u00fcy\u00fcyebilir<\/td>\n<\/tr>\n \n Uzak Sunucu Loglama<\/td>\n Y\u00fcksek<\/td>\n Merkezi log y\u00f6netimi sa\u011flar<\/td>\n Ba\u011flant\u0131 sorunlar\u0131na neden olabilir<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Ger\u00e7ek D\u00fcnya Senaryolar\u0131: Vaka Analizleri<\/h2>\n
logger.ts<\/code> dosyas\u0131, bu olaylar\u0131n her birini kaydeder ve sistemin performans\u0131n\u0131 izler. \u00d6rne\u011fin, bir \u00f6deme i\u015flemi ba\u015far\u0131s\u0131z oldu\u011funda, logger.ts<\/code> dosyas\u0131, hata mesaj\u0131n\u0131, zaman damgas\u0131n\u0131 ve ilgili di\u011fer bilgileri kaydeder. Bu bilgiler, geli\u015ftirme ekibinin hatay\u0131 bulmas\u0131na ve \u00e7\u00f6zmesine yard\u0131mc\u0131 olur. Benzer \u015fekilde, bir kullan\u0131c\u0131 hesab\u0131na yetkisiz eri\u015fim giri\u015fimi oldu\u011funda, logger.ts<\/code> dosyas\u0131 bu olay\u0131 kaydeder ve g\u00fcvenlik ekibine bir uyar\u0131 g\u00f6nderir. Bir ba\u015fka senaryo ise, bir web uygulamas\u0131nda kullan\u0131c\u0131 etkile\u015fimlerinin kaydedilmesidir. Bu, kullan\u0131c\u0131 deneyimini geli\u015ftirmek ve web sitesinin performans\u0131n\u0131 iyile\u015ftirmek i\u00e7in kullan\u0131l\u0131r. logger.ts<\/code> dosyas\u0131, kullan\u0131c\u0131lar\u0131n hangi sayfalar\u0131 ziyaret etti\u011fini, ne kadar s\u00fcre kald\u0131\u011f\u0131n\u0131 ve hangi eylemleri ger\u00e7ekle\u015ftirdi\u011fini kaydeder. Bu veriler daha sonra analiz edilerek, kullan\u0131c\u0131lar\u0131n web sitesini nas\u0131l kulland\u0131klar\u0131 hakk\u0131nda bilgi edinilebilir ve web sitesinin kullan\u0131c\u0131 dostu hale getirilmesi i\u00e7in ad\u0131mlar at\u0131labilir. Bu veriler ayr\u0131ca, web sitesinin performans\u0131n\u0131 iyile\u015ftirmek i\u00e7in de kullan\u0131labilir.<\/p>\n\u00d6\u011frenme Yol Haritas\u0131<\/h2>\n
Yeni Ba\u015flayan:<\/h3>\n