مدیریت لاگ‌ها
تعیین کانال یا تایپک مقصد برای هر نوع گزارش ربات و دیدن لاگ‌های سمت سرور.
ربات گزارش رویدادهای مهم (واریزها، خریدها، نمایندگی‌ها، بکاپ و…) را به کانال یا گروه‌هایی که شما تعیین می‌کنید می‌فرستد. از مسیر پنل مدیریت → 📝 مدیریت لاگ‌ها مقصد هر نوع لاگ را جدا تنظیم می‌کنید.
پیش‌نیاز
ربات باید در کانال یا گروه مقصد عضو و ادمین (با دسترسی ارسال پیام) باشد؛ وگرنه پیام تست و لاگ‌ها ارسال نمی‌شوند.
انواع لاگ
| دکمه | چه چیزی ارسال می‌شود |
|---|---|
| 💳 کارت به کارت دستی | رسیدهای کارت به کارت و نتیجهٔ بررسی آن‌ها |
| 💱 واریزی ارزی | پرداخت‌های ارزی تاییدشده و جزئیات تراکنش |
| 🏢 لاگ نمایندگی‌ها | خرید، تمدید، توقف، تعلیق، انقضا، حذف، تغییر رمز و هشدار موجودی نمایندگی‌ها. کسرهای دقیقه‌ای و مصرفی اینجا نمی‌آیند و در صورت‌حساب پنل تحت وب دیده می‌شوند |
| 🎁 دعوت دوستان و برداشت‌ها | پرداخت پاداش دعوت، تلاش‌های دعوت نامعتبر و درخواست‌های برداشت درآمد دعوت |
| 📋 سایر لاگ‌ها | خریدها و ساخت/حذف سرویس، ساخت کانفیگ توسط ادمین، شارژ گروهی، ریست تست، افزایش همگانی، به‌روزرسانی کوکی پنل‌ها و رویدادهای عمومی دیگر |
| 🗄 بکاپ ربات | فایل ZIP بکاپ دیتابیس (دستی و خودکار) |
| 📦 کانال آپدیت برنامه‌ها | محل نگهداری فایل‌های برنامه‌ها (APK و…) که با 🈸 آپدیت برنامه ها از گیت‌هاب دریافت می‌شوند |
| 🛍 گزارش خرید (کانال عمومی) | کارت تبلیغاتی خرید برای کانال عمومی: آیدی کاربر (با ارقام پایانی پنهان)، پنل، پلن، مبلغ و تاریخ، همراه دکمهٔ ورود به ربات |
گزارش خرید عمومی
🛍 گزارش خرید برای نمایش به مشتریان است (اثبات اجتماعی) و جدا از لاگ کامل خرید ادمین است. فقط وقتی ارسال می‌شود که برایش مقصد تعیین کرده باشید. متن آن را از 📝 متن‌های ربات → 📝 سایر → متن گزارش خرید در کانال با پلیس‌هولدرهای {user}، {panel}، {plan}، {service}، {price}، {date} و {time} تغییر دهید.
تنظیم مقصد
یک نوع لاگ را بزنید و نوع مقصد را انتخاب کنید:
آیدی عددی کانال را بفرستید؛ معمولاً با -100 شروع می‌شود، مثل -1001234567890. لینک یا یوزرنیم قبول نمی‌شود.
ساده‌ترین روش: در تایپک مورد نظر روی یک پیام بزنید، Copy Link را بگیرید و همان لینک را بفرستید:
https://t.me/c/3210435570/2/10122در این لینک 3210435570 شناسهٔ گروه و 2 شناسهٔ تایپک است. ربات هر دو را خودش استخراج می‌کند.
روش دوم: آیدی عددی گروه (مثل -1001234567890) را بفرستید؛ ربات سپس آیدی عددی تایپک (یا لینک پیامی از تایپک) را می‌خواهد.
بعد از ذخیره، ربات یک پیام تست (✅ لاگ ... با موفقیت ست شد! این پیام تست است.) به مقصد می‌فرستد. اگر تست ارسال نشود، پیام خطا با علتش را می‌بینید؛ عضویت و ادمین بودن ربات را بررسی کنید.
⚡ ست همه لاگ‌ها با یک آیدی
اگر می‌خواهید همه‌چیز به یک جا برود، این گزینه همان کانال یا تایپک را برای هر ۸ نوع لاگ یکجا ذخیره می‌کند. بعداً می‌توانید هر نوع را جداگانه عوض کنید.
کانال 🛍 گزارش خرید عمومی است. اگر «ست همه» زدید، حتماً بعد از آن مقصد گزارش خرید را جداگانه روی کانال عمومی بگذارید تا لاگ‌های خصوصی (رسیدها، بکاپ‌ها) در کانال عمومی منتشر نشود.
📊 وضعیت لاگ‌ها
برای هر نوع لاگ نشان می‌دهد کجا تنظیم شده (کانال یا سوپرگروه + تایپک) یا غیرفعال است.
مقصد پیش‌فرض LOG_CHANNEL
اگر در فایل .env مقدار LOG_CHANNEL (آیدی عددی یک کانال) را گذاشته باشید، لاگ‌هایی که مقصد اختصاصی ندارند به آن ارسال می‌شوند. همچنین اگر ارسال به مقصد اختصاصی خطا بدهد، ربات یک بار به LOG_CHANNEL امتحان می‌کند.
استثناها:
- 🗄 بکاپ ربات، 📦 کانال آپدیت برنامه‌ها و 🛍 گزارش خرید فقط به مقصد اختصاصی خودشان می‌روند و از
LOG_CHANNELاستفاده نمی‌کنند. بدون تنظیم کانال بکاپ، بکاپ ارسال نمی‌شود. - چند گزارش دیگر هم هستند که در این منو دکمه ندارند — مثل لاگ پرداخت‌های استارز، ثبت‌نام کاربر از وب‌اپ و خطاهای پرداخت — و همیشه به
LOG_CHANNELمی‌روند. اگر این‌ها را می‌خواهید،LOG_CHANNELرا تنظیم کنید.
ویرایش .env از منوی مدیریت سرور (گزینهٔ 5 یا pasarguardbot edit-env) انجام می‌شود و بعد از آن ربات را ری‌استارت کنید.
🈸 آپدیت برنامه ها نیاز به کانال دارد
دکمهٔ 🈸 آپدیت برنامه ها فایل‌های آخرین نسخهٔ اپ‌ها را از گیت‌هاب می‌گیرد و در 📦 کانال آپدیت برنامه‌ها آپلود می‌کند تا کاربران فوری دریافتشان کنند. تا این کانال تنظیم نشده باشد، پیام ❌ ابتدا باید یک کانال لاگ برای فایل‌های برنامه تنظیم کنید. می‌آید. جزئیات در لینک‌ها و برنامه‌ها.
لاگ‌های سمت سرور
لاگ‌های تلگرامی بالا برای رویدادهای کسب‌وکار هستند. برای عیب‌یابی فنی (خطاها، قطعی پنل، مشکل اتصال) لاگ خود برنامه روی سرور را ببینید:
# لاگ زندهٔ ربات (Ctrl+C برای خروج) pasarguardbot logs # یا از منوی مدیریت: گزینهٔ 4 (View logs) pasarguardbot menu
گزینهٔ 4) View logs در منو این زیرگزینه‌ها را دارد: لاگ ربات، MariaDB، Redis، همهٔ سرویس‌ها و لاگ زندهٔ ربات (۲۰۰ خط آخر).
برنامه علاوه بر خروجی کانتینر، لاگ را در فایل هم می‌نویسد:
| فایل | محتوا | چرخش (پیش‌فرض) |
|---|---|---|
app.log | همهٔ لاگ‌های سطح INFO به بالا | هر ۵ مگابایت، ۵ فایل قدیمی نگه داشته می‌شود |
error.log | فقط خطاها | هر ۲ مگابایت، ۳ فایل قدیمی نگه داشته می‌شود |
فایل‌های قدیمی با پسوند .1، .2 و… کنار همین فایل‌ها می‌مانند و قدیمی‌ترین‌ها خودکار پاک می‌شوند، پس حجم لاگ‌ها دیسک را پر نمی‌کند. وقتی گزارش خطا می‌دهید، چند خط آخر error.log را همراهش بفرستید.