نحوه عیب‌یابی خطاهای رایج در HAProxy

مقدمه

برای عیب‌یابی HAProxy سه دستور اصلی و یک مسیر لاگ وجود دارد که معمولاً به ترتیب از آن‌ها استفاده می‌کنید:

• systemctl → مدیریت و بررسی وضعیت سرویس‌ها
• journalctl → مشاهده لاگ‌های systemd
• haproxy → بررسی کانفیگ HAProxy
• /var/log/haproxy.log → لاگ‌های مربوط به ترافیک و خطاها

بررسی وضعیت HAProxy با systemctl

برای بررسی وضعیت سرویس:

sudo systemctl status haproxy.service -l --no-pager

🔹 گزینه -l خروجی کامل را نشان می‌دهد
🔹 گزینه --no-pager خروجی را مستقیم در ترمینال نمایش می‌دهد

خروجی سالم:

Active: active (running)

خروجی خطادار:

Active: failed (Result: exit-code)

اگر وضعیت failed باشد یعنی مشکلی در سرویس یا تنظیمات وجود دارد.

بررسی لاگ‌ها با journalctl

برای مشاهده لاگ‌های مربوط به HAProxy:

sudo journalctl -u haproxy.service --since today --no-pager

🔹 فقط لاگ‌های امروز را نشان می‌دهد

حالت سالم:

Started HAProxy Load Balancer

حالت خطا:

Failed to start HAProxy Load Balancer

اگر اینجا خطا دیدی، احتمالاً مشکل از تنظیمات یا اجراست.

بررسی کانفیگ با haproxy

برای تست فایل تنظیمات:

sudo haproxy -c -f /etc/haproxy/haproxy.cfg

اگر درست باشد:

Configuration file is valid

اگر خطا داشته باشد:

unknown keyword 'bind' in 'global' section

🔹 این پیام‌ها معمولاً شماره خط را هم می‌دهند تا سریع اصلاحش کنی.

بررسی لاگ‌های HAProxy

فایل لاگ اصلی:

/var/log/haproxy.log

برای دیدن آخرین لاگ‌ها:

sudo tail -n 2 /var/log/haproxy.log

نمونه خطا:

503 error

🔹 این لاگ‌ها شامل:

• IP کاربر
• کد HTTP (مثل 503)
• وضعیت سرور backend

نکات مهم در عیب‌یابی

• کدهای HTTP خیلی مهم‌اند (مثلاً 500، 503)
• خطاهای کانفیگ سریع‌ترین راه پیدا کردن مشکل‌اند
• لاگ‌ها دقیق‌ترین اطلاعات را می‌دهند
• ترتیب بررسی مهم است

جمع‌بندی

برای عیب‌یابی اصولی:

1. بررسی وضعیت سرویس با systemctl
2. بررسی لاگ سیستم با journalctl
3. تست کانفیگ با haproxy -c
4. بررسی لاگ‌های دقیق در /var/log/haproxy.log

از همراهی شما با پارمین کلود سپاسگزاریم.