.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "fi_mon_sampler" "1" "2025\-06\-06" "Libfabric Programmer\[cq]s Manual" "Libfabric v2.6.0"
.hy
.SH "نام (NAME)"
.PP
fi_mon_sampler \- نمونه‌بردار ساده برای ارائه‌دهنده ofi_hook_monitor.
.SH "خلاصه دستور (SYNOPSIS)"
.IP
.nf
\f[C]
 fi_mon_sampler [OPTIONS] <target>      sample from file(s) at <target>
\f[R]
.fi
.SH "توضیحات (DESCRIPTION)"
.PP
داده‌ها را از طریق فایل‌های ارتباطی از ارائه‌دهنده ofi_hook_monitor استخراج می‌کند.
\f[V]<target>\f[R] می‌تواند یک فایل ارتباطی منفرد یا پوشه‌ای از فایل‌ها باشد.
داده‌ها بر اساس \f[V]-f <format>\f[R] صادر شده و یا در stdout چاپ می‌شوند (تنها برای فایل‌های تکی)، و یا به ازای هر فایل ارتباطی در مسیر \f[V]-o <outpath>\f[R] ذخیره می‌گردند.
نمونه‌بردار می‌تواند با استفاده از گزینهٔ \f[V]-w <msec>\f[R] تغییرات فایل‌های ارتباطی را زیر نظر بگیرد تا نمونه‌برداری تکرارشونده انجام شود.
.PP
قالب نام‌گذاری فایل‌های خروجی بر اساس ارائه‌دهنده ofi_hook_monitor بوده و به شرح زیر است:
\f[V]<ppid>_<pid>_<sequential id>_<job id>_<provider name>\f[R].
شناسه‌های \f[V]ppid\f[R] و \f[V]pid\f[R] از دیدگاه برنامهٔ تحت نظارت گرفته می‌شوند.
در یک محیط دسته‌ای (batched) در حال اجرای SLURM، مقدار \f[V]job id\f[R] برابر با شناسه کار در SLURM قرار می‌گیرد، در غیر این صورت روی 0 تنظیم می‌شود.
.SH "نحوه اجرا (HOW TO RUN)"
.PP
یک برنامه libfabric را با \f[V]FI_HOOK=monitor\f[R] اجرا کنید تا ارائه‌دهنده ofi_hook_monitor فعال شود.
تنظیمات ارائه‌دهنده مانیتور را بر اساس \f[V]fi_hook\f[R](7) تعیین کنید.
.PP
سپس نمونه‌بردار را از طریق
\f[V]fi_mon_sampler -o <output> <target>\f[R]
اجرا نمایید.
به‌طور پیش‌فرض، ارائه‌دهنده ofi_hook_monitor داده‌ها را در مسیر
\f[V]/dev/shm/ofi/<uid>/<hostname>\f[R]
ذخیره می‌کند.
.PP
نمونه‌بردار فایل‌های خروجی را در پوشهٔ مشخص‌شده در \f[V]<output>\f[R] ایجاد خواهد کرد؛ یک فایل به ازای هر ارائه‌دهندهٔ تحت نظارت.
.SH "گزینه‌ها (OPTIONS)"
.TP
\f[I]-w <msec>\f[R]
بررسی فایل‌ها برای تغییرات، بررسی در هر <msec> میلی‌ثانیه.
.TP
\f[I]-f <format>\f[R]
قالب خروجی.
در حال حاضر تنها از CSV پشتیبانی می‌کند.
.TP
\f[I]-o <outpath>\f[R]
مسیر فایل خروجی.
در صورت عدم تنظیم، از stdout استفاده می‌کند.
.SH "مثال‌ها (EXAMPLES)"
.PP
اجرای یک برنامه libfabric و فعال‌سازی ارائه‌دهنده ofi_hook_monitor:
.IP
.nf
\f[C]
FI_HOOK=monitor fi_pingpong [OPTIONS]
\f[R]
.fi
.PP
اجرای یک \f[V]fi_pingpong\f[R] دیگر با تنظیمات متناظر.
.PP
در نهایت، اجرای نمونه‌بردار:
.IP
.nf
\f[C]
fi_mon_sampler -o $HOME -w 1000 -f csv /dev/shm/ofi/$UID/$HOSTNAME
\f[R]
.fi
.SH "خروجی (OUTPUT)"
.PP
فایل‌های خروجی در پوشهٔ مشخص‌شده در \f[V]-o <output>\f[R] ایجاد خواهند شد.
.PP
در حالت \f[V]-f csv\f[R]، این پوشه شامل یک فایل CSV با داده‌های مربوط به تمام توابع تحت نظارت libfabric خواهد بود.
برای هر تابع، هر دو شمارندهٔ \f[V]count\f[R] و \f[V]sum\f[R] صادر می‌شوند که به ترتیب با پسوندهای نام ستون \f[V]_c\f[R] و \f[V]_s\f[R] مشخص شده‌اند.
علاوه بر این، هر تابع برای هر ردهٔ اندازه داده (data size bucket) نظارت می‌شود.
برای جزئیات بیشتر به \f[V]fi_hook\f[R](7) مراجعه کنید.
.PP
نمونه خروجی CSV، چهار ستون اول، سه سطر اول:
.IP
.nf
\f[C]
mon_recv_0_64_c,mon_recv_0_64_s,mon_recv_64_512_c,mon_recv_64_512_s
0,0,0,0
22529,0,0,0
113664,0,0,0
\f[R]
.fi
.SH "همچنین ببینید (SEE ALSO)"
.PP
\f[V]fi_hook\f[R](7)
.SH "نویسندگان (AUTHORS)"
OpenFabrics.