سجلات التشغيل والتخزين

قراءة سجل التشغيل

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. أرفقه حيث تطلب المساعدة. انظر الحصول على الدعم.

المفاتيح والرموز (tokens) وكلمات المرور محجوبة مسبقًا بالشكل [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” تدل على تحذير.

ما الذي يُحجب

يُحجب كل سطر عند كتابته، ثم مرة أخرى عند قراءته أو تنزيله:

• كل مفتاح ورمز (token) وكلمة مرور ورابط webhook محفوظ، وكذلك صيغها المرمّزة للروابط وصيغ base64.
• القيم القديمة. حين يتغيّر سرّ أو يُزال، تُعاد كتابة ملفَّي السجل وهو محجوب فيهما قبل التخلّص من القيمة القديمة.
• الأسماء وكلمات المرور في الروابط: http://user:pass@host يصير http://[hidden]@host.
• معاملات الروابط مثل apikey= وtoken= وpasskey= وpassword=.
• الأزواج التي فيها اسم سرّ: API key وtoken وpassword وsecret وcookie وauthorization وsetup code. القيم الموضوعة بين علامتَي اقتباس تُحجب حتى علامة الإغلاق.
• رموز Bearer وbasic، ومفاتيح API الخاصة بـ HolyArrs (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 للثلاثة كلها.

صفحات ذات صلة

• الحصول على الدعم
• فحوص السلامة
• النسخ الاحتياطية