لاگها (Logs)#
برنامه bgscan سه جریان مجزای لاگگیری (Log Streams) را نگهداری میکند که هرکدام لایه متفاوتی از برنامه را پوشش میدهند. شما میتوانید هر یک از آنها را به صورت زنده از داخل محیط گرافیکی متنی (TUI) مشاهده کنید.
برای باز کردن منوی لاگ، از Main Menu ← Logs اقدام کنید.
دستهبندی لاگها#
| کلید میانبر | دستهبندی | توضیحات |
|---|---|---|
c | لاگهای هسته (Core Logs) | فعالیتهای موتور اسکنر — از جمله بررسی آیپيها، ورودی/خروجی فایلها، ثبت نتایج و خطاهای داخلی هسته اسکنر. |
u | لاگهای رابط کاربری (UI Logs) | رویدادهای مربوط به لایه کاربری — مانند چرخه حیات کامپوننتها، عملیاتهای فایلی اجرا شده از داخل TUI و خطاهای سطح رابط کاربری. |
d | لاگهای عیبیابی (Debug Logs) | خروجیهای تشخیصی سطح پایین — وضعیتهای دقیق داخلی، دامتهای داده (Data Dumps) و ردپای دقیق خطاها (Verbose Traces) جهت رفع مشکل. |
با فشردن کلید مربوطه، نمایشدهنده اختصاصی آن لاگ باز میشود.
محیط نمایشدهنده لاگ (The Log Viewer)#
هر نمایشدهنده لاگ، لیستی قابل اسکرول از ورودیهای زماندار مربوط به آن دسته را نشان میدهد. پیامهای جدید با باز بودن پنجره به صورت خودکار و زنده تزریق میشوند؛ بنابراین نیازی به رفرش یا بهروزرسانی دستی ندارید.
فرمت هر خط از لاگ به صورت زیر است:
2006/01/02 15:04:05 [LEVEL] messageسطوح لاگ (Log Levels) شامل INFO، WARN، ERROR و DEBUG هستند.
این پنجره هنگام باز شدن، ۲۰۰ خط آخر فایل لاگ را از قبل بارگذاری میکند تا حتی اگر اتفاق جدیدی هم در جریان نباشد، بتوانید بلافاصله فعالیتهای اخیر سیستم را مشاهده کنید.
ناوبری و کلیدها#
| کلید | عملکرد |
|---|---|
↑ / ↓ | اسکرول به بالا / پایین |
b یا Esc | بستن نمایشدهنده لاگ |
فایلهای لاگ#
تمامی لاگها در دایرکتوری logs/ در کنار فایل باینری bgscan ذخیره میشوند:
/
└── logs/
├── core.log
├── ui.log
└── debug.logفایلهای لاگ به صورت خودکار جابهجا و بایگانی (Rotate) میشوند — سقف حجم هر فایل ۵۰ مگابایت است، تا ۳ فایل پشتیبان قدیمی نگهداری میشود و فایلهای قدیمیتر از ۷ روز به طور خودکار حذف خواهند شد. پشتیبانهای قدیمیتر نیز جهت صرفهجویی در فضای دیسک فشرده (Compress) میشوند.
اگر نیاز دارید لاگها را خارج از محیط TUI بررسی کنید، میتوانید این فایلها را مستقیماً با هر ویرایشگر متن یا دستور tail -f مطالعه کنید.