'\"macro stdmacro
.\"
.\" Copyright (c) 2026 Red Hat.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.TH PMDANIXL 1 "PCP" "Performance Co-Pilot" "General Commands Manual"
.SH "نام (NAME)"
pmdanixl \- عامل دامنه معیارهای کارایی NVIDIA NIXL
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/nixl/pmdanixl\f1
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdanixl
یک عامل دامنه معیارهای کارایی (PMDA) در Performance Co-Pilot (PCP) است که تله‌متری کارایی را از یک یا چند عامل
NIXL (NVIDIA Inference Xfer Library) در حال اجرا جمع‌آوری می‌کند.
.PP
عامل‌های NIXL تله‌متری رویدادها را در بافرهای حلقه‌ای حافظه اشتراکی واقع در دایرکتوری مشخص‌شده توسط متغیر محیطی
.B NIXL_TELEMETRY_DIR
(پیش‌فرض
.BR /var/tmp )
می‌نویسند.
این PMDA فایل‌های عامل را در آن دایرکتوری شناسایی کرده، رویدادهای جدید را در هر واکشی تخلیه نموده و آن‌ها را در شمارنده‌های جاری به ازای هر عامل تجمیع می‌کند.
هر عامل شناسایی‌شده به عنوان یک نمونه مجزا در دامنه نمونه‌های
.B nixl.agents
ظاهر می‌شود، بنابراین معیارهای عامل‌های مختلف می‌توانند به صورت مستقل پایش شوند.
.PP
معیارها در چهار گروه دسته‌بندی می‌شوند:
.TP
.B nixl.transfer.*
تعداد بایت‌ها و درخواست‌های انتقال داده (TX و RX).
.TP
.B nixl.memory.*
اندازه‌های ثبت و لغو ثبت حافظه.
.TP
.B nixl.performance.*
اندازه‌گیری‌های زمان انتقال تجمیع‌شده (به میکروثانیه).
.TP
.B nixl.errors.*
تعداد رویدادهای خطا، تفکیک‌شده بر اساس نوع خطا.
.SH "پیکربندی NIXL (NIXL CONFIGURATION)"
تله‌متری NIXL به‌طور پیش‌فرض غیرفعال است.
متغیرهای محیطی زیر باید در هر فرآیند برنامه NIXL پیش از ایجاد عامل آن تنظیم شوند تا داده‌های تله‌متری در حافظه اشتراکی نوشته شده و توسط این PMDA شناسایی گردند.
.TP
.B NIXL_TELEMETRY_ENABLE=1
جمع‌آوری تله‌متری را فعال می‌کند.
مقادیر پذیرفته‌شده عبارتند از
.BR 1 ،
.BR yes ،
.BR on ،
.BR true
یا
.B enable
(بدون حساسیت به حروف بزرگ و کوچک).
.TP
.B NIXL_TELEMETRY_DIR=\fIdir\fP
دایرکتوری‌ای که NIXL فایل‌های تله‌متری حافظه اشتراکی خود را در آن می‌نویسد؛ یک فایل برای هر عامل که بر اساس نام عامل ارائه‌شده در زمان ایجاد نام‌گذاری می‌شود.
این مقدار باید با تنظیم
.B telemetry_dir
در
.I $PCP_SYSCONF_DIR/nixl/nixl.conf
مطابقت داشته باشد.
پیش‌فرض
.BR /var/tmp
است.
.TP
.B NIXL_TELEMETRY_BUFFER_SIZE=\fIN\fP
تعداد رویدادهایی که بافر حلقه‌ای می‌تواند در خود نگه دارد پیش از آنکه رویدادهای قدیمی‌تر بدون هشدار بازنویسی شوند.
اگر برنامه جهش‌های تله‌متری را سریع‌تر از تخلیه آن‌ها توسط PMDA تولید می‌کند، این مقدار را افزایش دهید.
پیش‌فرض
.BR 4096
است.
.TP
.B NIXL_TELEMETRY_RUN_INTERVAL=\fIms\fP
بازه زمانی تخلیه (flush) به میلی‌ثانیه که توسط ریسه صادرکننده NIXL استفاده می‌شود.
پیش‌فرض
.BR 100
است.
.PP
پیکربندی حداقلی برای یک برنامه تکی به صورت زیر است:
.RS
.nf
export NIXL_TELEMETRY_ENABLE=1
export NIXL_TELEMETRY_DIR=/var/tmp
\&./my_nixl_application
.fi
.RE
.PP
در صورت نوشتن چندین برنامه در یک دایرکتوری یکسان، فایل هر عامل به‌طور خودکار شناسایی شده و به عنوان نمونه مستقل خود گزارش داده خواهد شد.
کاربر PMDA (که از طریق
.B user
در
.I nixl.conf
تنظیم می‌شود) باید با کاربری که برنامه‌های NIXL را اجرا می‌کند مطابقت داشته باشد تا دسترسی‌های فایل بدون نیاز به فایل‌های تله‌متری با قابلیت نوشتن همگانی (world-writable) همگام شوند.
.SH "نصب (INSTALLATION)"
پس از پیکربندی برنامه‌های NIXL برای برون‌ریزی تله‌متری، PMDA را نصب کنید:
.RS
.nf
# cd $PCP_PMDAS_DIR/nixl
# ./Install
.fi
.RE
اگر
.B NIXL_TELEMETRY_DIR
دایرکتوری پیش‌فرض
.BR /var/tmp
نیست، پیش از اجرای
.B Install
آن را در متغیرهای محیطی تنظیم کنید تا در پیکربندی راه‌اندازی PMDA ثبت شود.
.PP
برای بررسی در حال اجرا بودن PMDA و قابل مشاهده بودن نمونه‌ها:
.RS
.nf
$ pminfo -t nixl
$ pminfo -f nixl.transfer.tx_bytes
.fi
.RE
.SH "حذف (REMOVAL)"
.RS
.nf
# cd $PCP_PMDAS_DIR/nixl
# ./Remove
.fi
.RE
.SH "محیط (ENVIRONMENT)"
.TP
.B NIXL_TELEMETRY_DIR
تنظیم
.B telemetry_dir
از
.I nixl.conf
را در زمان اجرا لغو (override) می‌کند.
پیش‌فرض
.BR /var/tmp
است.
.SH "فایل‌ها (FILES)"
.TP
.I $PCP_SYSCONF_DIR/nixl/nixl.conf
فایل پیکربندی PMDA.
.TP
.I $PCP_PMDAS_DIR/nixl/Install
اسکریپت نصب.
.TP
.I $PCP_PMDAS_DIR/nixl/Remove
اسکریپت حذف.
.TP
.I $PCP_LOG_DIR/pmcd/nixl.log
فایل لاگ PMDA.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای مقداردهی نام فایل‌ها و دایرکتوری‌های مورداستفاده در PCP به کار می‌روند.
در هر نصب، فایل
.I /etc/pcp.conf
حاوی مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pminfo (1)،
.BR pmval (1)
و
.BR PMDA (3).