.TH biostacks.bt 8  "2019-07-12" "USER COMMANDS"
.SH "نام (NAME)"
biostacks.bt \- نمایش تاخیر ورودی/خروجی دیسک به همراه پشته‌های مقداردهی اولیه با استفاده از bpftrace/eBPF
.SH "خلاصه دستور (SYNOPSIS)"
.B biostacks
.SH "توضیحات (DESCRIPTION)"
این ابزار هیستوگرام‌های تاخیر ورودی/خروجی دیسک را برای هر مسیر مقداردهی اولیه ورودی/خروجی بلوکی (block I/O) نمایش می‌دهد. این می‌تواند به آشکار ساختن دلیل تاخیرهای گوناگون کمک کند، زیرا ممکن است برخی از آن‌ها ناشی از تخلیه لاگ‌ها (log flushing)، برخی دیگر ناشی از خواندن‌های برنامه کاربردی و غیره باشند.
.PP
این ابزار با اتصال به نقاط ردیابی block_io_start و block_rq_issue کار می‌کند.
.PP
از آنجا که این ابزار از BPF استفاده می‌کند، تنها کاربر ریشه (root) می‌تواند از آن استفاده کند.
.SH "پیش‌نیازها (REQUIREMENTS)"
CONFIG_BPF و bpftrace.
.SH "مثال‌ها (EXAMPLES)"
.TP
ردیابی تاخیر ورودی/خروجی دیسک همراه با پشته‌های مقداردهی اولیه:
#
.B biostacks.bt
.SH "فیلدها (FIELDS)"
.TP
0th
یک ردپای پشته هسته برای مقداردهی اولیه (که در "@[...]" نشان داده می‌شود) پیش از هر هیستوگرام ورودی/خروجی چاپ می‌شود.
.TP
1st, 2nd
این بازه‌ای از تاخیر ورودی/خروجی بر حسب میکروثانیه است (که در نماد مجموعه‌ای "[...)" نشان داده می‌شود).
.TP
3rd
ستونی که تعداد ورودی/خروجی را در این بازه نشان می‌دهد.
.TP
4th
این یک هیستوگرام اسکی (ASCII) است که ستون تعداد را نمایش می‌دهد.
.SH "بار پردازشی (OVERHEAD)"
نرخ اجرای biostacks باید پایین باشد (محدود به IOPS دستگاه)، به‌طوری که انتظار می‌رود بار پردازشی این ابزار ناچیز باشد.
.SH "منبع (SOURCE)"
این ابزار برگرفته از کتاب "BPF Performance Tools" منتشر شده توسط Addison Wesley (2019) است:
.IP
http://www.brendangregg.com/bpf-performance-tools-book.html
.PP
برای مستندات بیشتر درباره این ابزار به کتاب مراجعه کنید.
.PP
این نسخه در مخزن bpftrace قرار دارد:
.IP
https://github.com/bpftrace/bpftrace
.PP
همچنین در توزیع bpftrace به پرونده همراه _examples.txt که شامل نمونه نحوه استفاده، خروجی و توضیحات این ابزار است مراجعه کنید.
.SH "سیستم‌عامل (OS)"
Linux
.SH "پایداری (STABILITY)"
ناپایدار \- در حال توسعه.
.SH "نویسنده (AUTHOR)"
Brendan Gregg
.SH "همچنین ببینید (SEE ALSO)"
biosnoop.bt(8)