जावा लॉगिंग फ्रेमवर्क: Difference between revisions
No edit summary |
No edit summary |
||
(14 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
जावा लॉगिंग फ्रेमवर्क [[ जावा मंच |जावा प्लेटफॉर्म]] | जावा लॉगिंग फ्रेमवर्क [[ जावा मंच |जावा प्लेटफॉर्म]] के लिए [[कंप्यूटर डेटा लॉगिंग]] पैकेज है। यह लेख सामान्य उद्देश्य लॉगिंग फ्रेमवर्क को कवर करता है। | ||
लॉगिंग | लॉगिंग एप्लिकेशन द्वारा गतिविधि की रिकॉर्डिंग को संदर्भित करता है और विकास टीमों के लिए सामान्य समस्या है। लॉगिंग फ्रेमवर्क जावा प्लेटफॉर्म के लिए लॉगिंग की प्रक्रिया को सरल और मानकीकृत करता है। विशेष रूप से वे कंसोल को स्पष्ट आउटपुट से बचकर लचीलापन प्रदान करते हैं (नीचे परिशिष्ट देखें)। जहाँ लॉग लिखे जाते हैं वे कोड से स्वतंत्र हो जाते हैं और कार्यावधि पर अनुकूलित किए जा सकते हैं। | ||
दुर्भाग्य से [[ जावा विकास किट |जावा विकास किट]] में इसके मूल प्रकाशन में लॉगिंग सम्मलित नहीं थी इसलिए जब तक जावा लॉगिंग एपीआई को जोड़ा गया तब तक कई अन्य लॉगिंग फ्रेमवर्क व्यापक रूप से उपयोग किए जा चुके थे - विशेष रूप से [http://commons.apache.org/loging | दुर्भाग्य से [[ जावा विकास किट |जावा विकास किट]] में इसके मूल प्रकाशन में लॉगिंग सम्मलित नहीं थी इसलिए जब तक जावा लॉगिंग एपीआई को जोड़ा गया तब तक कई अन्य लॉगिंग फ्रेमवर्क व्यापक रूप से उपयोग किए जा चुके थे - विशेष रूप से [http://commons.apache.org/loging अपाचे कॉमन्स लॉगिंग] (जावा कॉमन्स लॉगिंग या जेसीएल के रूप में भी जाना जाता है) और [[Log4j]]. इसके कारण अलग-अलग लॉगिंग फ्रेमवर्क का उपयोग करते हुए प्रत्येक अलग-अलग तृतीय-पक्ष पुस्तकालयों (JARs) को एकीकृत करते समय समस्याएँ हुईं। इस समस्या को हल करने के लिए प्लग करने योग्य लॉगिंग फ्रेमवर्क (रैपर) विकसित किए गए थे। | ||
== कार्यक्षमता अवलोकन == | == कार्यक्षमता अवलोकन == | ||
लॉगिंग को सामान्यतः | लॉगिंग को सामान्यतः तीन प्रमुख टुकड़ों में विभाजित किया जाता है: लॉगर, फॉर्मेटर और परिशिष्ट (या हैंडलर)। | ||
* लोगर कुछ मेटाडेटा के साथ लॉग किए जाने वाले संदेश को अधिकृत करने और इसे लॉगिंग फ्रेमवर्क में पास करने के लिए ज़िम्मेदार है। | * लोगर कुछ मेटाडेटा के साथ लॉग किए जाने वाले संदेश को अधिकृत करने और इसे लॉगिंग फ्रेमवर्क में पास करने के लिए ज़िम्मेदार है। | ||
Line 12: | Line 12: | ||
* ढांचा तब स्वरूपित संदेश को उपयुक्त परिशिष्ट संचालक को स्वभाव के लिए सौंप देता है। इसमें कंसोल डिस्प्ले में आउटपुट, डिस्क पर लिखना, डेटाबेस में जोड़ना, या ईमेल बनाना सम्मलित हो सकता है। | * ढांचा तब स्वरूपित संदेश को उपयुक्त परिशिष्ट संचालक को स्वभाव के लिए सौंप देता है। इसमें कंसोल डिस्प्ले में आउटपुट, डिस्क पर लिखना, डेटाबेस में जोड़ना, या ईमेल बनाना सम्मलित हो सकता है। | ||
[http://www.theobjectguy.com/javalog|Java | [http://www.theobjectguy.com/javalog|Java लॉगिंग रूपरेखा by the Object Guy] जैसे सरल लॉगिंग फ्रेमवर्क, लॉगर और परिशिष्ट को जोड़ते हैं। यह डिफ़ॉल्ट संचालन को सरल करता है, किन्तु यह कम विन्यास योग्य है, विशेषकर यदि परियोजना को वातावरण में ले जाया जाता है। | ||
=== लोगर === | === लोगर === | ||
लोगर | लोगर वस्तु है जो एप्लिकेशन को आउटपुट भेजने / संग्रहीत करने के संबंध में बिना लॉग इन करने की अनुमति देता है। एप्लिकेशन किसी दिए गए नाम/पहचानकर्ता के अनुसार लॉगर वस्तु को वैकल्पिक गंभीरता स्तर के साथ वस्तु या वस्तु और अपवाद हैंडलिंग पास करके संदेश लॉग करता है। | ||
==== नाम ==== | ==== नाम ==== | ||
लोगर का | लोगर का नाम होता है। नाम सामान्यतः स्तरों को अलग करने वाली अवधि (.) के साथ पदानुक्रमित रूप से संरचित होता है। लॉगिंग करने वाले वर्ग या पैकेज के नाम का उपयोग करने के लिए सामान्य योजना है। Log4j और Java लॉगिंग [[API]] दोनों ही पदानुक्रम को उच्चतर परिभाषित करने वाले संचालकों का समर्थन करते हैं। | ||
उदाहरण के लिए, लोगर का नाम हो सकता है<code>com.sun.some.UsefulClass</code>. निम्नलिखित में से किसी के लिए संचालक को परिभाषित किया जा सकता है: | उदाहरण के लिए, लोगर का नाम हो सकता है<code>com.sun.some.UsefulClass</code>. निम्नलिखित में से किसी के लिए संचालक को परिभाषित किया जा सकता है: | ||
Line 25: | Line 25: | ||
* <code>com.sun.some</code> | * <code>com.sun.some</code> | ||
* <code>com.sun.some.UsefulClass</code> | * <code>com.sun.some.UsefulClass</code> | ||
जब तक इस स्टैक में कहीं | जब तक इस स्टैक में कहीं संचालक परिभाषित है, तब तक लॉगिंग हो सकती है। उदाहरण के लिए लॉग इन किया गया संदेश <code>com.sun.some.UsefulClass</code> लोगर , <code>com.sun</code> संचालक द्वारा लिखा जा सकता है। सामान्यतः वैश्विक संचालक होता है जो किसी लोगर द्वारा उत्पन्न संदेशों को प्राप्त करता है और संसाधित करता है। | ||
==== गंभीरता स्तर ==== | ==== गंभीरता स्तर ==== | ||
संदेश | संदेश निश्चित स्तर पर लॉग किया गया है। सामान्य स्तर के नाम [http://commons.apache.org/log/guide.html#Message%20Priorities/Levels अपाचे कॉमन्स लॉगिंग] से कॉपी किए गए हैं (चूंकि जावा लॉगिंग एपीआई विभिन्न स्तर के नामों को परिभाषित करता है)। | ||
{| class="wikitable" | {| class="wikitable" | ||
Line 36: | Line 36: | ||
|- | |- | ||
|'''घातक''' | |'''घातक''' | ||
| | |गंभीर त्रुटियाँ जो समय से पहले समाप्ति का कारण बनती हैं। अपेक्षा करें कि ये स्टेटस कंसोल पर तत्काल दिखाई दें। | ||
|- | |- | ||
|'''त्रुटि''' | |'''त्रुटि''' | ||
| | |अन्य रनटाइम त्रुटियाँ या अनपेक्षित स्थितियाँ। अपेक्षा करें कि ये स्टेटस कंसोल पर तत्काल दिखाई दें। | ||
|- | |- | ||
|''' | |'''चेतावनी''' | ||
| | |पदावनत API का उपयोग, API का खराब उपयोग, 'लगभग' त्रुटियाँ, अन्य रनटाइम स्थितियाँ जो अवांछनीय या अप्रत्याशित हैं, किन्तु आवश्यक रूप से "गलत" नहीं हैं। अपेक्षा करें कि ये स्टेटस कंसोल पर तत्काल दिखाई दें। | ||
|- | |- | ||
|''' | |'''जानकारी''' | ||
| | |रोचक रनटाइम परिणाम (स्टार्टअप/शटडाउन)। अपेक्षा करें कि ये तत्काल एक कंसोल पर दिखाई देंगे, इसलिए रूढ़िवादी रहें और न्यूनतम रखें। | ||
|- | |- | ||
|''' | |'''डीबग''' | ||
| | |प्रणाली के माध्यम से प्रवाह पर विस्तृत जानकारी। उम्मीद है कि इन्हें केवल लॉग में लिखा जाएगा। | ||
|- | |- | ||
|''' | |'''चिह्न''' | ||
| | |अधिक विस्तृत जानकारी। उम्मीद है कि इन्हें केवल लॉग में लिखा जाएगा। | ||
|} | |} | ||
लॉगिंग फ्रेमवर्क प्रत्येक लोगर के लिए वर्तमान लॉगिंग स्तर को बनाए रखता है। लॉगिंग स्तर को कम या ज्यादा प्रतिबंधात्मक | लॉगिंग फ्रेमवर्क प्रत्येक लोगर के लिए वर्तमान लॉगिंग स्तर को बनाए रखता है। लॉगिंग स्तर को कम या ज्यादा प्रतिबंधात्मक समूह किया जा सकता है। उदाहरण के लिए, यदि लॉगिंग स्तर चेतावनी पर समूह है, तो उस स्तर या उच्चतर के सभी संदेशों को लॉग किया जाता है, त्रुटि और घातक। | ||
लोगर और परिशिष्ट दोनों को गंभीरता का स्तर सौंपा जा सकता है। आउटपुट उत्पन्न करने के लिए दिए गए गंभीरता स्तर के लिए दोनों को सक्षम किया जाना चाहिए। तो डीबग आउटपुट के लिए सक्षम लॉगर आउटपुट उत्पन्न नहीं करेगा यदि संदेश प्राप्त करने वाला संचालक डीबग के लिए भी सक्षम नहीं है। | लोगर और परिशिष्ट दोनों को गंभीरता का स्तर सौंपा जा सकता है। आउटपुट उत्पन्न करने के लिए दिए गए गंभीरता स्तर के लिए दोनों को सक्षम किया जाना चाहिए। तो डीबग आउटपुट के लिए सक्षम लॉगर आउटपुट उत्पन्न नहीं करेगा यदि संदेश प्राप्त करने वाला संचालक डीबग के लिए भी सक्षम नहीं है। | ||
Line 59: | Line 59: | ||
=== फ़िल्टर === | === फ़िल्टर === | ||
फ़िल्टर लॉग | फ़िल्टर लॉग परिणाम को अनदेखा या लॉग करने का कारण बनता है। सबसे अधिक उपयोग किया जाने वाला फ़िल्टर पिछले अनुभाग में प्रलेखित लॉगिंग स्तर है। लॉगिंग फ्रेमवर्क जैसे कि Log4j 2 और SLF4J भी मार्कर प्रदान करते हैं, जो लॉग ईवेंट से जुड़े होने पर फ़िल्टरिंग के लिए भी उपयोग किए जा सकते हैं। फेंके जा रहे अपवादों, लॉग संदेश के भीतर डेटा, थ्रेडलोकल में डेटा जो लॉगिंग एपीआई के माध्यम से उजागर किया गया है, या कई अन्य विधियों के आधार पर लॉग परिणाम को स्वीकार या अस्वीकार करने के लिए फ़िल्टर का उपयोग किया जा सकता है। | ||
=== फ़ॉर्मेटर्स, | === फ़ॉर्मेटर्स, लेआउट या रेंडरर्स === | ||
फ़ॉर्मेटर | फ़ॉर्मेटर वस्तु है जो किसी दिए गए वस्तु को स्वरूपित करता है। अधिकतर इसमें द्विआधारी वस्तु लेना और इसे स्ट्रिंग प्रस्तुति में परिवर्तित करना सम्मलित है। प्रत्येक ढांचा डिफ़ॉल्ट आउटपुट स्वरूप को परिभाषित करता है जिसे वांछित होने पर ओवरराइड किया जा सकता है। | ||
=== परिशिष्ट या हैंडलर === | === परिशिष्ट या हैंडलर === | ||
परिशिष्ट निर्दिष्ट न्यूनतम गंभीरता स्तर पर या उससे ऊपर के संदेशों को सुनते हैं। परिशिष्ट पारित संदेश लेता है और इसे उचित रूप से पोस्ट करता है। संदेश स्वभाव में सम्मलित हैं: | परिशिष्ट निर्दिष्ट न्यूनतम गंभीरता स्तर पर या उससे ऊपर के संदेशों को सुनते हैं। परिशिष्ट पारित संदेश लेता है और इसे उचित रूप से पोस्ट करता है। संदेश स्वभाव में सम्मलित हैं: | ||
* कंसोल पर प्रदर्शित करें | * कंसोल पर प्रदर्शित करें | ||
* फ़ाइल या | * फ़ाइल या सिसलॉग में लिखें | ||
* डेटाबेस तालिका में संलग्न करें | * डेटाबेस तालिका में संलग्न करें | ||
* [[जावा संदेश सेवा]] के माध्यम से वितरित करें | * [[जावा संदेश सेवा]] के माध्यम से वितरित करें | ||
Line 76: | Line 76: | ||
=== फीचर तुलना === | === फीचर तुलना === | ||
{| class="wikitable" style="vertical-align: top;" | {| class="wikitable" style="vertical-align: top;" | ||
|+ ''' | |+ '''तालिका 1 - फीचर''' | ||
! | ! रूपरेखा | ||
! | ! प्रकार | ||
! | ! समर्थित लॉग स्तर | ||
! | ! मानक परिशिष्ट | ||
! | ! टिप्पणियाँ | ||
! | ! लागत / लाइसेंस | ||
|- | |- | ||
! Log4j | ! Log4j | ||
| | | लॉगिंग रूपरेखा | ||
| <code> | | <code>FATAL ERROR WARN INFO DEBUG TRACE</code> | ||
| | | सूची में बहुत अधिक हैं: [http://logging.apache.org/log4j/2.x/manual/appenders.html परिशिष्ट दस्तावेज़ीकरण देखें] | ||
| | | कई परियोजनाओं और प्लेटफार्मों में व्यापक रूप से उपयोग किया जाता है। Log4j 1 को 2015 में "जीवन का अंत" घोषित किया गया था और इसे Log4j 2 से बदल दिया गया है जो एक एपीआई प्रदान करता है जिसका उपयोग अन्य लॉगिंग कार्यान्वयन के साथ-साथ उस एपीआई के कार्यान्वयन के साथ किया जा सकता है। | ||
| <div style="width: 8em;"> | | <div style="width: 8em;">अपाचे लाइसेंस, संस्करण 2.0 </div> | ||
|- | |- | ||
! [http://java.sun.com/javase/6/docs/technotes/guides/logging/ | ! [http://java.sun.com/javase/6/docs/technotes/guides/logging/ जावा लॉगिंग एपीआई] | ||
| | | लॉगिंग रूपरेखा | ||
| <code>SEVERE WARNING INFO CONFIG FINE FINER FINEST</code> | | <code>SEVERE WARNING INFO CONFIG FINE FINER FINEST</code> | ||
| | | सूर्य की डिफ़ॉल्ट जावा वर्चुअल मशीन (JVM) में निम्नलिखित हैं: कंसोलहैंडलर, फाइलहैंडलर, सॉकेटहैंडलर, मेमोरीहैंडलर | ||
| | | | ||
| | | जेआरई के साथ आता है | ||
|- | |- | ||
! [http://www.tinylog.org/ | ! [http://www.tinylog.org/ छोटा लॉग] | ||
| | | लॉगिंग रूपरेखा | ||
| <code> | | <code>ERROR WARNING INFO DEBUG TRACE</code> | ||
| | | कंसोलवाइटर, फाइलवाइटर, लॉगकैटवाइटर, जेडीबीसीवाइटर, रोलिंगफाइलवाइटर, शेयर्डफाइलवाइटर और नल (सभी लॉग प्रविष्टियों को छोड़ देता है) <ref>{{cite web|title=User manual of tinylog|url=http://www.tinylog.org/user-manual}}{{Dead link|date=March 2023 |bot=InternetArchiveBot |fix-attempted=yes }}</ref> | ||
| | | | ||
| | | अपाचे लाइसेंस, संस्करण 2.0 | ||
|- | |- | ||
! [http://logback.qos.ch/ | ! [http://logback.qos.ch/ लॉगबैक] | ||
| | | लॉगिंग रूपरेखा | ||
| <code> | | <code>ERROR WARN INFO DEBUG TRACE</code> | ||
| | | सूची में बहुत अधिक हैं: [http://logback.qos.ch/apidocs/ch/qos/logback/core/Appender.html परिशिष्ट JavaDoc देखें] | ||
| | | कई सुधारों के साथ, Log4j के प्रतिस्थापन के रूप में विकसित किया गया। सामान्यतः slf4j के पीछे कई परियोजनाओं द्वारा उपयोग किया जाता है उदाहरण के लिए, [[Akka (toolkit)|अक्का]], [[Apache Camel|अपाचे ऊंट]], [[Apache Cocoon|अपाचे कोकून]], [[Artifactory|कलात्मकता]], [[Gradle|ग्रेडल]], [[Lift (web framework)|लिफ्ट फ्रेमवर्क]], [[Play Framework|प्ले फ्रेमवर्क]], [[Scalatra|स्कैलट्रा]], [[SonarQube|सोनारक्यूब]], [[Spring_Framework#Spring_Boot|स्प्रिंग बूट]], ... | ||
| [[LGPL]], | | [[LGPL|एलजीपीएल]], संस्करण 2.1 | ||
|- | |- | ||
! [[Apache Commons Logging]] | ! [[Apache Commons Logging|अपाचे कॉमन्स लॉगिंग (जेसीएल)]] | ||
| | | लॉगिंग रैपर | ||
| <code> | | <code>FATAL ERROR WARN INFO DEBUG TRACE</code> | ||
| | | अंतर्निहित ढांचे पर निर्भर करता है | ||
| | | व्यापक रूप से उपयोग किया जाता है, अधिकांशतः Log4j के साथ संयोजन में | ||
| | | अपाचे लाइसेंस, संस्करण 2.0 | ||
|- | |- | ||
! [[SLF4J]] | ! [[SLF4J]] | ||
| | | लॉगिंग रैपर | ||
| <code> | | <code>ERROR WARN INFO DEBUG TRACE</code> | ||
| | | अंतर्निहित ढांचे पर निर्भर करता है, जो प्लग करने योग्य है। JCL, JDK और Log4j लॉगिंग पैकेज के लिए API संगत शिम प्रदान करता है। यह आउटपुट उत्पन्न करने के लिए उनमें से किसी का भी उपयोग कर सकता है।उपलब्ध होने पर आउटपुट के लिए लॉगबैक का उपयोग करने के लिए डिफ़ॉल्ट। | ||
| | | कार्यान्वयन के रूप में अधिकांशतः लॉगबैक के साथ कई परियोजनाओं और प्लेटफार्मों में व्यापक रूप से उपयोग किया जाता है। | ||
| [[MIT License]] | | [[MIT License|एमआईटी लाइसेंस]] | ||
|} | |} | ||
== विचार == | == विचार == | ||
JCL और Log4j बहुत | JCL और Log4j बहुत साधारण हैं क्योंकि वे इतने लंबे समय से आसपास हैं और लंबे समय तक एकमात्र विकल्प थे। slf4j के लचीलेपन (नीचे लॉगबैक का उपयोग करके) ने इसे लोकप्रिय विकल्प बना दिया है। | ||
SLF4J लॉगिंग रैपर (या शिम्स) का समूह है जो इसे किसी भी अन्य ढांचे की नकल करने की अनुमति देता है। इस प्रकार एकाधिक तृतीय-पक्ष पुस्तकालयों को अनुप्रयोग में सम्मलित किया जा सकता है, यदि प्रत्येक लॉगिंग ढांचे का उपयोग करने के लिए चुना गया हो। चूँकि सभी लॉगिंग आउटपुट मानक विधियों से उत्पन्न होते हैं, सामान्यतः लॉगबैक के माध्यम से। | |||
Log4j 2 एपीआई और कार्यान्वयन दोनों प्रदान करता है। एपीआई को अन्य लॉगिंग कार्यान्वयनों के लिए रूट किया जा सकता है जो SLF4J कैसे काम करता है। SLF4J के विपरीत, Log4j 2 API संदेश लॉग करता है<ref>[http://logging.apache.org/log4j/2.x/manual/messages.html Log4j2 API Messages]</ref> अतिरिक्त लचीलेपन के लिए स्ट्रिंग्स के अतिरिक्त वस्तुओं और जावा लैम्ब्डा अभिव्यक्ति का भी समर्थन करता है।<ref>[http://logging.apache.org/log4j/2.x/manual/api.html#LambdaSupport Java 8 Lambda support for lazy logging]</ref> जेसीएल वास्तव में लॉगिंग ढांचा नहीं है, किन्तु के लिए आवरण है। इस प्रकार, इसके नीचे लॉगिंग ढांचे की आवश्यकता होती है, चूंकि यह स्वयं का उपयोग करने के लिए डिफ़ॉल्ट हो सकता है <code>SimpleLog</code> लोगर । | |||
JCL, SLF4J और Log4j 2 API पुन: प्रयोज्य पुस्तकालयों को विकसित करते समय उपयोगी होते हैं जिन्हें एप्लिकेशन द्वारा उपयोग किए जा रहे अंतर्निहित लॉगिंग प्रणाली को लिखने की आवश्यकता होती है। यह विषम वातावरणों में लचीलापन भी प्रदान करता है जहां लॉगिंग ढांचे को बदलने की संभावना है, चूंकि ज्यादातर स्थितियों में, लॉगिंग ढांचे को चुनने के बाद, परियोजना के जीवन में इसे बदलने की बहुत कम आवश्यकता होती है। SLF4J और Log4j 2 नए होने से लाभान्वित होते हैं और पुराने ढांचे से सीखे गए पाठों का निर्माण करते हैं। इसके अतिरिक्त जेसीएल को वर्ग लोडर के साथ समस्याएं ज्ञात हैं, यह निर्धारित करते समय कि किस लॉगिंग लाइब्रेरी को लपेटना चाहिए <ref>[https://docs.spring.io/spring/docs/4.3.x/spring-framework-reference/html/overview.html#overview-avoiding-commons-logging Avoiding Commons Logging]</ref> जो अब जेसीएल की जगह ले चुका है।<ref>[https://docs.spring.io/spring/docs/5.0.0.RC3/spring-framework-reference/overview.html#overview-logging Spring Logging Overview]</ref>जावा लॉगिंग एपीआई जावा के साथ प्रदान किया गया है। यद्यपि एपीआई तकनीकी रूप से जावा के साथ प्रदान किए गए डिफ़ॉल्ट कार्यान्वयन से अलग है, इसे वैकल्पिक कार्यान्वयन के साथ बदलना चुनौतीपूर्ण हो सकता है, इसलिए कई डेवलपर्स इस कार्यान्वयन को जावा लॉगिंग एपीआई के साथ भ्रमित करते हैं। विन्यास केवल बाहरी फ़ाइलों द्वारा होता है जो फ्लाई पर सरलता से नहीं बदला जाता है (अन्य ढांचे कार्यक्रम संबंधी विन्यास का समर्थन करते हैं)। डिफ़ॉल्ट कार्यान्वयन केवल कुछ संचालक और फॉर्मेटर्स प्रदान करता है, जिसका अर्थ है कि अधिकांश उपयोगकर्ताओं को अपना स्वयं का लिखना होगा।<ref>[https://docs.oracle.com/javase/8/docs/api/java/util/logging/package-summary.html java.util.logging Overview]</ref> | |||
== यह भी देखें == | == यह भी देखें == | ||
*[[SLF4J]] | *[[SLF4J]] | ||
* | *[[log4j]] | ||
* [[लॉगबैक]] | * [[लॉगबैक]] | ||
*[[ जावोल्यूशन | जावोल्यूशन]] लॉग कॉन्टेक्स्ट [http://javolution.org/apidocs/javolution/context/package-summary.html#package_description संदर्भ प्रोग्रामिंग] पर आधारित है (रन-टाइम पर चयन योग्य वास्तविक लॉगिंग फ्रेमवर्क)। | *[[ जावोल्यूशन | जावोल्यूशन]] लॉग कॉन्टेक्स्ट [http://javolution.org/apidocs/javolution/context/package-summary.html#package_description संदर्भ प्रोग्रामिंग] पर आधारित है (रन-टाइम पर चयन योग्य वास्तविक लॉगिंग फ्रेमवर्क)। | ||
* [[रनटाइम इंटेलिजेंस|कार्यावधि | * [[रनटाइम इंटेलिजेंस|कार्यावधि बुद्धिमत्ता]] | ||
==संदर्भ== | ==संदर्भ== | ||
{{Reflist}} | {{Reflist}} | ||
==बाहरी संबंध== | ==बाहरी संबंध== | ||
* [http://java.sun.com/javase/6/docs/technotes/guides/logging/ Java 6.0 Logging API] | * [http://java.sun.com/javase/6/docs/technotes/guides/logging/ Java 6.0 Logging API] | ||
Line 157: | Line 150: | ||
* [http://java-source.net/open-source/logging Open Source Logging Tools in Java] | * [http://java-source.net/open-source/logging Open Source Logging Tools in Java] | ||
* [http://apache.org/licenses/LICENSE-2.0 The Apache 2.0 license.] | * [http://apache.org/licenses/LICENSE-2.0 The Apache 2.0 license.] | ||
* [http://logback.qos.ch/ | * [http://logback.qos.ch/ लॉगबैक - A successor to the popular Log4j project] | ||
* [http://www.tinylog.org/ tinylog - Minimalist logging utility with a static logger] | * [http://www.tinylog.org/ tinylog - Minimalist logging utility with a static logger] | ||
* [http://loggifier.unkrig.de Loggifier] A tool that inserts logging code into .class, .jar and .ear files | * [http://loggifier.unkrig.de Loggifier] A tool that inserts logging code into .class, .jar and .ear files | ||
Line 165: | Line 158: | ||
* [http://logging.apache.org/log4j/2.x/ Log4j 2] | * [http://logging.apache.org/log4j/2.x/ Log4j 2] | ||
{{DEFAULTSORT:Java Logging Framework}} | {{DEFAULTSORT:Java Logging Framework}} | ||
[[Category: | [[Category:All articles with dead external links]] | ||
[[Category:Created On 11/05/2023]] | [[Category:Articles with dead external links from March 2023]] | ||
[[Category:Articles with permanently dead external links]] | |||
[[Category:Created On 11/05/2023|Java Logging Framework]] | |||
[[Category:Machine Translated Page|Java Logging Framework]] | |||
[[Category:Pages with script errors|Java Logging Framework]] | |||
[[Category:Templates Vigyan Ready]] | |||
[[Category:कंप्यूटर लॉगिंग|Java Logging Framework]] | |||
[[Category:जावा मंच|Java Logging Framework]] |
Latest revision as of 11:53, 23 May 2023
जावा लॉगिंग फ्रेमवर्क जावा प्लेटफॉर्म के लिए कंप्यूटर डेटा लॉगिंग पैकेज है। यह लेख सामान्य उद्देश्य लॉगिंग फ्रेमवर्क को कवर करता है।
लॉगिंग एप्लिकेशन द्वारा गतिविधि की रिकॉर्डिंग को संदर्भित करता है और विकास टीमों के लिए सामान्य समस्या है। लॉगिंग फ्रेमवर्क जावा प्लेटफॉर्म के लिए लॉगिंग की प्रक्रिया को सरल और मानकीकृत करता है। विशेष रूप से वे कंसोल को स्पष्ट आउटपुट से बचकर लचीलापन प्रदान करते हैं (नीचे परिशिष्ट देखें)। जहाँ लॉग लिखे जाते हैं वे कोड से स्वतंत्र हो जाते हैं और कार्यावधि पर अनुकूलित किए जा सकते हैं।
दुर्भाग्य से जावा विकास किट में इसके मूल प्रकाशन में लॉगिंग सम्मलित नहीं थी इसलिए जब तक जावा लॉगिंग एपीआई को जोड़ा गया तब तक कई अन्य लॉगिंग फ्रेमवर्क व्यापक रूप से उपयोग किए जा चुके थे - विशेष रूप से अपाचे कॉमन्स लॉगिंग (जावा कॉमन्स लॉगिंग या जेसीएल के रूप में भी जाना जाता है) और Log4j. इसके कारण अलग-अलग लॉगिंग फ्रेमवर्क का उपयोग करते हुए प्रत्येक अलग-अलग तृतीय-पक्ष पुस्तकालयों (JARs) को एकीकृत करते समय समस्याएँ हुईं। इस समस्या को हल करने के लिए प्लग करने योग्य लॉगिंग फ्रेमवर्क (रैपर) विकसित किए गए थे।
कार्यक्षमता अवलोकन
लॉगिंग को सामान्यतः तीन प्रमुख टुकड़ों में विभाजित किया जाता है: लॉगर, फॉर्मेटर और परिशिष्ट (या हैंडलर)।
- लोगर कुछ मेटाडेटा के साथ लॉग किए जाने वाले संदेश को अधिकृत करने और इसे लॉगिंग फ्रेमवर्क में पास करने के लिए ज़िम्मेदार है।
- संदेश प्राप्त करने के बाद, फ्रेमवर्क फॉर्मेटर को संदेश के साथ कॉल करता है जो इसे आउटपुट के लिए प्रारूपित करता है।
- ढांचा तब स्वरूपित संदेश को उपयुक्त परिशिष्ट संचालक को स्वभाव के लिए सौंप देता है। इसमें कंसोल डिस्प्ले में आउटपुट, डिस्क पर लिखना, डेटाबेस में जोड़ना, या ईमेल बनाना सम्मलित हो सकता है।
लॉगिंग रूपरेखा by the Object Guy जैसे सरल लॉगिंग फ्रेमवर्क, लॉगर और परिशिष्ट को जोड़ते हैं। यह डिफ़ॉल्ट संचालन को सरल करता है, किन्तु यह कम विन्यास योग्य है, विशेषकर यदि परियोजना को वातावरण में ले जाया जाता है।
लोगर
लोगर वस्तु है जो एप्लिकेशन को आउटपुट भेजने / संग्रहीत करने के संबंध में बिना लॉग इन करने की अनुमति देता है। एप्लिकेशन किसी दिए गए नाम/पहचानकर्ता के अनुसार लॉगर वस्तु को वैकल्पिक गंभीरता स्तर के साथ वस्तु या वस्तु और अपवाद हैंडलिंग पास करके संदेश लॉग करता है।
नाम
लोगर का नाम होता है। नाम सामान्यतः स्तरों को अलग करने वाली अवधि (.) के साथ पदानुक्रमित रूप से संरचित होता है। लॉगिंग करने वाले वर्ग या पैकेज के नाम का उपयोग करने के लिए सामान्य योजना है। Log4j और Java लॉगिंग API दोनों ही पदानुक्रम को उच्चतर परिभाषित करने वाले संचालकों का समर्थन करते हैं।
उदाहरण के लिए, लोगर का नाम हो सकता हैcom.sun.some.UsefulClass
. निम्नलिखित में से किसी के लिए संचालक को परिभाषित किया जा सकता है:
com
com.sun
com.sun.some
com.sun.some.UsefulClass
जब तक इस स्टैक में कहीं संचालक परिभाषित है, तब तक लॉगिंग हो सकती है। उदाहरण के लिए लॉग इन किया गया संदेश com.sun.some.UsefulClass
लोगर , com.sun
संचालक द्वारा लिखा जा सकता है। सामान्यतः वैश्विक संचालक होता है जो किसी लोगर द्वारा उत्पन्न संदेशों को प्राप्त करता है और संसाधित करता है।
गंभीरता स्तर
संदेश निश्चित स्तर पर लॉग किया गया है। सामान्य स्तर के नाम अपाचे कॉमन्स लॉगिंग से कॉपी किए गए हैं (चूंकि जावा लॉगिंग एपीआई विभिन्न स्तर के नामों को परिभाषित करता है)।
स्तर | विवरण |
---|---|
घातक | गंभीर त्रुटियाँ जो समय से पहले समाप्ति का कारण बनती हैं। अपेक्षा करें कि ये स्टेटस कंसोल पर तत्काल दिखाई दें। |
त्रुटि | अन्य रनटाइम त्रुटियाँ या अनपेक्षित स्थितियाँ। अपेक्षा करें कि ये स्टेटस कंसोल पर तत्काल दिखाई दें। |
चेतावनी | पदावनत API का उपयोग, API का खराब उपयोग, 'लगभग' त्रुटियाँ, अन्य रनटाइम स्थितियाँ जो अवांछनीय या अप्रत्याशित हैं, किन्तु आवश्यक रूप से "गलत" नहीं हैं। अपेक्षा करें कि ये स्टेटस कंसोल पर तत्काल दिखाई दें। |
जानकारी | रोचक रनटाइम परिणाम (स्टार्टअप/शटडाउन)। अपेक्षा करें कि ये तत्काल एक कंसोल पर दिखाई देंगे, इसलिए रूढ़िवादी रहें और न्यूनतम रखें। |
डीबग | प्रणाली के माध्यम से प्रवाह पर विस्तृत जानकारी। उम्मीद है कि इन्हें केवल लॉग में लिखा जाएगा। |
चिह्न | अधिक विस्तृत जानकारी। उम्मीद है कि इन्हें केवल लॉग में लिखा जाएगा। |
लॉगिंग फ्रेमवर्क प्रत्येक लोगर के लिए वर्तमान लॉगिंग स्तर को बनाए रखता है। लॉगिंग स्तर को कम या ज्यादा प्रतिबंधात्मक समूह किया जा सकता है। उदाहरण के लिए, यदि लॉगिंग स्तर चेतावनी पर समूह है, तो उस स्तर या उच्चतर के सभी संदेशों को लॉग किया जाता है, त्रुटि और घातक।
लोगर और परिशिष्ट दोनों को गंभीरता का स्तर सौंपा जा सकता है। आउटपुट उत्पन्न करने के लिए दिए गए गंभीरता स्तर के लिए दोनों को सक्षम किया जाना चाहिए। तो डीबग आउटपुट के लिए सक्षम लॉगर आउटपुट उत्पन्न नहीं करेगा यदि संदेश प्राप्त करने वाला संचालक डीबग के लिए भी सक्षम नहीं है।
फ़िल्टर
फ़िल्टर लॉग परिणाम को अनदेखा या लॉग करने का कारण बनता है। सबसे अधिक उपयोग किया जाने वाला फ़िल्टर पिछले अनुभाग में प्रलेखित लॉगिंग स्तर है। लॉगिंग फ्रेमवर्क जैसे कि Log4j 2 और SLF4J भी मार्कर प्रदान करते हैं, जो लॉग ईवेंट से जुड़े होने पर फ़िल्टरिंग के लिए भी उपयोग किए जा सकते हैं। फेंके जा रहे अपवादों, लॉग संदेश के भीतर डेटा, थ्रेडलोकल में डेटा जो लॉगिंग एपीआई के माध्यम से उजागर किया गया है, या कई अन्य विधियों के आधार पर लॉग परिणाम को स्वीकार या अस्वीकार करने के लिए फ़िल्टर का उपयोग किया जा सकता है।
फ़ॉर्मेटर्स, लेआउट या रेंडरर्स
फ़ॉर्मेटर वस्तु है जो किसी दिए गए वस्तु को स्वरूपित करता है। अधिकतर इसमें द्विआधारी वस्तु लेना और इसे स्ट्रिंग प्रस्तुति में परिवर्तित करना सम्मलित है। प्रत्येक ढांचा डिफ़ॉल्ट आउटपुट स्वरूप को परिभाषित करता है जिसे वांछित होने पर ओवरराइड किया जा सकता है।
परिशिष्ट या हैंडलर
परिशिष्ट निर्दिष्ट न्यूनतम गंभीरता स्तर पर या उससे ऊपर के संदेशों को सुनते हैं। परिशिष्ट पारित संदेश लेता है और इसे उचित रूप से पोस्ट करता है। संदेश स्वभाव में सम्मलित हैं:
- कंसोल पर प्रदर्शित करें
- फ़ाइल या सिसलॉग में लिखें
- डेटाबेस तालिका में संलग्न करें
- जावा संदेश सेवा के माध्यम से वितरित करें
- ईमेल द्वारा भेजें
- सॉकेट पर लिखें
- बिट-बकेट (/ dev/null) को छोड़ दें
फीचर तुलना
रूपरेखा | प्रकार | समर्थित लॉग स्तर | मानक परिशिष्ट | टिप्पणियाँ | लागत / लाइसेंस |
---|---|---|---|---|---|
Log4j | लॉगिंग रूपरेखा | FATAL ERROR WARN INFO DEBUG TRACE
|
सूची में बहुत अधिक हैं: परिशिष्ट दस्तावेज़ीकरण देखें | कई परियोजनाओं और प्लेटफार्मों में व्यापक रूप से उपयोग किया जाता है। Log4j 1 को 2015 में "जीवन का अंत" घोषित किया गया था और इसे Log4j 2 से बदल दिया गया है जो एक एपीआई प्रदान करता है जिसका उपयोग अन्य लॉगिंग कार्यान्वयन के साथ-साथ उस एपीआई के कार्यान्वयन के साथ किया जा सकता है। | अपाचे लाइसेंस, संस्करण 2.0
|
जावा लॉगिंग एपीआई | लॉगिंग रूपरेखा | SEVERE WARNING INFO CONFIG FINE FINER FINEST
|
सूर्य की डिफ़ॉल्ट जावा वर्चुअल मशीन (JVM) में निम्नलिखित हैं: कंसोलहैंडलर, फाइलहैंडलर, सॉकेटहैंडलर, मेमोरीहैंडलर | जेआरई के साथ आता है | |
छोटा लॉग | लॉगिंग रूपरेखा | ERROR WARNING INFO DEBUG TRACE
|
कंसोलवाइटर, फाइलवाइटर, लॉगकैटवाइटर, जेडीबीसीवाइटर, रोलिंगफाइलवाइटर, शेयर्डफाइलवाइटर और नल (सभी लॉग प्रविष्टियों को छोड़ देता है) [1] | अपाचे लाइसेंस, संस्करण 2.0 | |
लॉगबैक | लॉगिंग रूपरेखा | ERROR WARN INFO DEBUG TRACE
|
सूची में बहुत अधिक हैं: परिशिष्ट JavaDoc देखें | कई सुधारों के साथ, Log4j के प्रतिस्थापन के रूप में विकसित किया गया। सामान्यतः slf4j के पीछे कई परियोजनाओं द्वारा उपयोग किया जाता है उदाहरण के लिए, अक्का, अपाचे ऊंट, अपाचे कोकून, कलात्मकता, ग्रेडल, लिफ्ट फ्रेमवर्क, प्ले फ्रेमवर्क, स्कैलट्रा, सोनारक्यूब, स्प्रिंग बूट, ... | एलजीपीएल, संस्करण 2.1 |
अपाचे कॉमन्स लॉगिंग (जेसीएल) | लॉगिंग रैपर | FATAL ERROR WARN INFO DEBUG TRACE
|
अंतर्निहित ढांचे पर निर्भर करता है | व्यापक रूप से उपयोग किया जाता है, अधिकांशतः Log4j के साथ संयोजन में | अपाचे लाइसेंस, संस्करण 2.0 |
SLF4J | लॉगिंग रैपर | ERROR WARN INFO DEBUG TRACE
|
अंतर्निहित ढांचे पर निर्भर करता है, जो प्लग करने योग्य है। JCL, JDK और Log4j लॉगिंग पैकेज के लिए API संगत शिम प्रदान करता है। यह आउटपुट उत्पन्न करने के लिए उनमें से किसी का भी उपयोग कर सकता है।उपलब्ध होने पर आउटपुट के लिए लॉगबैक का उपयोग करने के लिए डिफ़ॉल्ट। | कार्यान्वयन के रूप में अधिकांशतः लॉगबैक के साथ कई परियोजनाओं और प्लेटफार्मों में व्यापक रूप से उपयोग किया जाता है। | एमआईटी लाइसेंस |
विचार
JCL और Log4j बहुत साधारण हैं क्योंकि वे इतने लंबे समय से आसपास हैं और लंबे समय तक एकमात्र विकल्प थे। slf4j के लचीलेपन (नीचे लॉगबैक का उपयोग करके) ने इसे लोकप्रिय विकल्प बना दिया है।
SLF4J लॉगिंग रैपर (या शिम्स) का समूह है जो इसे किसी भी अन्य ढांचे की नकल करने की अनुमति देता है। इस प्रकार एकाधिक तृतीय-पक्ष पुस्तकालयों को अनुप्रयोग में सम्मलित किया जा सकता है, यदि प्रत्येक लॉगिंग ढांचे का उपयोग करने के लिए चुना गया हो। चूँकि सभी लॉगिंग आउटपुट मानक विधियों से उत्पन्न होते हैं, सामान्यतः लॉगबैक के माध्यम से।
Log4j 2 एपीआई और कार्यान्वयन दोनों प्रदान करता है। एपीआई को अन्य लॉगिंग कार्यान्वयनों के लिए रूट किया जा सकता है जो SLF4J कैसे काम करता है। SLF4J के विपरीत, Log4j 2 API संदेश लॉग करता है[2] अतिरिक्त लचीलेपन के लिए स्ट्रिंग्स के अतिरिक्त वस्तुओं और जावा लैम्ब्डा अभिव्यक्ति का भी समर्थन करता है।[3] जेसीएल वास्तव में लॉगिंग ढांचा नहीं है, किन्तु के लिए आवरण है। इस प्रकार, इसके नीचे लॉगिंग ढांचे की आवश्यकता होती है, चूंकि यह स्वयं का उपयोग करने के लिए डिफ़ॉल्ट हो सकता है SimpleLog
लोगर ।
JCL, SLF4J और Log4j 2 API पुन: प्रयोज्य पुस्तकालयों को विकसित करते समय उपयोगी होते हैं जिन्हें एप्लिकेशन द्वारा उपयोग किए जा रहे अंतर्निहित लॉगिंग प्रणाली को लिखने की आवश्यकता होती है। यह विषम वातावरणों में लचीलापन भी प्रदान करता है जहां लॉगिंग ढांचे को बदलने की संभावना है, चूंकि ज्यादातर स्थितियों में, लॉगिंग ढांचे को चुनने के बाद, परियोजना के जीवन में इसे बदलने की बहुत कम आवश्यकता होती है। SLF4J और Log4j 2 नए होने से लाभान्वित होते हैं और पुराने ढांचे से सीखे गए पाठों का निर्माण करते हैं। इसके अतिरिक्त जेसीएल को वर्ग लोडर के साथ समस्याएं ज्ञात हैं, यह निर्धारित करते समय कि किस लॉगिंग लाइब्रेरी को लपेटना चाहिए [4] जो अब जेसीएल की जगह ले चुका है।[5]जावा लॉगिंग एपीआई जावा के साथ प्रदान किया गया है। यद्यपि एपीआई तकनीकी रूप से जावा के साथ प्रदान किए गए डिफ़ॉल्ट कार्यान्वयन से अलग है, इसे वैकल्पिक कार्यान्वयन के साथ बदलना चुनौतीपूर्ण हो सकता है, इसलिए कई डेवलपर्स इस कार्यान्वयन को जावा लॉगिंग एपीआई के साथ भ्रमित करते हैं। विन्यास केवल बाहरी फ़ाइलों द्वारा होता है जो फ्लाई पर सरलता से नहीं बदला जाता है (अन्य ढांचे कार्यक्रम संबंधी विन्यास का समर्थन करते हैं)। डिफ़ॉल्ट कार्यान्वयन केवल कुछ संचालक और फॉर्मेटर्स प्रदान करता है, जिसका अर्थ है कि अधिकांश उपयोगकर्ताओं को अपना स्वयं का लिखना होगा।[6]
यह भी देखें
- SLF4J
- log4j
- लॉगबैक
- जावोल्यूशन लॉग कॉन्टेक्स्ट संदर्भ प्रोग्रामिंग पर आधारित है (रन-टाइम पर चयन योग्य वास्तविक लॉगिंग फ्रेमवर्क)।
- कार्यावधि बुद्धिमत्ता
संदर्भ
बाहरी संबंध
- Java 6.0 Logging API
- Commons Logging
- Protomatter
- Open Source Logging Tools in Java
- The Apache 2.0 license.
- लॉगबैक - A successor to the popular Log4j project
- tinylog - Minimalist logging utility with a static logger
- Loggifier A tool that inserts logging code into .class, .jar and .ear files
- JLV - Java logging viewer which is currently available as a plugin for Eclipse IDE
- Perf4j
- SLF4J
- Log4j 2