لاگ‌ها و ذخیره‌سازی

لاگ را بخوانید

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، Storage مسیرهای کانتینر را نشان می‌دهد. راه‌حل: با نگاشت ولوم‌هایتان مقایسه کنید. پوشه‌ها را ببینید.

برای حرفه‌ای‌ها

سطح‌ها چطور حدس زده می‌شوند

سطح از کلمه‌های داخل خط می‌آید. «failed»، «crashed» و «error» خطا را نشان می‌دهند. «could not»، «refused» و «timed out» هشدار را نشان می‌دهند.

چه چیزی پوشانده می‌شود

هر خط هنگام نوشتن و دوباره هنگام خواندن یا دانلود پوشانده می‌شود:

• هر کلید، توکن، گذرواژه و پیوند webhook ذخیره‌شده، با شکل‌های escape‌شدهٔ پیوند و base64 هم.
• مقدارهای قدیمی. وقتی یک مقدار محرمانه عوض یا حذف می‌شود، هر دو فایل لاگ پیش از دور ریختن مقدار قدیمی با پوشاندن آن بازنویسی می‌شوند.
• نام‌ها و گذرواژه‌ها در پیوندها: http://user:pass@host به http://[hidden]@host تبدیل می‌شود.
• پارامترهای پیوند مثل apikey=، token=، passkey=، password=.
• جفت‌هایی که نامشان محرمانه بودن مقدار را نشان می‌دهد: کلید API، توکن، گذرواژه، secret، کوکی، authorization، کد راه‌اندازی. مقدارهای داخل گیومه تا گیومهٔ بسته پوشانده می‌شوند.
• توکن‌های Bearer و basic، کلیدهای API در HolyArrs (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 نیاز دارند.

صفحه‌های مرتبط

• دریافت پشتیبانی
• بررسی‌های سلامت
• بکاپ‌ها