همه مقالات تخصصی

لاگ‌های Plesk و عیب‌یابی خطاهای 500، 502 و 504

لاگ‌های دامنه در Plesk را پیدا کنید، با کد وضعیت لایهٔ خراب را بشناسید و بدون ری‌استارت تصادفی علت خطاهای ۵۰۰ و ۵۰۲ و ۵۰۴ را بیابید.

لاگ‌های Plesk و عیب‌یابی خطاهای 500، 502 و 504

وقتی سایتی روی Plesk خطای ۵۰۰، ۵۰۲ یا ۵۰۴ نشان می‌دهد مرورگر دلیلی نمی‌گوید. Plesk معمولاً nginx را جلوی Apache یا PHP-FPM می‌گذارد، پس خطا می‌تواند از چند لایه بیاید و هر لایه لاگ خودش را می‌نویسد. این راهنما نشان می‌دهد لاگ‌های یک دامنه کجاست، با کد وضعیت چطور بفهمید کدام لایه خراب شده و چه ترتیب کوتاهی از بررسی‌ها بدون ری‌استارت‌های تصادفی علت را پیدا می‌کند. مسیرها و نام منوها با نسخهٔ Plesk، سیستم‌عامل و تنظیمات ارائه‌دهنده فرق می‌کنند، پس مثال‌ها را نقطهٔ شروع بدانید.

۱. لایه‌ها را بشناسید

درخواست معمول Plesk می‌رود مرورگر، بعد nginx، بعد Apache یا PHP-FPM، بعد کد PHP و دیتابیس. خطای ۵۰۰ معمولاً یعنی برنامه یا یک قاعدهٔ Apache شکست خورده. ۵۰۲ یعنی nginx از لایهٔ پشت خودش پاسخ معتبر نگرفته. ۵۰۴ یعنی آن لایه بیش از حد طول کشیده. دانستن این به شما می‌گوید اول کدام لاگ را باز کنید و از وقت‌تلف‌کردن روی لاگ اشتباه جلوگیری می‌کند.

۲. لاگ‌های دامنه را باز کنید

در Plesk به Websites & Domains، دامنه و بعد Logs بروید. لاگ دسترسی، لاگ خطا و وقتی nginx پروکسی است لاگ‌های خودش را می‌بینید. مدیران می‌توانند Log Browser را هم زیر Tools & Settings استفاده کنند. در Terminal همین فایل‌ها معمولاً اینجاست:

# Logs of one domain (replace example.com)
cd /var/www/vhosts/system/example.com/logs
ls -lh
tail -n 40 error_log
tail -n 40 proxy_error_log

خطا را بازتولید کنید و بعد تازه‌ترین خط‌های هم‌زمان را بخوانید نه قدیمی‌ترین‌ها. لاگ خطا دلیل را نشان می‌دهد و لاگ دسترسی کد وضعیت و URL را.

۳. درخواست‌های شکست‌خورده را پیدا کنید

لاگ دسترسی نشان می‌دهد کدام URLها ۵xx برمی‌گردانند و چند بار. یک فیلتر فقط‌خواندنی:

# Last 5xx responses in the access log (Common/Combined log format)
awk '$9 ~ /^5/ {print $4, $7, $9}' access_log | tail -n 20

الگو مهم است: اگر یک URL شکست می‌خورد علت احتمالاً در همان صفحه یا افزونه است؛ اگر همه‌چیز شکست می‌خورد سراغ سرویس‌ها و منابع بروید. اگر زمان شکست با اوج ترافیک یا یک کران‌جاب می‌خواند به سقف منابع مشکوک شوید. با راهنمای خطاهای سقف منابع و کندی پاسخ و TTFB مقایسه کنید.

۴. بررسی کنید سرویس‌ها اجرا هستند

اگر لاگ‌ها connection refused یا نبودن upstream زنده را نشان می‌دهند، سرویس پشت nginx ممکن است متوقف یا کرش کرده باشد. وضعیتش را ببینید و پیکربندی را تست کنید:

systemctl status nginx --no-pager | head -n 8
systemctl status apache2 --no-pager | head -n 8   # on RHEL-like systems: httpd
nginx -t
plesk bin php_handler --list

دستور آخر handlerهای PHP را فهرست می‌کند. روی سرور تولید همه‌چیز را یک‌جا ری‌استارت نکنید؛ فقط سرویسی را که اشتباه به نظر می‌رسد ری‌استارت کنید و دوباره لاگش را بخوانید. تست پیکربندی قبل از reload جلوی تبدیل مشکل کوچک به قطعی را می‌گیرد.

۵. پیام را با راه‌حل معمول تطبیق دهید

خطای مرگبار PHP در لاگ خطا به افزونه، قالب یا ناسازگاری نسخهٔ PHP اشاره می‌کند؛ راهنمای نسخهٔ PHP را ببینید. «Invalid command» یا «syntax error» نزدیک .htaccess یعنی قاعدهٔ بد؛ فایل را تغییر نام دهید و دوباره تست کنید. «Primary script unknown» یا «Permission denied» به document root یا دسترسی‌ها اشاره می‌کند. timeout در درخواست‌های کند پیشنهاد می‌کند سقف زمان را فقط بعد از فهمیدن دلیل کندی بالا ببرید و تعداد خیلی کم workerهای PHP-FPM می‌تواند درخواست‌ها را تا timeout صف کند.

۶. یادداشت کوتاه نگه دارید

زمان، URL، کد وضعیت، خط لاگ و تنها تغییری که دادید را بنویسید. اگر مشکل برگشت، الگو را می‌بینید. هر بار یک تغییر بدهید و تغییری را که کمک نکرد برگردانید. اگر علت را پیدا نکردید زمان دقیق، URL و خط خطا را با حذف رمزها و داده‌های شخصی برای ارائه‌دهنده بفرستید.

۷. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید سایتی هر ساعت چند دقیقه ۵۰۲ نشان می‌دهد (الگوی ساختگی). لاگ خطای پروکسی در آن زمان‌ها می‌گوید upstream زنده نیست و یک بکاپ زمان‌بندی‌شده دقیقاً همان دقیقه شروع می‌شود. بکاپ آن‌قدر حافظه می‌گیرد که handler PHP کشته و دوباره راه‌اندازی می‌شود. انتقال بکاپ به زمان کم‌ترافیک یا محدودکردن بارش ۵۰۲ را بدون هیچ تغییری در وردپرس برمی‌دارد.

۸. اشتباه‌های رایج

  • ری‌استارت همهٔ سرویس‌ها بدون خواندن لاگ.
  • خواندن خط لاگ قدیمی مربوط به مشکل دیگر.
  • بالابردن timeout قبل از فهمیدن دلیل کندی.
  • حذف .htaccess به‌جای تغییر نام.
  • تغییر هم‌زمان چند تنظیم.
  • به اشتراک‌گذاشتن لاگ همراه رمز یا داده‌های شخصی.

۹. پرسش‌های متداول

اول کدام لاگ را بخوانم؟ لاگ خطای دامنه را در زمان شکست بخوانید و اگر وضعیت ۵۰۲ یا ۵۰۴ است لاگ خطای پروکسی را.

چرا Plesk دو مجموعه لاگ دارد؟ چون nginx و Apache یا PHP-FPM لایه‌های جدا هستند. هر کدام آنچه دیده را می‌نویسد.

۵۰۲ و ۵۰۴ یکی‌اند؟ نه. ۵۰۲ یعنی پاسخ بد یا نبودن پاسخ از لایهٔ پشت و ۵۰۴ یعنی آن لایه خیلی کند بوده.

می‌توانم نگه‌داری لاگ را عوض کنم؟ Plesk تنظیمات چرخش لاگ دارد و ممکن است ارائه‌دهنده مدیریتش کند. لاگ‌های زنده را دستی پاک نکنید.

۱۰. چک‌لیست سریع

  1. خطا را بازتولید کنید و زمان و URL را بنویسید.
  2. با کد وضعیت لایه را تعیین کنید.
  3. لاگ خطای دامنه و لاگ خطای پروکسی را باز کنید.
  4. لاگ دسترسی را برای ۵xx فیلتر کنید.
  5. سرویس‌ها را بررسی و پیکربندی را تست کنید.
  6. پیام را با علت معمول تطبیق دهید.
  7. هر بار یک تغییر بدهید و ثبتش کنید.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

Plesk Obsidian: Website Logs · Plesk Obsidian: Log Browser · nginx: ngx_http_proxy_module · Apache HTTP Server: Log files