'\"macro stdmacro
.\"
.\" Copyright (c) 2025 Oracle and/or its affiliates.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" 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 PMDAROCESTAT 1 "PCP" "Performance Co-Pilot" "General Commands Manual"
.SH "نام (NAME)"
\f3pmdarocestat\f1 \- عامل دامنه معیارهای کارایی (PMDA) برای دستگاه‌های RoCE
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/rocestat/pmdarocestat\f1
.SH "توضیحات (DESCRIPTION)"
عامل
.B Rocestat PMDA
(عامل دامنه معیارهای کارایی یا Performance Metrics Domain Agent) یک ماژول Performance Co-Pilot (PCP) است که آمار کارایی دستگاه‌های RDMA بر روی اترنت همگرا (RoCE) را جمع‌آوری و ارائه می‌کند. این ماژول بینش دقیقی نسبت به کارایی شبکه، شرایط خطا، و رویدادهای ازدحام فراهم کرده و به عیب‌یابی و پایش ارتباطات مبتنی بر RoCE کمک می‌کند.

این PMDA آمارهای تجمیع‌شدهٔ نرم‌افزاری درگاه InfiniBand، از جمله بایت‌ها و بسته‌های دریافتی/ارسالی، خطاهای پیوند (link errors)، و بسته‌های دور ریخته‌شده بر اثر ازدحام را گزارش می‌دهد و به شناسایی گلوگاه‌ها و خرابی‌های بالقوه کمک می‌رساند. علاوه بر این، این عامل شامل شمارنده‌های سطح سخت‌افزار است که معیارهای سطح پایین ارسال، درخواست‌های تکراری، NAKها، و خطاهای فیزیکی/محدودیت را ردگیری می‌کنند و دید عمیق‌تری نسبت به قابلیت اطمینان و بهره‌وری لایه انتقال زیرین ارائه می‌دهند.

افزون بر این، Rocestat PMDA معیارهای خطوط (lanes) مبتنی بر اولویت را از ethtool -S <interface> جمع‌آوری کرده و آمارهای مربوط به خطوط اولویت در ترافیک RoCE را فیلتر می‌کند. این معیارها دید مناسبی از توزیع ترافیک در بین خطوط فراهم کرده و به تشخیص نقاط داغ ازدحام و بهینه‌سازی توازن بار کاری بین خطوط مختلف کمک می‌کنند.

با ادغام Rocestat PMDA در یک محیط پایش PCP، کاربران می‌توانند به‌طور کارآمد رفتار شبکه RoCE را تحلیل کنند، ناهنجاری‌های کارایی را شناسایی نمایند، و بارهای کاری پرسرعت RDMA را در محیط‌های مرکز داده و HPC بهینه‌سازی کنند.

.SH "نصب (INSTALLATION)"
برای نصب Rocestat PMDA مراحل زیر را دنبال کنید:
.RS
.nf
# cd $PCP_PMDAS_DIR/rocestat
# ./Install
.fi
.RE

برای اطمینان از در حال اجرا بودن PMDA:
.RS
.nf
$ pminfo -t rocestat
.fi
.RE

.SH "نحوه استفاده (USAGE)"
برای پرس‌وجوی معیارهای Rocestat، از دستور زیر استفاده کنید:
.RS
.nf
$ pminfo rocestat
.fi
.RE
برای دریافت مقادیر معیارهای خاص:
.RS
.nf
$ pmval rocestat.hw.rcv.port_rcv_packets
.fi
.RE

.SH "فایل‌ها (FILES)"
.TP
.I $PCP_PMDAS_DIR/rocestat/Install
اسکریپت نصب برای Rocestat PMDA.
.TP
.I $PCP_PMDAS_DIR/rocestat/Remove
اسکریپت حذف نصب.
.TP
.I $PCP_LOG_DIR/pmcd/rocestat.log
فایل لاگ مربوط به رویدادها و خطاهای Rocestat PMDA.

.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند PCP_ برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf شامل مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pminfo (1)
و
.BR PMDA (3).