.TH runqlat.bt 8  "2018-09-17" "USER COMMANDS"
.SH "نام (NAME)"
runqlat.bt \- تاخیر صف اجرای پردازنده (CPU) را به صورت هیستوگرام نمایش میدهد
.SH "خلاصه دستور (SYNOPSIS)"
.B runqlat.bt
.SH "توضیحات (DESCRIPTION)"
این ابزار زمان صرف‌شده در انتظار در زمان‌بند پردازنده (CPU scheduler) برای نوبت اجرا روی پردازنده را ردگیری می‌کند. این معیار اغلب «تأخیر صف اجرا» (run queue latency) یا «تأخیر زمان‌بند» نامیده می‌شود. این ابزار این تأخیر را به صورت یک هیستوگرام توانی از ۲ بر حسب نانوثانیه نمایش می‌دهد، که امکان بررسی توزیع‌های چندوجهی و همچنین داده‌های پرت (outliers) تأخیر را فراهم می‌سازد.
.PP
این ابزار از نقاط ردگیری
.B sched
استفاده می‌کند.
.PP
از آنجا که این ابزار از
.B BPF
استفاده می‌کند، تنها کاربر ریشه (مدیر سیستم) می‌تواند از آن استفاده کند.
.SH "الزامات (REQUIREMENTS)"
.B CONFIG_BPF
و
.BR bpftrace .
.SH "مثال‌ها (EXAMPLES)"
.TP
ردگیری سراسری تأخیر صف اجرای پردازنده در کل سیستم، و چاپ هیستوگرام با فشردن کلیدهای Ctrl-C:
#
.B runqlat.bt
.SH "فیلدها (FIELDS)"
.TP
1st, 2nd
این بازه‌ای از میزان تأخیر بر حسب میکروثانیه است (که در نماد مجموعه‌ای به صورت \(dq[...)\(dq نشان داده می‌شود).
.TP
3rd
ستونی که تعداد رویدادهای زمان‌بند را در این بازه نشان می‌دهد.
.TP
4th
این یک هیستوگرام اسکی (ASCII) است که ستون تعداد را نمایش می‌دهد.
.SH "سربار (OVERHEAD)"
این ابزار توابع زمان‌بند را ردگیری می‌کند که ممکن است بسیار پرتکرار باشند. در حالی که
.B eBPF
دارای سربار بسیار کمی است و این ابزار برای کارایی بیشتر از نگاشت‌های درون هسته (in-kernel maps) بهره می‌برد، بسامد رویدادهای زمان‌بند برای برخی بارهای کاری ممکن است آن‌قدر بالا باشد که سربار این ابزار قابل توجه شود. پیش از استفاده، در یک محیط آزمایشگاهی میزان سربار را برای ارزیابی کمی اندازه بگیرید.
.SH "منبع (SOURCE)"
این ابزار برگرفته از
.B bpftrace
است.
.IP
https://github.com/bpftrace/bpftrace
.PP
همچنین در توزیع
.B bpftrace
به پرونده همراه
.B _examples.txt
که شامل نمونه‌های استفاده، خروجی و توضیحات این ابزار است مراجعه کنید.
.PP
این یک نسخه
.B bpftrace
از ابزار
.B bcc
با همین نام است. ابزار
.B bcc
ممکن است گزینه‌ها و قابلیت‌های سفارشی‌سازی بیشتری فراهم کند.
.IP
https://github.com/iovisor/bcc
.SH "سیستم‌عامل (OS)"
لینوکس (Linux)
.SH "پایداری (STABILITY)"
ناپایدار \- در حال توسعه.
.SH "نویسنده (AUTHOR)"
Brendan Gregg
.SH "همچنین ببینید (SEE ALSO)"
.BR runqlen.bt (8),
.BR mpstat (1),
.BR pidstat (1),
.BR uptime (1)