AB(1) ab AB(1)

ab - ابزار سنجش کارایی (بنچمارک) سرور وب Apache HTTP

ab [ -A auth-username:password ] [ -b windowsize ] [ -B local-address ] [ -c concurrency ] [ -C cookie-name=value ] [ -d ] [ -e csv-file ] [ -E client-certificate file ] [ -f protocol ] [ -g gnuplot-file ] [ -h ] [ -H custom-header ] [ -i ] [ -k ] [ -l ] [ -m HTTP-method ] [ -n requests ] [ -p POST-file ] [ -P proxy-auth-username:password ] [ -q ] [ -r ] [ -s timeout ] [ -S ] [ -t timelimit ] [ -T content-type ] [ -u PUT-file ] [ -v verbosity] [ -V ] [ -w ] [ -x <table>-attributes ] [ -X proxy[:port] ] [ -y <tr>-attributes ] [ -z <td>-attributes ] [ -Z ciphersuite ] [http[s]://]hostname[:port]/path

ابزار ab ابزاری برای سنجش کارایی و بارگذاری سرور Apache Hypertext Transfer Protocol (HTTP) شما است. این ابزار طوری طراحی شده که دیدی کلی از نحوه عملکرد نصب فعلی آپاچی به شما بدهد. این ابزار به ویژه نشان می‌دهد که وب‌سرور آپاچی شما قادر به پاسخگویی به چند درخواست در ثانیه است.

ارائه اطلاعات احراز هویت پایه (BASIC Authentication) به سرور. نام کاربری و گذرواژه با یک نویسه : از هم جدا شده و به صورت کدگذاری base64 روی شبکه ارسال می‌شوند. این رشته بدون در نظر گرفتن اینکه سرور به آن نیاز دارد یا خیر (یعنی کد 401 authentication needed ارسال کرده باشد یا نه) ارسال می‌شود.
اندازه بافر ارسال/دریافت TCP بر حسب بایت.
نشانی محلی برای اتصال (bind) هنگام برقراری ارتباطات خروجی.
تعداد درخواست‌های هم‌زمان در یک لحظه. مقدار پیش‌فرض یک درخواست در هر لحظه است.
افزودن یک خط Cookie: به درخواست. این آرگومان معمولاً در قالب یک جفت name=value است. این فیلد تکرارپذیر است.
جدول "percentage served within XX [ms] table" را نمایش ندهد (برای سازگاری با نسخه‌های قدیمی).
نوشتن یک پرونده با مقادیر جداشده با کاما (CSV) که برای هر درصد (از ۱٪ تا ۱۰۰٪) زمانی را که (بر حسب میلی‌ثانیه) صرف پاسخ به آن درصد از درخواست‌ها شده است، ثبت می‌کند. این قالب معمولاً از پرونده 'gnuplot' مفیدتر است زیرا نتایج از قبل دسته‌بندی شده‌اند.
هنگام اتصال به وب‌سایت دارای SSL، از گواهی کلاینت ارائه‌شده در قالب PEM برای احراز هویت با سرور استفاده می‌کند. انتظار می‌رود پرونده شامل گواهی کلاینت، به همراه گواهی‌های میانی و کلید خصوصی باشد. موجود در نسخه 2.4.36 و بالاتر.
تعیین پروتکل SSL/TLS (شامل SSL2, SSL3, TLS1, TLS1.1, TLS1.2 یا ALL). پشتیبانی از TLS1.1 و TLS1.2 در نسخه 2.4.4 و بالاتر موجود است.
نوشتن تمام مقادیر اندازه‌گیری‌شده در قالب یک پرونده 'gnuplot' یا TSV (مقادیر جداشده با تب). این پرونده را می‌توان به راحتی در بسته‌هایی مانند Gnuplot, IDL, Mathematica, Igor یا حتی Excel وارد کرد. عناوین در خط اول پرونده قرار دارند.
نمایش اطلاعات نحوه استفاده.
الحاق هدرهای اضافی به درخواست. این آرگومان معمولاً در قالب یک خط هدر معتبر شامل جفت فیلد-مقدار جداشده با دونقطه است (مثلاً "Accept-Encoding: zip/zop;8bit").
ارسال درخواست‌های HEAD به جای GET.
فعال‌سازی قابلیت KeepAlive در HTTP، یعنی ارسال چندین درخواست در طول یک نشست HTTP. پیش‌فرض بدون KeepAlive است.
اگر طول پاسخ‌ها ثابت نباشد خطایی گزارش ندهد. این گزینه می‌تواند برای صفحات پویا مفید باشد. موجود در نسخه 2.4.7 و بالاتر.
متد HTTP سفارشی برای درخواست‌ها. موجود در نسخه 2.4.10 و بالاتر.
تعداد درخواست‌ها برای اجرای نشست بنچمارک. مقدار پیش‌فرض تنها یک درخواست است که معمولاً به نتایج غیرواقعی منجر می‌شود.
پرونده حاوی داده‌ها برای ارسال به روش POST. به یاد داشته باشید که گزینه -T را نیز تنظیم کنید.
ارائه اطلاعات احراز هویت پایه (BASIC Authentication) به پراکسی در مسیر. نام کاربری و گذرواژه با یک : جدا شده و با کدگذاری base64 فرستاده می‌شوند. رشته بدون توجه به نیاز پراکسی ارسال می‌شود (مثلاً ارسال کد 407 proxy authentication needed).
هنگام پردازش بیش از ۱۵۰ درخواست، ab گزارش پیشرفت را در هر ۱۰٪ یا حدود ۱۰۰ درخواست روی stderr چاپ می‌کند. گزینه -q این پیام‌ها را غیرفعال می‌کند.
در صورت بروز خطاهای دریافت سوکت خارج نشود.
حداکثر زمان به ثانیه برای انتظار پیش از منقضی شدن زمان سوکت (timeout). پیش‌فرض ۳۰ ثانیه است. موجود در نسخه 2.4.4 و بالاتر.
عدم نمایش مقادیر میانه و انحراف معیار، و عدم نمایش پیام‌های هشدار/خطا هنگامی که میانگین و میانه بیش از یک یا دو برابر انحراف معیار تفاوت دارند. و استفاده پیش‌فرض از مقادیر min/avg/max (برای سازگاری با نسخه‌های قدیمی).
حداکثر زمان به ثانیه برای اجرای بنچمارک. این گزینه به‌طور ضمنی مقدار -n 50000 را در نظر می‌گیرد. برای بنچمارک سرور در یک محدوده زمانی ثابت از این گزینه استفاده کنید. به‌طور پیش‌فرض محدودیت زمانی وجود ندارد.
هدر Content-type برای داده‌های POST/PUT، مانند application/x-www-form-urlencoded. پیش‌فرض text/plain است.
پرونده حاوی داده‌ها برای ارسال به روش PUT. به یاد داشته باشید که گزینه -T را نیز تنظیم کنید.
تنظیم سطح گزارش جزئیات - مقدار 4 و بالاتر اطلاعات هدرها را چاپ می‌کند، 3 و بالاتر کدهای پاسخ (404, 200 و...) را چاپ می‌کند، و 2 و بالاتر هشدارها و پیام‌های اطلاعاتی را نمایش می‌دهد.
نمایش شماره نسخه و خروج.
چاپ نتایج در قالب جدول‌های HTML. جدول پیش‌فرض دو ستونه با پس‌زمینه سفید است.
رشته‌ای به عنوان ویژگی‌های تگ <table>. ویژگی‌ها در مکان <table here > درج می‌شوند.
استفاده از یک سرور پراکسی برای ارسال درخواست‌ها.
رشته‌ای به عنوان ویژگی‌های تگ <tr>.
رشته‌ای به عنوان ویژگی‌های تگ <td>.
مشخص کردن سوئیت رمزنگاری SSL/TLS (به openssl ciphers مراجعه کنید).

فهرست زیر مقادیر بازگردانده‌شده توسط ab را توضیح می‌دهد:

مقداری که در صورت وجود، در هدر HTTP به نام server اولین پاسخ موفق بازگردانده شده است. این شامل تمام نویسه‌ها از ابتدای هدر تا کاراکتری با مقدار ده‌دهی ۳۲ (فاصله یا خط جدید) است.
نام DNS یا نشانی IP مشخص‌شده در خط فرمان.
پورتی که ab به آن متصل می‌شود. اگر پورتی تعیین نشده باشد، پیش‌فرض برای http مقدار 80 و برای https مقدار 443 خواهد بود.
پارامترهای پروتکل توافق‌شده میان کلاینت و سرور. تنها در صورت استفاده از SSL نمایش داده می‌شود.
مسیر شناسه URI درخواست که از رشته خط فرمان استخراج شده است.
اندازه نخستین سند بازگردانده‌شده با موفقیت بر حسب بایت. اگر اندازه سند در طول آزمون تغییر کند، پاسخ یک خطا تلقی خواهد شد.
تعداد کلاینت‌های هم‌زمان مورد استفاده در طول آزمون.
مدت زمان سپری‌شده از لحظه ایجاد اولین اتصال سوکت تا لحظه دریافت آخرین پاسخ.
تعداد پاسخ‌های موفق دریافت شده.
تعداد درخواست‌هایی که ناموفق تلقی شده‌اند. اگر این عدد بزرگتر از صفر باشد، خط دیگری چاپ خواهد شد که تعداد درخواست‌های ناموفق ناشی از اتصال، خواندن، طول محتوای نادرست یا استثناها را نشان می‌دهد.
تعداد خطاهایی که در حین نوشتن رخ داده‌اند (شکستگی لوله pipe).
تعداد پاسخ‌هایی که در سری کدهای ۲۰۰ نبوده‌اند. اگر تمام پاسخ‌ها ۲۰۰ باشند، این فیلد چاپ نمی‌شود.
تعداد اتصالاتی که به درخواست‌های Keep-Alive منجر شده‌اند.
اگر ارسال داده به عنوان بخشی از آزمون پیکربندی شده باشد، این کل بایت‌های ارسال‌شده در طول آزمون است. اگر آزمون فاقد بدنه ارسالی باشد، این فیلد حذف می‌شود.
تعداد کل بایت‌های دریافتی از سرور. این عدد در واقع حجم بایت‌های ارسال‌شده روی شبکه است.
تعداد کل بایت‌های سند که از سرور دریافت شده‌اند. این عدد بایت‌های هدر HTTP را شامل نمی‌شود.
تعداد درخواست‌ها در هر ثانیه. این مقدار حاصل تقسیم تعداد درخواست‌ها بر کل زمان صرف‌شده است.
میانگین زمان صرف‌شده برای هر درخواست. مقدار اول با فرمول concurrency * timetaken * 1000 / done محاسبه می‌شود، در حالی که مقدار دوم با فرمول timetaken * 1000 / done محاسبه می‌گردد.
نرخ انتقال که با فرمول totalread / 1024 / timetaken محاسبه می‌شود.

بافرهای مختلفی با طول ثابت به صورت ایستا تعریف شده‌اند. همراهی این موضوع با تجزیه ساده‌لوحانه آرگومان‌های خط فرمان، هدرهای پاسخ سرور و سایر ورودی‌های خارجی ممکن است مشکل‌ساز شود.

این ابزار پروتکل HTTP/1.x را به‌طور کامل پیاده‌سازی نمی‌کند و فقط فرم‌های خاص و 'مورد انتظار' پاسخ‌ها را می‌پذیرد. استفاده نسبتاً زیاد از تابع strstr(3) در صدر پروفایل اجرایی دیده می‌شود که ممکن است نشان‌دهنده افت کارایی باشد؛ به این معنا که شما ممکن است به جای کارایی سرور، کارایی خود برنامه ab را اندازه‌گیری کنید.

2026-04-30 Apache HTTP Server