.TH xfsdist.bt 8 "2018-09-08" "دستورات مدیریت سیستم"
.SH "نام (NAME)"
xfsdist.bt \- خلاصه‌سازی زمان تاخیر عملیات‌های XFS با استفاده از bpftrace/eBPF.
.SH "خلاصه دستور (SYNOPSIS)"
.B xfsdist.bt
.SH "توضیحات (DESCRIPTION)"
این ابزار زمان (تاخیر) صرف‌شده در عملیات‌های معمول فایل در سامانه فایل XFS (شامل خواندن، نوشتن، باز کردن و همگام‌سازی) را خلاصه‌سازی کرده و آن را به‌صورت یک هیستوگرام بر مبنای توان‌هایی از ۲ نمایش می‌دهد. این ابزار برای دستیابی به کارایی بالا، از یک نگاشت eBPF درون هسته برای ذخیره‌سازی هیستوگرام استفاده می‌کند.
.PP
از آنجا که سازوکار این ابزار مبتنی بر ردیابی توابع رابط
.B xfs_file_operations
است، برای هماهنگی با هرگونه تغییری در این توابع نیاز به به‌روزرسانی خواهد داشت.
.PP
با توجه به اینکه این ابزار از BPF استفاده می‌کند، تنها کاربر ریشه (مدیر سیستم) می‌تواند آن را اجرا کند.
.SH "پیش‌نیازها (REQUIREMENTS)"
.B CONFIG_BPF
و
.BR bpftrace .
.SH "مثال‌ها (EXAMPLES)"
.TP
ردیابی زمان عملیات‌های XFS و نمایش خلاصه پس از فشردن Ctrl-C:
#
.B xfsdist.bt
.SH "فیلدها (FIELDS)"
.TP
0th
نام عملیات (که در قالب
.B "@[...]"
نمایش داده می‌شود) پیش از هر هیستوگرام ورودی/خروجی (I/O) چاپ می‌شود.
.TP
1st, 2nd
این بخش نشان‌دهنده بازه تاخیر بر حسب میکروثانیه است (که با نماد مجموعه‌ای
.B "[...)"
نمایش داده می‌شود).
.TP
3rd
ستونی که تعداد عملیات‌های انجام‌شده در این بازه را نشان می‌دهد.
.TP
4th
یک هیستوگرام به فرمت اسکی (ASCII) که نمایانگر ستون تعداد است.
.SH "سربار (OVERHEAD)"
این ابزار سربار اندکی به این عملیات‌های XFS اضافه می‌کند، از جمله برای خواندن‌ها و نوشتن‌ها از حافظه نهان (cache) سامانه فایل. بسته به بار کاری (به‌عنوان مثال، ۱ میلیون در ثانیه)، این‌گونه خواندن‌ها و نوشتن‌ها می‌توانند بسیار پرتکرار باشند، به طوری که در این وضعیت ممکن است سربار این ابزار محسوس شود.
پیش از استفاده در محیط‌های عملیاتی، آن را اندازه‌گیری و سنجش نمایید.
.SH "منبع (SOURCE)"
این ابزار بخشی از bpftrace است.
.IP
https://github.com/bpftrace/bpftrace
.PP
همچنین در توزیع bpftrace به فایل همراه
.I _examples.txt
مراجعه کنید که شامل مثال‌های کاربردی، خروجی‌ها و توضیحات مرتبط با این ابزار است.
.PP
این یک نسخه bpftrace از ابزار هم‌نام در bcc است. ابزار bcc ممکن است گزینه‌ها و امکانات سفارشی‌سازی بیشتری فراهم کند.
.IP
https://github.com/iovisor/bcc
.SH "سیستم‌عامل (OS)"
Linux
.SH "پایداری (STABILITY)"
ناپایدار \- در حال توسعه.
.SH "نویسنده (AUTHOR)"
Brendan Gregg
.SH "همچنین ببینید (SEE ALSO)"
.BR biolatency.bt (8)