.TH biolatency.bt 8  "2018-09-13" "USER COMMANDS"
.SH "نام (NAME)"
biolatency.bt \- تاخیر ورودی/خروجی بلوکی به صورت یک هیستوگرام. استفاده از bpftrace/eBPF.
.SH "خلاصه دستور (SYNOPSIS)"
.B biolatency.bt
.SH "توضیحات (DESCRIPTION)"
این ابزار زمان (تاخیر) سپری‌شده در ورودی/خروجی دستگاه بلوکی (ورودی/خروجی دیسک) را به صورت یک هیستوگرام توانی از ۲ خلاصه‌سازی می‌کند. این کار امکان بررسی توزیع، از جمله مُدها و داده‌های پرت (outliers) را فراهم می‌سازد. اغلب دو مُد وجود دارد، یکی برای اصابت به حافظه موقت (cache hits) دستگاه و دیگری برای عدم اصابت (cache misses)، که می‌توانند توسط این ابزار نشان داده شوند. داده‌های پرت تاخیر نیز نشان داده خواهند شد.
.PP
ابزار اصلی، که با نام \(dqbiolatency-kp.bt\(dq نگهداری می‌شود، در حال حاضر با ردیابی پویای توابع هسته
.BR blk_account*()
کار می‌کند، که برای تطابق با هرگونه تغییر در این توابع در نسخه‌های آینده هسته نیازمند به‌روزرسانی خواهد بود.
.PP
نسخه به‌روزشده این ابزار به جای kprobes از نقاط ردیابی (tracepoints) استفاده می‌کند تا بتواند با طیف گسترده‌ای از نسخه‌های هسته سازگار باشد.
.PP
از آنجا که این ابزار از BPF استفاده می‌کند، تنها کاربر ریشه (root) می‌تواند از آن استفاده کند.
.SH "پیش‌نیازها (REQUIREMENTS)"
CONFIG_BPF و bpftrace.
.SH "مثال‌ها (EXAMPLES)"
.TP
ردیابی ورودی/خروجی دستگاه بلوکی (ورودی/خروجی دیسک) و چاپ هیستوگرام تاخیر با زدن Ctrl-C:
#
.B biolatency.bt
.SH "فیلدها (FIELDS)"
.TP
1st, 2nd
این بازه‌ای از تاخیر بر حسب میکروثانیه است (که در نماد مجموعه‌ای \(dq[...)\(dq نشان داده می‌شود).
.TP
3rd
ستونی که تعداد عملیات‌ها را در این بازه نشان می‌دهد.
.TP
4th
این یک هیستوگرام اسکی (ASCII) است که ستون تعداد را نمایش می‌دهد.
.SH "بار پردازشی (OVERHEAD)"
از آنجا که ورودی/خروجی دستگاه بلوکی معمولاً بسامد نسبتاً پایینی دارد (کمتر از ۱۰٬۰۰۰ در ثانیه)، انتظار می‌رود بار پردازشی این ابزار ناچیز باشد. برای سامانه‌های ذخیره‌سازی با IOPS بالا، پیش از استفاده آزمایش و ارزیابی کمّی انجام دهید.
.SH "منبع (SOURCE)"
این ابزار برگرفته از bpftrace است.
.IP
https://github.com/bpftrace/bpftrace
.PP
همچنین در توزیع bpftrace به پرونده همراه _examples.txt که شامل نمونه نحوه استفاده، خروجی و توضیحات این ابزار است مراجعه کنید.
.PP
این یک نسخه bpftrace از ابزار bcc با همین نام است. ابزار bcc ممکن است گزینه‌ها و قابلیت‌های سفارشی‌سازی بیشتری ارائه دهد.
.IP
https://github.com/iovisor/bcc
.SH "سیستم‌عامل (OS)"
Linux
.SH "پایداری (STABILITY)"
ناپایدار \- در حال توسعه.
.SH "نویسنده (AUTHOR)"
Brendan Gregg
.SH "همچنین ببینید (SEE ALSO)"
biosnoop.bt(8)