لاگها و اشکالزدایی
logهای agent و gatewayها را بخوانید و خطاها را سریعتر پیدا کنید.
Akvan logهای چرخشی را زیر ~/.akvan/logs/ نگه میدارد تا فضای دیسک بدون محدودیت رشد نکند.
فایلهای اصلی
| فایل | کاربرد |
|---|---|
agent.log | sessions، tools، memory، skills و فعالیت CLI |
errors.log | warningها و errorها |
gateway-{id}.log | process هر gateway، مانند Telegram |
commandهای پرکاربرد
bash
akvan logs
akvan logs -f
akvan logs errors
akvan logs gateway telegram -f
akvan logs listفیلتر بر اساس زمان و component:
bash
akvan logs --since 1h --component memory
akvan logs errors --level ERRORفعال کردن جزئیات بیشتر
برای یک اجرا:
bash
AKVAN_LOG_LEVEL=DEBUG akvanیا بهصورت دائمی برای logging در ~/.akvan/config.yaml:
yaml
logging:
level: DEBUG
max_size_mb: 5
backup_count: 3AKVAN_LOG_LEVEL روی مقدار YAML اولویت دارد. اگر تنظیمات memory، skills یا web tools اثر نکردند، علاوه بر ~/.akvan/config.yaml، وجود project_root/config.yaml را هم بررسی کنید.
پیش از انتشار log در issue، keyها، pathهای شخصی و محتوای حساس گفتگو را حذف کنید. اگر از provider akvan استفاده میکنید، مقدار AKVAN_API_KEY را از log حذف کنید.
عیبیابی provider Akvan
| علامت | احتمال علت | اقدام |
|---|---|---|
| خطای ۴۰۱ | key نامعتبر یا منقضی | akvan model را اجرا کنید و دوباره با OTP وارد شوید |
| خطای ۴۰۲ | credit یا plan ناکافی | لینک داخل پیام خطا را دنبال کنید (planها یا شارژ credit) |
| خطای ۴۰۳ | مدل خارج از plan | plan را ارتقا دهید یا مدل مجاز دیگری انتخاب کنید |
| خطای اتصال | شبکه یا دسترسی به سرویس | اتصال اینترنت را بررسی کنید و دوباره تلاش کنید |
برای جزئیات بیشتر: AKVAN_LOG_LEVEL=DEBUG akvan