'\"macro stdmacro
.\"
.\" Copyright (c) 2016,2019 Red Hat.
.\" Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" 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 PMSTAT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-vmstat\f1,
\f3pmstat\f1 \- نمای کلی و سطح‌بالا از کارایی سیستم
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1 [\f2pcp\ options\f1] \f3vmstat\f1 [\f2interval\f1 [\f2samples\f1]]
.P
\f3pmstat\f1
[\f3\-gLlPVxz?\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-A\f1 \f2align\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-H\f1 \f2file\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
[\f3\-O\f1 \f2offset\f1]
[\f3\-p\f1 \f2port\f1]
[\f3\-s\f1 \f2samples\f1]
[\f3\-S\f1 \f2starttime\f1]
[\f3\-t\f1 \f2interval\f1]
[\f3\-T\f1 \f2endtime\f1]
[\f3\-Z\f1 \f2timezone\f1]
.sp
\f3pcp-vmstat\f1
\&...
.SH "توضیحات (DESCRIPTION)"
.de SAMPLE
.RS 2n
.nf
.nh
..
.de ESAMPLE
.hy
.fi
.RE
..
دستور
.B pmstat
در هر واحد زمانی
.I interval
(پیش‌فرض ۵ ثانیه است)، یک خلاصهٔ تک‌خطی از کارایی سیستم ارائه می‌دهد.
هدف
.B pmstat
پایش کارایی سیستم در بالاترین سطح است که پس از آن می‌توان از سایر ابزارها برای بررسی دقیق‌تر زیرسیستم‌هایی که در آن‌ها مشکلات احتمالی کارایی دیده می‌شود، استفاده کرد.
.P
دستور
.B pcp-vmstat
یک پوشش (wrapper) ساده برای استفاده به همراه دستور
.BR pcp (1)
است و برای برخی از کاربران ساختار خط فرمان آشناتری فراهم می‌کند.
این دستور همچنین گزینهٔ گزارش تفصیلی را به‌طور پیش‌فرض فعال می‌کند؛ گزینهٔ
.I \-x
را در ادامه ببینید.
.P
می‌توان چند میزبان را با مشخص کردن بیش از یک میزبان از طریق چندین پرچم
.B \-h
(برای پایش زنده)، یا با ارائهٔ نام فایل فهرست میزبان‌ها (که در آن هر خط شامل نام یک میزبان است) با
.BR \-H ،
یا چندین پرچم
.B \-a
(برای پایش گذشته‌نگر از مجموعه‌ای از بایگانی‌ها) پایش کرد.
.PP
به‌طور پیش‌فرض،
.B pmstat
معیارها را با اتصال به دیمن جمع‌آوری معیارهای کارایی (PMCD) روی میزبان محلی واکشی می‌کند.
اگر گزینهٔ
.B \-L
مشخص شده باشد،
.BR pmcd (1)
دور زده شده و معیارها از PMDAهای روی میزبان محلی با استفاده از حالت مستقل
.B PM_CONTEXT_LOCAL
از
.BR pmNewContext (3)
دریافت می‌شوند.
هنگامی که گزینهٔ
.B \-h
مشخص شود،
.B pmstat
به
.BR pmcd (1)
روی
.I host
متصل شده و معیارها را از آنجا دریافت می‌کند.
همان‌طور که در بالا ذکر شد، با مشخص کردن چندین پرچم
.B \-h
می‌توان چندین میزبان را پایش کرد.
.PP
همچنین، اگر از گزینهٔ
.B \-a
استفاده شود، معیارها از فایل‌های بایگانی Performance Co-Pilot مشخص‌شده توسط
.IR archive
بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌هاست که با کاما از هم جدا شده‌اند و هر یک می‌تواند نام پایهٔ یک بایگانی یا نام پوشه‌ای حاوی یک یا چند بایگانی باشد.
با ارائهٔ چندین پرچم
.B \-a
می‌توان چندین مجموعه بایگانی را بازپخش کرد.
هنگامی که پرچم
.B \-a
به‌کار رود،
پرچم
.B \-P
نیز می‌تواند برای توقف موقت خروجی پس از هر بازه استفاده شود.
.PP
حالت مستقل فقط می‌تواند به میزبان محلی متصل شود؛ استفاده از یک مجموعه بایگانی متضمن یک نام میزبان است؛ و تعیین یک میزبان مانع از استفاده از بایگانی می‌شود؛ بنابراین گزینه‌های
.BR \-L ،
.B \-a
و
.B \-h
مانعة‌الجمع هستند.
.PP
دستور
.B pmstat
می‌تواند کنترل زمان‌بندی خود را واگذار کرده و تحت کنترل یک فرایند
.BR pmtime (1)
که از یک کادر گفتگوی گرافیکی (GUI) برای کنترل زمان استفاده می‌کند، عمل نماید.
در این حالت، یا باید از گزینهٔ
.B \-g
برای اجرای
.B pmstat
به عنوان تنها کلاینتِ نمونهٔ جدیدی از
.BR pmtime (1)
استفاده شود، یا از
.B \-p
برای متصل کردن
.B pmstat
به یک نمونهٔ موجود از
.BR pmtime (1)
از طریق کانال IPC مشخص‌شده توسط آرگومان
.I port
استفاده گردد.
.PP
گزینه‌های
.BR \-S ،
.BR \-T ،
.BR \-O
و
.B \-A
می‌توانند برای تعریف یک پنجره زمانی جهت محدود کردن نمونه‌های بازیابی‌شده، تعیین یک مبدأ اولیه درون پنجره زمانی، یا مشخص کردن تراز «طبیعی» زمان نمونه‌ها استفاده شوند؛ برای شرح کامل این گزینه‌ها به
.BR PCPIntro (1)
مراجعه کنید..SH "گزینه‌ها (OPTIONS)"
گزینه‌های دردسترس خط فرمان عبارتند از:
.TP 5
\fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR
مقادیر سنجه‌های کارایی از مجموعه‌ای از فایل‌های بایگانی Performance Co-Pilot (PCP) که توسط آرگومان
.I archive
مشخص شده‌اند بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌های جداشده با کاما است که هر یک می‌تواند نام پایه یک بایگانی یا نام دایرکتوری حاوی یک یا چند بایگانی باشد.
.TP
\fB\-A\fR \fIalign\fR, \fB\-\-align\fR=\fIalign\fR
اجبار نمونه اولیه به تراز شدن روی مرز یک واحد زمانی طبیعی
.IR align .
برای شرح کامل ساختار نحوی
.IR align
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-g\fR, \fB\-\-guimode\fR
اجرای
.B pmstat
به‌عنوان کلاینت یک فرآیند سرور جدید
.BR pmtime (1)
برای بازپخش داده‌های کارایی بایگانی‌شده با استفاده از رابط گرافیکی کاربر
.BR pmtime (1) .
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
واکشی سنجه‌های کارایی از
.BR pmcd (1)
روی
.IR host ،
به‌جای localhost پیش‌فرض.
.TP
\fB\-H\fR \fIpath\fR, \fB\-\-hostsfile\fR=\fIpath\fR
تعیین
.I path
به فایلی حاوی مجموعه‌ای از نام‌های میزبان که
.BR pmcd (1)
روی آن‌ها در حال اجرا است، به‌جای استفاده از localhost پیش‌فرض.
.TP
\fB\-K\fR \fIspec\fR, \fB\-\-spec\-local\fR=\fIspec\fR
هنگام واکشی سنجه‌ها از یک بافت محلی (ببینید
.BR \-L )،
گزینه
.B \-K
می‌تواند برای کنترل DSO PMDAهایی که باید در دسترس قرار گیرند استفاده شود. آرگومان
.I spec
از ساختار نحوی شرح داده شده در
.BR pmSpecLocalPMDA (3)
پیروی می‌کند. می‌توان از بیش از یک گزینه
.B \-K
استفاده کرد.
.TP
\fB\-l\fR, \fI\-\-suffix\fR
چاپ ۷ نویسه آخر نام میزبان در خلاصه‌هایی که شامل بیش از یک میزبان هستند (زمانی که بیش از یک گزینه
.B \-h
روی خط فرمان مشخص شده باشد).
.TP
\fB\-L\fR, \fB\-\-local\-PMDA\fR
استفاده از یک بافت محلی برای جمع‌آوری سنجه‌ها از DSO PMDAها روی میزبان محلی بدون PMCD.
همچنین ببینید
.BR \-K .
.TP
\fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR
بارگذاری یک فضای نام سنجه‌های کارایی
.RB ( PMNS (5))
جایگزین از فایل
.IR pmnsfile .
.TP
\fB\-O\fR \fIorigin\fR, \fB\-\-origin\fR=\fIorigin\fR
هنگام گزارش سنجه‌های بایگانی‌شده، گزارش‌دهی را از
.I origin
درون پنجره زمانی آغاز می‌کند (ببینید
.B \-S
و
.BR \-T ).
برای شرح کامل ساختار نحوی
.IR origin
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-p\fR \fIport\fR, \fB\-\-guiport\fR=\fIport\fR
اتصال
.B pmstat
به یک نمونه فرآیند کنترل زمان موجود
.BR pmtime (1)
از طریق کانال IPC مشخص‌شده با آرگومان
\f2port\f1.
این گزینه معمولاً تنها توسط ابزارهای دیگر، مانند
.BR pmchart (1)،
هنگامی که
.B pmstat
را با کنترل زمان همگام‌سازی‌شده اجرا می‌کنند، استفاده می‌شود.
.TP
\fB\-P\fR, \fB\-\-pause\fR
مکث بین به‌روزرسانی‌ها برای بازپخش بایگانی.
.TP
\fB\-s\fR \fIsamples\fR, \fB\-\-samples\fR=\fIsamples\fR
گزینه
.I samples
تعداد نمونه‌هایی را که باید بازیابی و گزارش شوند تعیین می‌کند.
اگر
.I samples
برابر ۰ باشد یا
.B \-s
مشخص نشده باشد،
.B pmstat
به‌طور پیوسته نمونه‌برداری و گزارش خواهد کرد \- این رفتار پیش‌فرض است.
.TP
\fB\-S\fR \fIstarttime\fR, \fB\-\-start\fR=\fIstarttime\fR
هنگام گزارش سنجه‌های بایگانی‌شده، گزارش محدود به رکوردهایی خواهد بود که در زمان
.IR starttime
یا پس از آن ثبت شده‌اند.
برای شرح کامل ساختار نحوی
.IR starttime
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-t\fR \fIinterval\fR, \fB\-\-interval\fR=\fIinterval\fR
تنظیم
.I interval
گزارش‌دهی به مقداری غیر از ۵ ثانیه پیش‌فرض.
آرگومان
.I interval
از ساختار نحوی شرح داده شده در
.BR PCPIntro (1)
پیروی می‌کند و در ساده‌ترین شکل می‌تواند یک عدد صحیح بدون علامت باشد
(واحد ضمنی در این حالت ثانیه است).
.TP
\fB\-T\fR \fIendtime\fR, \fB\-\-finish\fR=\fIendtime\fR
هنگام گزارش سنجه‌های بایگانی‌شده، گزارش محدود به رکوردهایی خواهد بود که در زمان
.IR endtime
یا پیش از آن ثبت شده‌اند.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-x\fR, \fI\-\-xcpu\fR
گزینه سنجه‌های گسترش‌یافته CPU، باعث می‌شود سه سنجه اضافی پردازنده گزارش شوند، یعنی انتظار برای ورودی/خروجی ("wa")، زمان ربوده‌شده مجازی‌سازی ("st")، و زمان مهمان مجازی ("gu").
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
تغییر منطقه زمانی گزارش‌دهی به منطقه زمانی محلی میزبانی که منبع سنجه‌های کارایی است، همان‌طور که از طریق یکی از گزینه‌های
.B \-h
یا
.B \-a
مشخص شده است.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
به‌طور پیش‌فرض،
.B pmtime
زمان روز را بر اساس منطقه زمانی محلی در سیستمی که
.B pmstat
روی آن اجرا می‌شود گزارش می‌کند. گزینه
.B \-Z
منطقه زمانی را به
.I timezone
در قالب متغیر محیطی TZ همان‌طور که در
.BR environ (7)
شرح داده شده تغییر می‌دهد.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج..SH "خروجی (OUTPUT)"
خروجی حاصل از
.B pmstat
به خروجی استاندارد هدایت می‌شود و ستون‌های
موجود در گزارش به شرح زیر تفسیر می‌شوند:
.TP 10
.B loadavg
میانگین بار کاری
.IR "1 minute" .
.TP
.B memory
ستون \f3swpd\fP میانگین فضای swap مصرفی در طول بازه زمانی را به کیلوبایت نشان می‌دهد.
ستون \f3free\fP میانگین حافظه آزاد در طول بازه زمانی را به کیلوبایت نشان می‌دهد.
ستون \f3buff\fP میانگین حافظه بافر در حال استفاده در طول بازه زمانی را به کیلوبایت نشان می‌دهد.
ستون \f3cache\fP میانگین حافظه کش در حال استفاده در طول بازه زمانی را به کیلوبایت نشان می‌دهد.
.RS
.PP
اگر مقادیر بزرگ شوند، به‌صورت مگابایت
.BR "" " (پسوند " m ")"
یا گیگابایت
.BR "" " (پسوند " g ")"
گزارش می‌شوند.
.RE
.TP
.B swap
معیارهای این بخش از ابزارهای سنجش هسته (kernel instrumentation) ارزش تحلیلی متفاوتی دارند.
تلاش می‌شود میانگین تعداد \f3صفحاتی\fP که در هر ثانیه در طول بازه زمانی به حافظه وارد (\f3pi\fP) و از آن خارج (\f3po\fP) شده‌اند، گزارش شود.
اگر معیارهای متناظر مبادله صفحه (page swapping) در دسترس نباشند، میانگین نرخ \f3عملیات\fP مبادله ورودی (\f3si\fP) و خروجی (\f3so\fP) در ثانیه در طول بازه زمانی گزارش می‌شود.
غیرصفر بودن مقادیر «in» طبیعی است، اما اگر مقادیر «out» در یک بازه زمانی طولانی غیرصفر بمانند، سیستم دچار فشار حافظه (memory stress) است.
.RS
.PP
اگر مقادیر بزرگ شوند، به‌صورت هزاران عملیات در ثانیه
.BR "" " (پسوند " K ")"
یا میلیون‌ها عملیات در ثانیه
.BR "" " (پسوند " M ")"
گزارش می‌شوند.
.RE
.TP
.B io
ستون‌های \f3bi\fP و \f3bo\fP به ترتیب نشان‌دهنده میانگین نرخ عملیات ورودی و خروجی بلوک در ثانیه در طول بازه زمانی هستند.
مگر در حالتی که تمام سیستم‌های فایل دارای اندازه بلوک ۱ کیلوبایتی باشند، این نرخ‌ها مستقیماً بیانگر کیلوبایت‌های منتقل‌شده نیستند.
.RS
.PP
اگر مقادیر بزرگ شوند، به‌صورت هزاران عملیات در ثانیه
.BR "" " (پسوند " K ")"
یا میلیون‌ها عملیات در ثانیه
.BR "" " (پسوند " M ")"
گزارش می‌شوند.
.RE
.TP
.B system
نرخ وقفه (\f3in\fP) و نرخ تعویض زمینه (\f3cs\fP).
نرخ‌ها به‌صورت میانگین عملیات در ثانیه در طول بازه زمانی بیان می‌شوند.
توجه داشته باشید که نرخ وقفه معمولاً حداقل
.I HZ
(نرخ وقفه ساعت، معمولاً ۱۰۰)
وقفه در ثانیه است.
.RS
.PP
اگر مقادیر بزرگ شوند، به‌صورت هزاران عملیات در ثانیه
.BR "" " (پسوند " K ")"
یا میلیون‌ها عملیات در ثانیه
.BR "" " (پسوند " M ")"
گزارش می‌شوند.
.RE
.TP
.B cpu
درصد زمان پردازنده صرف‌شده برای اجرای کد کاربر و «nice user» (\f3us\fP)، کد سیستم و پردازش وقفه (\f3sy\fP)، و حلقه بی‌کاری (\f3id\fP).
.P
اگر مقداری برای هر یک از معیارهای کارایی مرتبط در دسترس نباشد، مقدار آن به‌صورت «?» در خروجی نمایش داده می‌شود..SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_VAR_DIR/pmns/*
فایل‌های مشخصات پیش‌فرض PMNS
.TP
.I $PCP_VAR_DIR/config/pmlogger/config.pmstat
پیکربندی
.BR pmlogger (1)
برای ایجاد یک آرشیو مناسب جهت بازپخش با
.B pmstat
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتربندی نام‌های فایل و دایرکتوری مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.PP
برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی پیام‌های تشخیصی بیشتری را در
.I stderr
برای کمک به عیب‌یابی و تریاژ مشکلات فعال می‌کند، هرچند این اطلاعات گاهی مبهم بوده و در وهله اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی.
.I debug
فهرستی جدا شده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmclient (1),
.BR pmtime (1),
.BR PMAPI (3),
.BR pmNewContext (3),
.BR pcp.conf (5),
.BR pcp.env (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ bi bo po si swpd sy wa loadavg {all are column headings}
.\" +ok+ vmstat {from pcp-vmstat} hostlist