🎡 👨🏿‍✈️ 💽 NodeJS में कैसे लॉग इन करें ताकि लड़कों को यार्ड में सम्मान मिले 👍🏾 ◽️ 🏠

जब आप अपने NodeJS एप्लिकेशन में पठनीय लॉग को व्यवस्थित करने का प्रयास करते हैं, तो आपको सबसे अधिक क्या प्रभावित करता है? व्यक्तिगत रूप से, मैं ट्रेस आईडी बनाने के लिए किसी भी समझदार मानकों की कमी से बेहद परेशान हूं। इस लेख में, हम एक ट्रेस आईडी बनाने के विकल्पों के बारे में बात करेंगे, आइए एक नज़र डालते हैं कि हमारी उंगलियों पर निरंतरता-स्थानीय भंडारण या सीएलएस कैसे काम करता है और किसी भी लकड़हारे के साथ इसे प्राप्त करने के लिए प्रॉक्सी के बल पर कॉल करें।

प्रत्येक अनुरोध के लिए ट्रेस आईडी बनाने के साथ NodeJS में कोई समस्या क्यों है?

पुराने, पुराने, पुराने दिनों में, जब स्तनधारी अभी भी पृथ्वी पर चले गए थे, तो सभी-सभी-सर्वरों को बहु-थ्रेडेड किया गया था और एक अनुरोध के लिए एक नया धागा बनाया। इस प्रतिमान के ढांचे के भीतर, एक ट्रेस आईडी बनाना तुच्छ है, क्योंकि थ्रेड-लोकल स्टोरेज या टीएलएस जैसी कोई चीज है, जो आपको मेमोरी में कुछ डेटा डालने की अनुमति देती है जो इस स्ट्रीम में किसी भी फंक्शन के लिए उपलब्ध है। अनुरोध को संसाधित करने की शुरुआत में, आप यादृच्छिक ट्रेस आईडी को रिडीम कर सकते हैं, इसे टीएलएस में डाल सकते हैं और फिर इसे किसी भी सेवा में पढ़ सकते हैं और इसके साथ कुछ कर सकते हैं। परेशानी यह है कि यह NodeJS में काम नहीं करेगा।

एनओडीजेएस एकल-थ्रेडेड है (काफी नहीं, श्रमिकों की उपस्थिति को देखते हुए, लेकिन ट्रेस आईडी के साथ समस्या की रूपरेखा के भीतर, श्रमिक कोई भूमिका नहीं निभाते हैं), इसलिए आप टीएलएस के बारे में भूल सकते हैं। यहाँ प्रतिमान अलग है - एक ही धागे के भीतर विभिन्न कॉलबैक का एक गुच्छा टॉगल करने के लिए, और जैसे ही फ़ंक्शन असिंक्रोनस कुछ करना चाहता है, इस एसिंक्रोनस अनुरोध को भेजें, और प्रोसेसर को कतार में किसी अन्य फ़ंक्शन के लिए समय दें (यदि आप इस चीज में रुचि रखते हैं, तो गर्व से ईवेंट लूप काम करता है) हुड के तहत, मैं इस लेख की श्रृंखला को पढ़ने की सलाह देता हूं)। यदि आप इस बारे में सोचते हैं कि NodeJS कैसे समझता है कि किस कॉलबैक को कब कॉल करना है, तो आप मान सकते हैं कि उनमें से प्रत्येक को कुछ आईडी के अनुरूप होना चाहिए। इसके अलावा, NodeJS के पास एक एपीआई भी है जो इन आईडी तक पहुँच प्रदान करता है। हम इसका उपयोग करेंगे।

प्राचीन काल में, जब मैमथ विलुप्त हो गए, लेकिन लोगों को अभी भी केंद्रीय सीवेज के लाभों का पता नहीं था, (NodeJS v0.11.11) हमारे पास addAsyncListener था। इसके आधार पर, फॉरेस्ट नॉरवेल ने निरंतरता-स्थानीय भंडारण या सीएलएस का पहला कार्यान्वयन बनाया। लेकिन हमने इस बारे में बात नहीं की कि यह कैसे काम करता है, क्योंकि इस एपीआई (मैं addAsyncLustener के बारे में बात कर रहा हूं) ने लंबे जीवन का आदेश दिया। उनकी मृत्यु NodeJS v0.12 में पहले ही हो चुकी थी।

NodeJS 8 से पहले, अतुल्यकालिक घटनाओं की कतार का ट्रैक रखने का कोई आधिकारिक तरीका नहीं था। और अंत में, संस्करण 8 में, NodeJS डेवलपर्स ने न्याय बहाल किया और हमें async_hooks API के साथ प्रस्तुत किया। यदि आप async_hooks के बारे में अधिक जानना चाहते हैं, तो मेरा सुझाव है कि आप इस लेख को पढ़ें। Async_hooks के आधार पर, पिछले सीएलएस कार्यान्वयन का पुन: प्रसंस्करण किया गया था। पुस्तकालय को cls-hooked कहा जाता है।

हुड के नीचे सीएलएस

सामान्य शब्दों में, CLS ऑपरेशन स्कीम का प्रतिनिधित्व इस प्रकार किया जा सकता है:

सीएलएस अवलोकन

आइए इसे थोड़ा और विस्तार में लें:

मान लीजिए कि हमारे पास एक विशिष्ट एक्सप्रेस वेब सर्वर है। सबसे पहले, एक नया सीएलएस नाम स्थान बनाएं। एक बार और आवेदन के पूरे जीवनकाल के लिए।
दूसरे, हम मिडलवेयर बनाएंगे, जो प्रत्येक अनुरोध के लिए हमारे स्वयं के सीएलएस संदर्भ का निर्माण करेगा।
जब कोई नया अनुरोध आता है, तो इस मिडलवेयर (फंक्शन # 1) को कहा जाता है।
इस फ़ंक्शन में, एक नया सीएलएस संदर्भ बनाएं (एक विकल्प के रूप में, आप Namespace.run का उपयोग कर सकते हैं)। Namespace.run में हम एक फ़ंक्शन पास करते हैं जिसे हमारे संदर्भ के दायरे में निष्पादित किया जाएगा।
सीएलएस वर्तमान निष्पादन आईडी कुंजी के साथ संदर्भों के साथ मैप में एक ताज़ा बनाया संदर्भ जोड़ता है।
प्रत्येक सीएलएस नाम स्थान के पास एक active संपत्ति है। सीएलएस इस संपत्ति को हमारे संदर्भ के लिए एक संदर्भ प्रदान करता है।
डेटाबेस के संदर्भ में, हम किसी प्रकार की अतुल्यकालिक क्वेरी बनाते हैं, कहते हैं। हम डेटाबेस ड्राइवर को कॉलबैक पास करते हैं, जिसे अनुरोध पूरा होने पर कहा जाएगा।
एसिंक्रोनस इनिट हुक आग । यह async आईडी (नए एसिंक्रोनस ऑपरेशन की आईडी) द्वारा संदर्भों के साथ वर्तमान संदर्भ को मैप में जोड़ता है।
क्योंकि हमारे कार्य का अब कोई अतिरिक्त निर्देश नहीं है, यह निष्पादन को पूरा करता है।
हुक के बाद एक अतुल्यकालिक उसके लिए काम करता है। यह नामांकित व्यक्ति को active संपत्ति को undefined (वास्तव में, हमेशा नहीं, क्योंकि हमारे पास कई नेस्टेड संदर्भ हो सकते हैं, लेकिन सबसे सरल मामले के लिए)।
हमारे पहले एसिंक्रोनस ऑपरेशन के लिए एसिंक्रोनस हुक को नष्ट कर देता है । यह इस ऑपरेशन के एसिंक्स आईडी द्वारा संदर्भ के साथ मानचित्र से संदर्भ को हटाता है (यह पहले कॉलबैक की वर्तमान निष्पादन आईडी के समान है)।
डेटाबेस में क्वेरी पूरी हो गई है और दूसरा कॉलबैक कहा जाता है।
पहले अतुल्यकालिक हुक। इसकी वर्तमान निष्पादन आईडी दूसरे ऑपरेशन (डेटाबेस क्वेरी) के async आईडी के समान है। नामस्थान active संपत्ति को वर्तमान निष्पादन आईडी द्वारा संदर्भों के साथ मानचित्र में पाया गया संदर्भ सौंपा गया है। यह वह संदर्भ है जो हमने पहले बनाया था।
अब दूसरा कॉलबैक निष्पादित किया गया है। किसी तरह का व्यावसायिक तर्क काम कर रहा है, शैतान नाच रहे हैं, वोदका डाल रहे हैं। इसके अंदर, हम कुंजी से संदर्भ से कोई भी मूल्य प्राप्त कर सकते हैं। सीएलएस वर्तमान संदर्भ में दी गई कुंजी को खोजने या undefined वापस करने का प्रयास करेगा।
इस कॉलबैक के लिए हुक के बाद एसिंक्रोनस को पूरा होने पर ट्रिगर किया जाता है। यह नाम स्थान की active संपत्ति को undefined ।
इस ऑपरेशन के लिए एसिंक्रोनस हुक आग को नष्ट कर देता है । यह इस ऑपरेशन के एसिंक्स आईडी द्वारा संदर्भों के साथ मानचित्र से संदर्भ को हटा देता है (यह दूसरी कॉलबैक की वर्तमान निष्पादन आईडी के समान है)।
कचरा संग्रहकर्ता (GC) संदर्भ ऑब्जेक्ट से जुड़ी मेमोरी को मुक्त करता है, क्योंकि हमारे आवेदन में इसके लिए अधिक लिंक नहीं हैं।

यह एक सरल दृष्टिकोण है कि हुड के तहत क्या हो रहा है, लेकिन यह मुख्य चरणों और चरणों को कवर करता है। यदि आपको थोड़ी गहरी खुदाई करने की इच्छा है, तो मेरा सुझाव है कि आप अपने आप को प्रकारों से परिचित कराएं । कोड की केवल 500 लाइनें हैं।

ट्रेस आईडी बनाएं

इसलिए, CLS से निपटने के बाद, हम मानवता के लाभ के लिए इस चीज़ का उपयोग करने का प्रयास करेंगे। चलो मिडलवेयर बनाते हैं, जो प्रत्येक अनुरोध के लिए अपना सीएलएस संदर्भ बनाता है, एक यादृच्छिक ट्रेस आईडी बनाता है और इसे कुंजी traceID का उपयोग करके संदर्भ में जोड़ता है। फिर हमारे नियंत्रकों और सेवाओं के बीच के अंतर के भीतर हमें यह ट्रेस आईडी मिलती है।

एक्सप्रेस के लिए, एक समान मिडलवेयर इस तरह दिख सकता है:

 const cls = require('cls-hooked') const uuidv4 = require('uuid/v4') const clsNamespace = cls.createNamespace('app') const clsMiddleware = (req, res, next) => { // req  res -  event emitters.      CLS     clsNamespace.bind(req) clsNamespace.bind(res) const traceID = uuidv4() clsNamespace.run(() => { clsNamespace.set('traceID', traceID) next() }) }

और हमारे कंट्रोलर या सर्विस में, हम इस ट्रेसआईडी को केवल एक लाइन कोड में प्राप्त कर सकते हैं:

 const controller = (req, res, next) => { const traceID = clsNamespace.get('traceID') }

सच है, लॉग में इस ट्रेस आईडी को जोड़े बिना, यह उससे लाभ उठाता है, जैसे गर्मियों में एक बर्फ बनाने वाला से।

आइए एक सरल विंस्टन फॉर्मेटर लिखें जो ट्रेस आईडी को स्वचालित रूप से जोड़ देगा।

 const { createLogger, format, transports } = require('winston') const addTraceId = printf((info) => { let message = info.message const traceID = clsNamespace.get('taceID') if (traceID) { message = `[TraceID: ${traceID}]: ${message}` } return message }) const logger = createLogger({ format: addTraceId, transports: [new transports.Console()], })

और अगर सभी लकड़हारे फ़ंक्शंस के रूप में कस्टम फ़ॉर्मेटर का समर्थन करते हैं (उनमें से कई के पास ऐसा नहीं करने के कारण हैं), तो यह लेख शायद नहीं होगा। तो आप एडिनो के लॉग में एक ट्रेस आईडी कैसे जोड़ सकते हैं?

दोस्तों को कोई भी लकड़हारा और सीएलएस बनाने के लिए हम प्रॉक्सी पर कॉल करते हैं

खुद प्रॉक्सी के बारे में कुछ शब्द: यह ऐसी चीज है जो हमारी मूल वस्तु को लपेटती है और हमें कुछ स्थितियों में इसके व्यवहार को फिर से परिभाषित करने की अनुमति देती है। स्थितियों की कड़ाई से परिभाषित सीमित सूची में (विज्ञान में उन्हें traps कहा जाता traps )। आप पूरी सूची यहां पा सकते हैं, हम केवल ट्रैप गेट में रुचि रखते हैं । यह हमें ऑब्जेक्ट की संपत्ति तक पहुंचने पर वापसी मूल्य को ओवरराइड करने का अवसर देता है, अर्थात। अगर हम ऑब्जेक्ट const a = { prop: 1 } और इसे प्रॉक्सी में लपेटते हैं, तो ट्रैप की मदद से हम वह सब कुछ वापस कर सकते हैं जो हम चाहते हैं जब हम a.prop कहते हैं।

pino के मामले में pino विचार यह है: हम प्रत्येक अनुरोध के लिए एक यादृच्छिक ट्रेस आईडी बनाते हैं, एक पिनो बच्चे का उदाहरण बनाते हैं जिसमें हम इस ट्रेस आईडी को पास करते हैं, और इस बच्चे का उदाहरण सीएलएस में डालते हैं। फिर हम अपने स्रोत लकड़हारा को प्रॉक्सी में लपेटते हैं, जो लॉगिंग के लिए इसी बच्चे के उदाहरण का उपयोग करेगा, यदि कोई सक्रिय संदर्भ है और इसमें कोई बच्चा लकड़हारा है, या मूल लकड़हारा का उपयोग करता है।

ऐसे मामले के लिए, प्रॉक्सी इस तरह दिखेगा:

 const pino = require('pino') const logger = pino() const loggerCls = new Proxy(logger, { get(target, property, receiver) { //    CLS  ,   target = clsNamespace.get('loggerCls') || target return Reflect.get(target, property, receiver) }, })

हमारा मिडलवेयर इस तरह दिखेगा:

 const cls = require('cls-hooked') const uuidv4 = require('uuid/v4') const clsMiddleware = (req, res, next) => { // req  res -  event emitters.      CLS     clsNamespace.bind(req) clsNamespace.bind(res) const traceID = uuidv4() const loggerWithTraceId = logger.child({ traceID }) clsNamespace.run(() => { clsNamespace.set('loggerCls', loggerWithTraceId) next() }) }

और हम इस तरह लकड़हारे का उपयोग कर सकते हैं:

 const controller = (req, res, next) => { loggerCls.info('Long live rocknroll!') //  // {"level":30,"time":1551385666046,"msg":"Long live rocknroll!","pid":25,"hostname":"eb6a6c70f5c4","traceID":"9ba393f0-ec8c-4396-8092-b7e4b6f375b5","v":1} }

सीएलएस-Proxify

उपरोक्त विचार के आधार पर, एक छोटा सा cls-proxify पुस्तकालय बनाया गया था। वह एक्सप्रेस के साथ बॉक्स से बाहर काम करती है, कोआ और तेज करती है । जाल के लिए बनाने के अलावा, यह डेवलपर को और अधिक स्वतंत्रता देने के लिए अन्य जाल बनाता है। इस वजह से, हम प्रॉक्सी का उपयोग फ़ंक्शंस, क्लासेस और बहुत कुछ लपेटने के लिए कर सकते हैं। पिनो को कैसे एकीकृत किया जाए और इसे कैसे तेज किया जाए, पिनो और एक्सप्रेस को लाइव डेमो दिया गया है ।

मुझे आशा है कि आपने समय बर्बाद नहीं किया, और लेख आपके लिए कम से कम उपयोगी था। कृपया लात मारें और आलोचना करें। हम एक साथ बेहतर कोड करना सीखेंगे।

NodeJS में कैसे लॉग इन करें ताकि लड़कों को यार्ड में सम्मान मिले

प्रत्येक अनुरोध के लिए ट्रेस आईडी बनाने के साथ NodeJS में कोई समस्या क्यों है?

हुड के नीचे सीएलएस

ट्रेस आईडी बनाएं

दोस्तों को कोई भी लकड़हारा और सीएलएस बनाने के लिए हम प्रॉक्सी पर कॉल करते हैं

सीएलएस-Proxify

More articles: