लॉग्स
POS में दो लॉग इंटरफ़ेस हैं: इन-ऐप लॉग्स स्क्रीन (POS एप्लिकेशन के अंदर) और WP Admin लॉग्स पृष्ठ (WordPress के अंदर)। एक साथ वे डिबगिंग और ऑडिटिंग के लिए POS गतिविधि की एक पूर्ण तस्वीर देते हैं।
POS एप्लिकेशन लॉग्स
लॉग्स तक पहुँचना
बाईं ओर के नेविगेशन ड्रॉअर (हार्टबीट आइकन) से लॉग्स स्क्रीन खोलें।
इंटरफ़ेस अवलोकन
खोजें और फ़िल्टर करें
- लॉग्स खोजें - संदेश सामग्री द्वारा विशेष लॉग प्रविष्टियाँ खोजें
- लॉग स्तर फ़िल्टर - लॉग स्तर (जानकारी, चेतावनी, त्रुटि) द्वारा फ़िल्टर करें
- प्रदर्शन सेटिंग्स - दृश्य कॉलम कॉन्फ़िगर करें
लॉग्स तालिका
प्रत्येक लॉग प्रविष्टि दिखाती है:
| कॉलम | विवरण |
|---|---|
| समय | जब यह घटना घटी |
| स्तर | गंभीरता: जानकारी (ग्रे), चेतावनी (नारंगी), त्रुटि (लाल) |
| संदेश | घटना का मानव-पठनीय विवरण |
| संदर्भ | अतिरिक्त विवरण के साथ विस्तारणीय JSON |
| कोड | त्रुटि कोड (दस्तावेज़ीकरण से लिंक करता है) |
लॉग्स स्तर
जानकारी (ग्रे)
सामान्य संचालन और सफल घटनाएँ:
- "उत्पादों के लिए सभी IDs प्राप्त की गईं"
- "नए ग्राहकों को समन्वयित किया गया"
- "करों के लिए सभी IDs प्राप्त की गईं"
चेतावनी (नारंगी)
गैर-आवश्यक मुद्दे जिनपर ध्यान देने की आवश्यकता हो सकती है:
- "सत्र को ताज़ा करने में असमर्थ"
- "समन्वय का पुनः प्रयास"
त्रुटि (लाल)
समस्याएँ जिनका समाधान करना आवश्यक है:
- "क्षमा करें, आप संसाधनों को सूचीबद्ध नहीं कर सकते" (अनुमति संबंधी मुद्दा)
- "API अनुरोध विफल"
- "डेटाबेस समन्वय त्रुटि"
ऑडिट (नीला)
ऑडिट लॉग स्तर POS द्वारा किए गए डेटाबेस परिवर्तनों को रिकॉर्ड करता है, प्रत्येक संशोधन की पूर्ण पहले-और-बाद की स्थिति को कैप्चर करता है। यह ठीक-ठीक ट्रैक करने के लिए उपयोगी है कि क्या बदला और कब, उदाहरण के लिए ऑर्डर निर्माण, स्टॉक समायोजन, या ग्राहक अपडेट के दौरान।
ऑडिट प्रविष्टियों में शामिल हैं:
- एंटिटी प्रकार - संशोधित किया गया संसाधन (जैसे, ऑर्डर, उत्पाद, ग्राहक)
- क्रिया - परिवर्तन का प्रकार (बनाना, अपडेट, हटाना)
- पहले की स्थिति - परिवर्तन से पहले के पिछले मान
- बाद की स्थिति - परिवर्तन के बाद के नए मान
संदर्भ डेटा
विस्तृत JSON संदर्भ देखने के लिए किसी भी लॉग प्रविष्टि पर विस्तार तीर पर क्लिक करें:
{
"total": "6",
"execution_time": "54.79 ms",
"server_load": "[10.51, 10.42, 9.98]"
}
इस डेटा में शामिल हैं:
- आइटम गणनाएँ - कितने रिकॉर्ड प्रभावित हुए
- निष्पादन समय - संचालन में कितना समय लगा
- सर्वर लोड - सर्वर प्रदर्शन मेट्रिक्स
- अनुरोध/प्रतिक्रिया विवरण - API मुद्दों का डिबग करने के लिए
त्रुटि कोड
कई लॉग प्रविष्टियों में एक त्रुटि कोड शामिल होता है (जैसे, API02004, DB01001)। ये कोड सीधे त्रुटि कोड दस्तावेज़ से लिंक करते हैं, जो प्रदान करता है:
- त्रुटि का विस्तृत स्पष्टीकरण
- सामान्य कारण
- समस्या निवारण के उपाय
सामान्य लॉग्स प्रविष्टियाँ
समन्वय संचालन
[info] Fetched all IDs for products {...} 3 items
[info] Synced new customers {...} 1 item
[info] Fetched all IDs for taxes {...} 3 items
ये सामान्य समन्वय गतिविधि का संकेत देते हैं। संदर्भ दिखाता है कि कितने आइटम समन्वयित किए गए थे।
अनुमति त्रुटियाँ
[error] Sorry, you cannot list resources {...} API02004
इसका अर्थ आम तौर पर यह होता है कि उपयोगकर्ता को किसी संसाधन तक पहुँचने की अनुमति नहीं है। WP Admin > POS > Settings > Access में उपयोगकर्ता भूमिकाएँ जाँचें।
सत्र मुद्दे
[warn] Unable to refresh session {...} API02007
POS प्रमाणीकरण सत्र को ताज़ा नहीं कर सका। इसके लिए लॉग आउट होकर फिर से लॉग इन करने की आवश्यकता हो सकती है।
WP Admin लॉग्स पृष्ठ
POS प्लगइन WordPress व्यवस्थापक क्षेत्र में एक सर्वर-साइड लॉग्स पृष्ठ भी प्रदान करता है। यह पृष्ठ सर्वर पर लॉग की गई POS-विशिष्ट चेतावनियाँ और त्रुटियाँ दिखाता है, जो उन मुद्दों का निदान करने में मदद कर सकता है जो POS एप्लिकेशन में स्वयं प्रकट नहीं हो सकते।
WP Admin लॉग्स पृष्ठ तक पहुँचना
WP Admin > POS > Settings पर जाएँ, फिर Tools टैब चुनें और Logs पर क्लिक करें।
अपठित बैज
लॉग्स मेनू आइटम अपठित लॉग प्रविष्टियों को इंगित करने वाला एक बैज प्रदर्शित करता है:
- लाल बैज - अपठित त्रुटि-स्तरीय प्रविष्टियाँ हैं
- एम्बर बैज - अपठित चेतावनी-स्तरीय प्रविष्टियाँ हैं (लेकिन कोई त्रुटि नहीं)
लॉग्स पृष्ठ पर जाने से अपठित गणनाएँ रीसेट हो जाती हैं। गणनाएँ प्रति-उपयोगकर्ता ट्रैक की जाती हैं, इसलिए प्रत्येक व्यवस्थापक अपनी स्वयं की अपठित स्थिति देखता है।
प्रविष्टियों को फ़िल्टर करना
लॉग प्रविष्टियों को सीमित करने के लिए स्तर फ़िल्टर का उपयोग करें:
- सभी - सभी लॉग प्रविष्टियाँ दिखाएँ
- त्रुटियाँ - केवल त्रुटि-स्तरीय प्रविष्टियाँ दिखाएँ
- चेतावनियाँ - केवल चेतावनी-स्तरीय प्रविष्टियाँ दिखाएँ
विस्तारणीय प्रविष्टियाँ
लंबे लॉग संदेश लगभग 100 अक्षरों पर छोटे कर दिए जाते हैं। किसी प्रविष्टि को विस्तृत करने और किसी भी अतिरिक्त संदर्भ डेटा के साथ पूर्ण संदेश देखने के लिए उस पर क्लिक करें।
पृष्ठांकन
लॉग प्रविष्टियाँ सर्वर-साइड पर पृष्ठांकित की जाती हैं। पुरानी प्रविष्टियों के बीच नेविगेट करने के लिए पृष्ठांकन नियंत्रणों का उपयोग करें।
फेटल एरर बैनर
यदि सर्वर में fatal-errors-*.log फ़ाइलें हैं, तो लॉग्स पृष्ठ शीर्ष पर एक चेतावनी बैनर प्रदर्शित करता है। यह बैनर WooCommerce > Status > Logs से लिंक करता है जहाँ आप पूर्ण फेटल एरर लॉग देख सकते हैं। फेटल एरर आमतौर पर PHP-स्तरीय क्रैश होते हैं जो POS API को प्रतिक्रिया देने से रोकते हैं।
समर्थन के लिए लॉग्स का उपयोग
जब सहायता का अनुरोध करें:
- समस्या को पुन: उत्पन्न करें - उस क्रिया को करें जो समस्या उत्पन्न करती है
- लॉग्स की जाँच करें - त्रुटियों (लाल) या चेतावनियों (नारंगी) की तलाश करें
- संदर्भ को विस्तृत करें - पूर्ण JSON विवरण प्राप्त करें
- त्रुटि कोड नोट करें - इसे अपने सहायता अनुरोध में शामिल करें
- प्रासंगिक प्रविष्टियाँ कॉपी करें - संदर्भ सहित लॉग्स संदेशों को साझा करें
प्रदर्शन निगरानी
लॉग्स में निष्पादन समय और सर्वर लोड मेट्रिक्स शामिल होते हैं। यदि आप ध्यान दें:
- उच्च निष्पादन समय - सर्वर अधिभारित या धीमा हो सकता है
- उच्च सर्वर लोड मान - सर्वर अनुकूलन पर विचार करें
- आवर्ती टाइमआउट - नेटवर्क कनेक्टिविटी जाँचें