'\"! tbl | mmdoc
'\"macro stdmacro
.\"
.\" Man page for pcp-nfsiostat
.\" Copyright (c) 2023 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 PCP-NFSIOSTAT 1 "PCP" "Performance Co-Pilot"

.SH "نام (NAME)"
pcp\-nfsiostat \- شبیه‌سازی iostat برای نقاط اتصال NFS با استفاده از /proc/self/mountstats

.SH "خلاصه دستور (SYNOPSIS)"
\fBpcp\fP [\fIگزینه‌های pcp\fP] \fBnfsiostat\fP [\fB\-a\fP \fIarchive\fP] [\fB\-S\fP \fIstart\fP] [\fB\-T\fP \fIfinish\fP] [\fB\-O\fP \fIorigin\fP] [\fB\-s\fP \fIsamples\fP] [\fB\-t\fP \fIinterval\fP] [\fB\-Z\fP \fItimezone\fP] [\fB\-h\fP \fIhost\fP] [\fB\-z\fP] [\fB\-V\fP]

.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-nfsiostat
آمار ورودی/خروجی (I/O) سمت کلاینت
.B Network File System (NFS)
را برای هر سیستم فایل متصل‌شده NFS گزارش می‌کند. برای هر نقطه اتصال NFS، خروجی شامل یک بخش خلاصه و در ادامه بلوک‌های آماری دقیق خواندن و نوشتن است. این آمارها مواردی مانند نرخ عملیات، توان عملیاتی داده، تاخیر، ارسال‌های مجدد، تاخیرهای صف و تعداد خطاها را در بر می‌گیرند. به‌طور پیش‌فرض،
.B pcp-nfsiostat
نقاط اتصال NFS را روی میزبان محلی پایش می‌کند و معیارهای زنده‌ای را که از طریق
.B PCP NFS PMDA
جمع‌آوری شده‌اند، یا در صورت تعیین، از میزبانی دیگر گزارش می‌دهد. هنگامی که یک بایگانی تعیین شود، معیارهای تاریخی به‌جای معیارهای زنده گزارش می‌شوند.

.SH "قالب خروجی (OUTPUT FORMAT)"
آمارها برای هر سیستم فایل متصل‌شده NFS با ساختار زیر گزارش می‌شوند:

.nf
server:/export mounted on /mount/point:

           ops/s       rpc bklog
           0.017           0.000

read:              ops/s   kB/s   kB/op   retrans   avg RTT (ms)   avg exe (ms)   avg queue (ms)   errors
                   ...

write:             ops/s   kB/s   kB/op   retrans   avg RTT (ms)   avg exe (ms)   avg queue (ms)   errors
                   ...
.fi

.SH "شرح فیلدها (FIELD DESCRIPTIONS)"
.TP
.B ops/s
تعداد عملیات‌های NFS انجام‌شده در هر ثانیه.

.TP
.B rpc bklog
میانگین تعداد درخواست‌های RPC در صف انتظار برای ارسال.

.TP
.B kB/s
کیلوبایت منتقل‌شده در هر ثانیه.

.TP
.B kB/op
میانگین تعداد کیلوبایت منتقل‌شده در هر عملیات.

.TP
.B retrans
تعداد ارسال‌های مجدد RPC و درصد ارسال مجدد.

.TP
.B avg RTT (ms)
میانگین زمان رفت‌وبرگشت (RTT) بر حسب میلی‌ثانیه برای درخواست‌های RPC.

.TP
.B avg exe (ms)
میانگین زمان اجرای درخواست‌ها روی سرور بر حسب میلی‌ثانیه.

.TP
.B avg queue (ms)
میانگین زمان انتظار در صف ارسال RPC بر حسب میلی‌ثانیه.

.TP
.B errors
تعداد عملیات‌های ناموفق و درصد شکست آن‌ها.

.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-a ", " \-\-archive " " \fIarchive\fR
دریافت آمار ورودی/خروجی NFS از بایگانی مشخص‌شده PCP.

.TP
.BR \-s ", " \-\-samples " " \fIsamples\fR
تعداد نمونه‌هایی که باید قبل از خروج جمع‌آوری شوند.

.TP
.BR \-t ", " \-\-interval " " \fIinterval\fR
تنظیم فاصله زمانی بین دو نمونه‌گیری. مقدار پیش‌فرض یک ثانیه است.

.TP
.BR \-S ", " \-\-start " " \fIstart\fR
تنظیم زمان شروع بازه زمانی هنگام بازپخش یک بایگانی.

.TP
.BR \-T ", " \-\-finish " " \fIfinish\fR
تنظیم زمان پایان بازه زمانی هنگام بازپخش یک بایگانی.

.TP
.BR \-O ", " \-\-origin " " \fIorigin\fR
تنظیم زمان نمونه‌گیری اولیه در بازه زمانی هنگام بازپخش یک بایگانی.

.TP
.BR \-h ", " \-\-host " " \fIhost\fR
دریافت آمار ورودی/خروجی NFS از میزبان مشخص‌شده.

.TP
.BR \-z ", " \-\-hostzone
تنظیم منطقه زمانی گزارش‌گیری به منطقه زمانی محلی منبع معیارها.

.TP
.BR \-Z ", " \-\-timezone " " \fItz\fR
تنظیم منطقه زمانی گزارش‌گیری.

.TP
.BR \-V ", " \-\-version
نمایش اطلاعات نسخه و خروج.

.TP
.BR \-? ", " \-\-help
نمایش راهنمای نحوه استفاده و خروج.

.SH "نکات (NOTES)"
دستور
.B pcp-nfsiostat
آمار NFS سمت کلاینت را که از هسته سیستم‌عامل جمع‌آوری شده و از طریق
PCP NFS PMDA
ارائه می‌شوند، گزارش می‌کند. قالب خروجی و معیارهای آن مشابه موارد گزارش‌شده توسط ابزار
.BR nfsiostat (1)
از بسته nfs-utils است.

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

.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pcp (1),
.BR nfsiostat (1),
.BR environ (7).