लॉग और स्टोरेज

लॉग पढ़ें

1. Settings > Logs (सेटिंग > लॉग) खोलें। यह ओनर और एडमिन को दिखता है।
2. एक Level (स्तर) चुनें: Every line (हर लाइन), Warnings and errors (चेतावनी और एरर) या Errors only (सिर्फ़ एरर)।
3. Text (टेक्स्ट) में टाइप करें, ताकि सिर्फ़ उन शब्दों वाली लाइनें रहें। छोटे-बड़े अक्षर से फ़र्क नहीं पड़ता।
4. दिन सीमित करने के लिए From (से) और To (तक) सेट करें; To वाला दिन भी शामिल होता है। Apply (लागू करें) चुनें।
5. Newer (नए) और Older (पुराने) से पेज बदलें, एक बार में 100 लाइनें, सबसे नई पहले। सिर्फ़ मेल खाती लाइनें दिखनी चाहिए।

लॉग शेयर करें

1. Settings > Logs पर Download (डाउनलोड) चुनें। सबसे नई लाइनें, 2 MB तक, एक टेक्स्ट फ़ाइल में मिलती हैं।
2. जहाँ आप मदद माँगते हैं, वहाँ इसे अटैच करें। सपोर्ट पाएं देखें।

कुंजी, टोकन और पासवर्ड पहले से [hidden] के रूप में छिपे होते हैं। फिर भी पोस्ट करने से पहले फ़ाइल एक बार पढ़ लें: टाइटल और फ़ोल्डर के नाम और आपके सर्वर का एड्रेस दिखते रहते हैं।

फ़ाइलें कहाँ रखी जाती हैं

Settings > This app > Storage (सेटिंग > यह ऐप > स्टोरेज) हर पाथ वैसे दिखाता है जैसे HolyArrs उसे देखता है, साथ में उसकी डिस्क की ख़ाली जगह। Docker में ये कंटेनर के अंदर के पाथ होते हैं।

पाथ	इसमें क्या है
कॉन्फ़िग फ़ोल्डर	HolyArrs का सारा डेटा
holyarrs.db	मुख्य डेटाबेस
holyarrs-events.db	हिस्ट्री डेटाबेस
बैकअप, आर्टवर्क, लॉग के फ़ोल्डर	कॉन्फ़िग फ़ोल्डर के अंदर
लाइब्रेरी फ़ोल्डर, डाउनलोडर का सेव फ़ोल्डर	आपका मीडिया और डाउनलोड

“free space unknown” (ख़ाली जगह पता नहीं) का मतलब है कि सिस्टम ने यह नहीं बताया।

लॉग फ़ाइल कॉन्फ़िग फ़ोल्डर में logs/holyarrs.log है। 5 MB होने पर यह logs/holyarrs.log.1 में चली जाती है, इसलिए लॉग 10 MB के आसपास रहते हैं। docker logs holyarrs भी वही आउटपुट दिखाता है।

अगर काम न करे

लक्षण: Logs पेज नहीं दिखता। वजह: यह सिर्फ़ ओनर और एडमिन को दिखता है। हल: उनमें से किसी से कहें।

लक्षण: कोई पाथ ग़लत लगता है। वजह: Docker में Storage कंटेनर के पाथ दिखाता है। हल: अपनी वॉल्यूम मैपिंग से मिलाकर देखें। फ़ोल्डर देखें।

एक्सपर्ट के लिए

स्तर का अंदाज़ा कैसे लगता है

स्तर लाइन के शब्दों से तय होता है। “failed”, “crashed” और “error” एरर बताते हैं। “could not”, “refused” और “timed out” चेतावनी बताते हैं।

क्या छिपाया जाता है

हर लाइन लिखते समय छिपाई जाती है, और पढ़ते या डाउनलोड करते समय दोबारा:

• हर सेव की गई कुंजी, टोकन, पासवर्ड और वेबहुक लिंक, इनके लिंक-एस्केप और base64 रूप भी।
• पुरानी वैल्यू। जब कोई सीक्रेट बदलता या हटता है, तो पुरानी वैल्यू छोड़ने से पहले दोनों लॉग फ़ाइलें उसे छिपाकर दोबारा लिखी जाती हैं।
• लिंक में नाम और पासवर्ड: http://user:pass@host बदलकर http://[hidden]@host हो जाता है।
• लिंक के पैरामीटर, जैसे apikey=, token=, passkey=, password=।
• सीक्रेट वाले नाम के जोड़े: API key, token, password, secret, cookie, authorization, setup code। कोट में लिखी वैल्यू बंद होने वाले कोट तक छिपाई जाती हैं।
• Bearer और basic टोकन, HolyArrs की API कुंजी (hak_...), पहली बार के सेटअप का कोड और टोकन जैसी लंबी स्ट्रिंग।

वैल्यू के अंदर की लाइन ब्रेक और टर्मिनल के रंग कोड एस्केप करके दिखाए जाते हैं, ताकि कोई वैल्यू नकली नई लाइन न बना सके। 4 या 5 अक्षर की सेव की गई वैल्यू सिर्फ़ पूरे शब्द के रूप में छिपाई जाती हैं, और तब कभी नहीं जब वे admin या test जैसा आम शब्द हों।

API

रूट	कौन	क्या
GET /api/v1/app/storage	Change settings (सेटिंग बदलना)	ख़ाली जगह के साथ पाथ
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	ओनर, एडमिन	लाइनें और कुल गिनती
GET /api/v1/logs/download	ओनर, एडमिन	सबसे नए 2 MB, सादे टेक्स्ट में

तीनों के लिए API कुंजी को admin स्कोप चाहिए।

इससे जुड़े पेज

• सपोर्ट पाएं
• हेल्थ चेक
• बैकअप