লগ ও স্টোরেজ

লগ পড়ুন

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 একই আউটপুট দেখায়।

কাজ না করলে

লক্ষণ: লগ পাতাটি নেই। কারণ: শুধু মালিক আর অ্যাডমিনরা এটি দেখতে পান। সমাধান: তাঁদের কাউকে বলুন।

লক্ষণ: একটি পাথ ভুল মনে হচ্ছে। কারণ: Docker-এ স্টোরেজ কন্টেইনারের পাথ দেখায়। সমাধান: আপনার ভলিউম ম্যাপিংয়ের সঙ্গে মিলিয়ে দেখুন। দেখুন ফোল্ডার।

বিশেষজ্ঞদের জন্য

স্তর কীভাবে আন্দাজ করা হয়

স্তর ঠিক হয় লাইনের শব্দ দেখে। “failed”, “crashed” আর “error” ত্রুটি চিহ্নিত করে। “could not”, “refused” আর “timed out” সতর্কতা চিহ্নিত করে।

কী ঢাকা হয়

প্রতিটি লাইন লেখার সময় ঢাকা হয়, আবার পড়ার বা ডাউনলোডের সময়ও:

• সেভ করা প্রতিটি কী, টোকেন, পাসওয়ার্ড আর webhook লিংক, লিংক-escape করা আর 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_...), প্রথমবার চালু করার সেটআপ কোড আর টোকেনের মতো লম্বা স্ট্রিং।

মানের ভেতরের লাইন ব্রেক আর টার্মিনালের রঙের কোড escape করা অবস্থায় দেখানো হয়, ফলে কোনো মান ভুয়া নতুন লাইন বানাতে পারে না। 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 স্কোপ লাগে।

সংশ্লিষ্ট

• সাপোর্ট নিন
• হেলথ চেক
• ব্যাকআপ