'\" t
.\"
.\" Copyright (C) 2015-2026 Marko Myllynen <myllynen@redhat.com>
.\" Copyright (c) 2016-2018 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 PMREP 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmrep\f1, \f3pcp2csv\f1 \- گزارش‌گر معیارهای کارایی
.SH "خلاصه دستور (SYNOPSIS)"
\fBpmrep\fP
[\fB\-12357CdgGHIjkLmnprRuUvVxz?\fP]
[\fB\-4\fP \fIaction\fP]
[\fB\-6\fP \fIsort-metric\fP]
[\fB\-8\fP|\fB\-9\fP \fIlimit\fP]
[\fB\-a\fP \fIarchive\fP]
[\fB\-A\fP \fIalign\fP]
[\fB\-\-archive\-folio\fP \fIfolio\fP]
[\fB\-b\fP|\fB\-B\fP \fIspace-scale\fP]
[\fB\-c\fP \fIconfig\fP]
[\fB\-\-container\fP \fIcontainer\fP]
[\fB\-\-csv\-unit\-info\fP]
[\f3\-D\f1 \f2debug\f1]
[\fB\-\-daemonize\fP]
[\fB\-e\fP \fIderived\fP]
[\fB\-E\fP \fIlines\fP]
[\fB\-f\fP \fIformat\fP]
[\fB\-F\fP \fIoutfile\fP]
[\fB\-h\fP \fIhost\fP]
[\fB\-i\fP \fIinstances\fP]
[\fB\-\-include\-texts\fP]
[\fB\-J\fP \fIrank\fP]
[\fB\-K\fP \fIspec\fP]
[\fB\-l\fP \fIdelimiter\fP]
[\fB\-N\fP \fIpredicate\fP]
[\fB\-\-no\-inst\-info\fP]
[\fB\-o\fP \fIoutput\fP]
[\fB\-O\fP \fIorigin\fP]
[\fB\-P\fP|\fB\-0\fP \fIprecision\fP]
[\fB\-q\fP|\fB\-Q\fP \fIcount-scale\fP]
[\fB\-s\fP \fIsamples\fP]
[\fB\-S\fP \fIstarttime\fP]
[\fB\-t\fP \fIinterval\fP]
[\fB\-T\fP \fIendtime\fP]
[\fB\-w\fP|\fB\-W\fP \fIwidth\fP]
[\fB\-X\fP \fIlabel\fP]
[\fB\-y\fP|\fB\-Y\fP \fItime-scale\fP]
[\fB\-Z\fP \fItimezone\fP]
\fImetricspec\fP
[...]
.SH "توضیحات (DESCRIPTION)"
.de EX
.in +0.5i
.ie t .ft CB
.el .ft B
.ie t .sp .5v
.el .sp
.ta \\w' 'u*8
.nf
..
.de EE
.fi
.ie t .sp .5v
.el .sp
.ft R
.in
..
دستور
.B pmrep
یک ابزار سفارشی‌پذیر برای گزارش معیارهای کارایی است.
هر معیار کارایی موجود، به‌صورت زنده یا بایگانی‌شده، سیستمی و/یا
برنامه‌ای، می‌تواند برای گزارش‌گیری با استفاده از یکی از گزینه‌های خروجی
ذکر شده در زیر به همراه تنظیمات قالب‌بندی مرتبط انتخاب شود.
.PP
دستور
.B pmrep
مقادیر معیارهای انتخاب‌شده را از طریق امکانات Performance Co-Pilot (PCP) جمع‌آوری می‌کند، ببینید
.BR PCPIntro (1).
معیارهایی که باید گزارش شوند در خط فرمان،
در فایل‌های پیکربندی یا در هر دو مشخص می‌شوند.
معیارها می‌توانند به‌طور خودکار با استفاده از امکانات PCP،
یا به صورت پیش‌فرض یا از طریق مشخصات مقیاس‌بندی به ازای هر معیار، تبدیل و مقیاس‌بندی شوند.
علاوه بر معیارهای موجود، معیارهای مشتق‌شده (derived metrics) را می‌توان با استفاده
از عبارت‌های حسابی شرح داده شده در
.BR pmRegisterDerived (3)
تعریف کرد.
.PP
مجموعهٔ گسترده‌ای از metricsetها (در ادامه ببینید) به طور پیش‌فرض گنجانده شده است که
گزارش‌هایی دربارهٔ جزئیات هر فرایند، کارایی NUMA، شبیه‌سازی ابزارهای دیگری مانند
.BR sar (1)
و موارد بیشتر ارائه می‌دهند؛ برای جزئیات به فایل‌های پیکربندی \fBpmrep\fP در
.I $PCP_SYSCONF_DIR/pmrep
(معمولاً \fI/etc/pcp/pmrep\fP) مراجعه کنید.
تکمیل خودکار با کلید Tab برای گزینه‌ها، معیارها، و metricsetها
برای bash و zsh در دسترس است.
.PP
مگر اینکه توسط گزینهٔ
.B \-h
به میزبان دیگری هدایت شود،
.B pmrep
با دیمن جمع‌آورندهٔ معیارهای کارایی (PMCD، ببینید
.BR pmcd (1))
روی میزبان محلی ارتباط برقرار خواهد کرد.
.PP
گزینهٔ
.B \-a
باعث می‌شود
.B pmrep
به جای اتصال به یک PMCD، از مجموعه بایگانی‌های مشخص‌شده استفاده کند.
گزینه‌های
.B \-a
و
.B \-h
مانعة‌الجمع (ناسازگار با یکدیگر) هستند.
.PP
گزینهٔ
.B \-L
باعث می‌شود
.B pmrep
از یک زمینهٔ (context) محلی برای جمع‌آوری معیارها از DSO PMDAها (عامل‌های دامنه معیارهای کارایی، «پلاگین‌ها»)
روی میزبان محلی بدون نیاز به PMCD استفاده کند.
تنها برخی از معیارها در این حالت در دسترس هستند.
گزینه‌های
.BR \-a ،
.B \-h
و
.B \-L
ناسازگار با یکدیگر هستند.
.PP
معیارهای مورد نظر در آرگومان(های)
.I metricspec
نام‌گذاری می‌شوند.
اگر یک metricspec گرهی غیربرگ را در فضای نام معیارهای کارایی (PMNS) مشخص کند،
.B pmrep
به صورت بازگشتی در PMNS پایین رفته و تمام گره‌های برگ
(یعنی معیارها) را برای آن metricspec گزارش می‌کند.
از
.BR pminfo (1)
برای فهرست کردن تمام معیارها (گره‌های برگ PMNS) و توضیحات آن‌ها استفاده کنید.
.PP
یک
.I metricspec
سه شکل مختلف دارد.
نخست، در خط فرمان می‌تواند با دو نقطه (``:'') شروع شود تا نشان‌دهندهٔ یک
.I metricset
باشد که باید از فایل‌های پیکربندی
.B pmrep
خوانده شود (ببینید
.B \-c
و
.BR pmrep.conf (5))،
که خود می‌تواند از هر تعداد معیار تشکیل شده باشد.
دوم، یک
.I metricspec
که با کاراکتری غیر از دونقطه شروع می‌شود، یک گره PMNS را طبق توضیحات بالا مشخص می‌کند
که می‌تواند به صورت اختیاری با تعاریف قالب‌بندی خروجی معیار دنبال شود.
این به اصطلاح
.I شکل فشرده
(compact form) یک metricspec به شرح زیر تعریف می‌شود:
.PP
.in 0.5i
.ft CR
.nf
metric[,label[,instances[,unit/scale[,type[,width[,precision[,limit]]]]]]]
.fi
.ft R
.in
.PP
یک گره معتبر PMNS
.RI ( metric )
اجباری است.
می‌تواند با یک
.I label
متنی دنبال شود که در خروجی
.I stdout
به کار می‌رود.
تعریف اختیاری
.I instances
گزارش‌گیری در
.I csv
و
.I stdout
را به نمونه‌های مشخص‌شده از معیار محدود می‌کند
تا نمونه‌های غیرمطابق فیلتر شوند (ببینید
.BR -i ).
یک
.I unit/scale
اختیاری برای معیارهای غیررشته‌ای و سازگار با بُعد قابل اعمال است.
برای مشخصات پشتیبانی‌شدهٔ
.I unit/scale
به ادامه مراجعه کنید.
به طور پیش‌فرض، معیارهای شمارندهٔ تجمعی به نرخ (rate) تبدیل می‌شوند؛ یک
.I type
اختیاری می‌تواند روی
.B raw
تنظیم شود تا این تبدیل نرخ غیرفعال شود.
برای خروجی
.IR stdout
می‌توان از یک
.I width
عددی برای تعیین عرض ستون خروجی برای این معیار استفاده کرد.
رشته‌های بسیار عریض در خروجی بریده می‌شوند تا درون ستون جا شوند.
می‌توان یک
.I precision
مختص معیار را برای مقادیر عددی غیرصحیح خروجی تعیین کرد.
در نهایت، می‌توان یک
.I limit
مختص معیار را برای فیلتر کردن مقادیر عددی بر اساس حد مجاز تنظیم نمود..PP
به عنوان یک حالت خاص برای معیارهایی که شمارنده‌هایی با واحدهای زمانی هستند
(نانوثانیه تا ساعت)، می‌توان از
.I unit/scale
برای تغییر گزارش‌دهی پیش‌فرض (برای نمونه،
میلی‌ثانیه / ثانیه) جهت نرمال‌سازی در بازه صفر تا یک
با تنظیم آن روی
.B sec
استفاده کرد (همچنین
.B \-y
و
.BR \-Y
را ببینید).
.PP
عبارت
.I metricspec
زیر درخواست می‌کند که معیار
.B kernel.all.sysfork
تحت برچسب متنی
.BR forks
گزارش شود، و با تبدیل به نرخ پیش‌فرض معیار یعنی count/s در ستونی با پهنای
.B 8
نمایش یابد.
اگرچه تعاریف در این
.I شکل فشرده
اختیاری هستند، اما همیشه باید به همان ترتیبی که در بالا مشخص شده ارائه شوند، از این رو از کاما استفاده شده است.
.PP
.in 1.5i
.ft CR
.nf
kernel.all.sysfork,forks,,,,8
.fi
.ft R
.in
.PP
شکل سوم یک metricspec، یعنی
.IR "verbose form" ،
تنها در
.BR pmrep.conf (5)
توصیف شده و معتبر است.
.PP
معیارهای اشتقاقی مانند معیارهای گره برگ معمولی PMNS مشخص می‌شوند.
.PP
گزینه‌های اعمال‌شده از طریق مقادیر محیطی (ببینید
.BR pmGetOptions (3))
بر مقادیر پیش‌فرض توکار متناظر (در صورت وجود) تقدم دارند.
گزینه‌های فایل پیکربندی بر متغیرهای محیطی متناظر (در صورت وجود) تقدم دارند.
گزینه‌های خط فرمان بر گزینه‌های فایل پیکربندی متناظر (در صورت وجود) تقدم دارند.
.PP
دستور
.B pcp2csv
یک نام مستعار برای
.BR pmrep
است.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود خط فرمان عبارتند از:
.TP 5
\fB\-0\fR \fIprecision\fR, \fB\-\-precision\-force\fR=\fIprecision\fR
مانند
.B \-P
است، اما این گزینه مشخصات اختصاصی هر معیار را بازنویسی \fIخواهد کرد\fP.
.TP
\fB\-1\fR, \fB\-\-dynamic\-header\fR
هر بار که تغییری در در دسترس بودن مقادیر معیار و نمونه رخ دهد، یک سرآیند جدید که به‌صورت پویا تنظیم شده چاپ می‌کند.
به‌طور پیش‌فرض یک سرآیند ایستا که هرگز تغییر نمی‌کند یک بار چاپ می‌شود.
همچنین ببینید
.BR \-4 ،
.BR \-7
و
.BR \-E .
.TP
\fB\-2\fR, \fB\-\-overall\-rank\fR
رتبه‌بندی کلی نمونه‌ها در آرشیو را انجام می‌دهد.
به‌طور پیش‌فرض رتبه‌بندی (ببینید
.BR \-J )
و گزارش‌دهی در هر بازه زمانی رخ می‌دهد.
با این گزینه، پیش از گزارش خلاصه، تمام نمونه‌ها و مقادیر رتبه‌بندی می‌شوند.
برای گزینه‌های بیشتر گزارش خلاصه آرشیو، از جمله میانگین‌ها و زمان‌های اوج مقادیر،
.BR pmlogsummary (1)
را ببینید.
.TP
\fB\-3\fR, \fB\-\-overall\-rank\-alt\fR
مانند
.B \-2
است، اما نمونه‌های معیار را در قالب \fImetricspec\fP مربوط به \fBpmrep\fP چاپ می‌کند تا امکان انتخاب آسان نمونه‌ها برای بررسی بیشتر فراهم شود.
.TP
\fB\-4\fR \fIaction\fR, \fB\-\-names\-change\fR=\fIaction\fR
مشخص می‌کند هنگام دریافت رویداد تغییر نام معیارها در حین نمونه‌برداری، چه
.I کنشی
انجام گیرد.
این رویدادها زمانی رخ می‌دهند که یک PMDA مدتی پس از راه‌اندازی، معیارهای جدیدی کشف کرده و به ابزارهای کلاینت در حال اجرا مانند
.BR pmrep
اطلاع دهد.
مقادیر معتبر برای
.I action
عبارتند از \fBupdate\fP (تازه‌سازی معیارهای در حال نمونه‌برداری)،
\fBignore\fP (کاری انجام نده \- رفتار پیش‌فرض)
و \fBabort\fP (خروج از برنامه در صورت وقوع چنین رویدادی).
\fIupdate\fP به معنای فعال بودن \fB\-\-dynamic\-header\fP است.
.TP
\fB\-5\fR, \fB\-\-ignore\-unknown\fR
معیاری که از
.B pmrep
خواسته شده گزارش کند ممکن است به دلایل متعددی «ناشناخته» (unknown) باشد:
معیار در PMNS منبع درخواستی معیارها وجود ندارد (\c
.BR pmcd (1)
برای معیارهای زنده از یک میزبان، یا یک آرشیو PCP برای معیارهای تاریخی)،
یا یک یا چند معیار عملوند در تعریف یک معیار اشتقاقی در دسترس نیست،
یا تعریف یک معیار اشتقاقی حاوی خطاهای نحوی است.
به‌طور پیش‌فرض، اگر
.B هر
یک از معیارهای درخواستی ناشناخته باشد،
.B pmrep
خطاها را گزارش داده و خارج می‌شود.
گزینه
.B \-5
رفتار پیش‌فرض را تغییر می‌دهد و
.B pmrep
هر معیاری را که ناشناخته باشد، به شرط آن‌که دست‌کم یک معیار شناخته‌شده برای گزارش باقی بماند، در سکوت نادیده می‌گیرد.
.RS
.PP
اگر یک معیار ناشناخته با تعریف یک معیار اشتقاقی مرتبط باشد، برای توضیح عمیق‌تر درباره معیارهای اشتقاقی و گزینه‌های موجود برای عیب‌یابی مشکلات مربوط به تعریف و ارزیابی آن‌ها، به
.BR pmRegisterDerivedMetric (3)
مراجعه کنید.
.RE
.TP
\fB\-6\fR, \fB\-\-sort\-metric\fR=\fIsort-metric\fR
یک معیار مرجع مرتب‌سازی را برای مرتب کردن خروجی بر اساس مقادیر با
.BR \-X
مشخص می‌کند.
به‌طور پیش‌فرض ترتیب مرتب‌سازی نزولی است؛ افزودن علامت منفی (``\-'') به ابتدای نام معیار، ترتیب را به صعودی تغییر می‌دهد.
همچنین ببینید
.BR \-J " و "
.BR \-N .
.TP
\fB\-7\fR, \fB\-\-fixed\-header\fR
همراه با \fB\-X\fP یک بار یک سرآیند ثابت (مگر در صورت استفاده از \fB\-E\fP) شامل همه معیارهای در حال گزارش چاپ می‌کند.
برخلاف سرآیند پیش‌فرض (ایستا)، تنها نمونه‌هایی که مقادیر آن‌ها در دسترس است گزارش می‌شوند.
برخلاف سرآیند پویا، حتی اگر مقادیر برخی معیارها بعداً (غیر)قابل‌دسترس شوند، سرآیند به‌روزرسانی نمی‌شود.
همچنین ببینید
.BR \-1 " و "
.BR \-E .
.TP
\fB\-8\fR \fIlimit\fR, \fB\-\-limit\-filter\fR=\fIlimit\fR
نتایج را به نمونه‌هایی با مقادیر بالاتر/پایین‌تر از
.IR limit
محدود می‌کند.
یک عدد صحیح مثبت، نمونه‌هایی با مقادیر در حد یا بالاتر از آن را در گزارش لحاظ می‌کند.
یک عدد صحیح منفی، نمونه‌هایی با مقادیر در حد یا پایین‌تر از آن را در گزارش لحاظ می‌کند.
مقدار صفر هیچ فیلترکردن حدی انجام نمی‌دهد.
این گزینه مشخصات احتمالی اختصاصی هر معیار را بازنویسی \fIنخواهد کرد\fP.
همچنین ببینید
.BR \-J " و "
.BR \-N .
.TP
\fB\-9\fR \fIlimit\fR, \fB\-\-limit\-filter\-force\fR=\fIlimit\fR
مانند
.B \-8
است، اما این گزینه مشخصات اختصاصی هر معیار را بازنویسی \fIخواهد کرد\fP.
.TP
\fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR
مقادیر معیارهای کارایی از مجموعه‌ای از فایل‌های آرشیو Performance Co-Pilot (PCP) که توسط آرگومان
.I archive
مشخص شده‌اند بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌های جداشده با کاما است که هر یک از آن‌ها می‌تواند نام پایه یک آرشیو یا نام دایرکتوری حاوی یک یا چند آرشیو باشد.
همچنین ببینید
.BR \-u .
.TP
\fB\-A\fR \fIalign\fR, \fB\-\-align\fR=\fIalign\fR
نمونه اولیه را وادار می‌کند تا بر مرز یک واحد زمانی طبیعی
.IR align
تراز شود.
برای توصیف کامل ساختار نحوی
.IR align
به
.BR PCPIntro (1)
مراجعه کنید..TP
\fB\-\-archive\-folio\fR=\fIfolio\fR
خواندن آرشیوهای منبع متریک از
.I folio
آرشیو PCP که توسط ابزارهایی مانند
.BR pmchart (1)
یا، در موارد کمتر، به صورت دستی با
.BR mkaf (1)
ایجاد شده است.
.TP
\fB\-b\fR \fIscale\fR, \fB\-\-space\-scale\fR=\fIscale\fR
.I واحد/مقیاس
برای متریک‌های فضا (بایت)؛ مقادیر ممکن شامل
.BR bytes ،
.BR Kbytes ،
.BR KB ،
.BR Mbytes ،
.BR MB
و غیره است.
این گزینه مشخصات احتمالی به ازای هر متریک را بازنویسی \fIنخواهد کرد\fP.
همچنین ببینید
.BR pmParseUnitsStr (3).
.TP
\fB\-B\fR \fIscale\fR, \fB\-\-space\-scale\-force\fR=\fIscale\fR
مانند
.B \-b
اما این گزینه مشخصات به ازای هر متریک را بازنویسی \fIخواهد کرد\fP.
.TP
\fB\-c\fR \fIconfig\fR, \fB\-\-config\fR=\fIconfig\fR
تعیین فایل یا دایرکتوری پیکربندی
.I config
مورد استفاده.
در صورتی که \fIconfig\fP یک دایرکتوری باشد، تمام فایل‌های درون آن که به
\fB.conf\fP
ختم می‌شوند گنجانده خواهند شد.
پیش‌فرض، نخستین مورد یافت‌شده از میان موارد زیر است:
.IR ./pmrep.conf ،
.IR $HOME/.pmrep.conf ،
.IR $HOME/pcp/pmrep.conf ،
.IR $PCP_SYSCONF_DIR/pmrep/pmrep.conf
و
.IR $PCP_SYSCONF_DIR/pmrep .
ببینید
.BR pmrep.conf (5).
.TP
\fB\-\-container\fR=\fIcontainer\fR
دریافت متریک‌های کارایی از
.IR container
مشخص‌شده، خواه محلی یا از راه دور (ببینید
.BR \-h ).
.TP
\fB\-\-csv\-unit\-info\fR
الحاق رشته‌های واحد به نام‌های متریک در سرآیند CSV با استفاده از قالب
.I "metric(unit)"
یا
.IR "metric[inst](unit)" .
همچنین ببینید
.BR \-k .
.TP
\fB\-C\fR, \fB\-\-check\fR
خروج پیش از گزارش هرگونه مقدار، اما پس از تجزیهٔ پیکربندی و متریک‌ها و چاپ سرآیندهای احتمالی.
.TP
\fB\-d\fR, \fB\-\-delay\fR
هنگام بازپخش از یک آرشیو، این گزینه درخواست می‌کند که تأخیر زمان‌واقعی حاکم میان نمونه‌ها اعمال شود (ببینید
.BR \-t )
تا وقفه‌ای اعمال گردد، به جای رفتار پیش‌فرض بازپخش با حداکثر سرعت.
.TP
.B \-\-daemonize
اجرا در پس‌زمینه (Daemonize) در زمان راه‌اندازی.
.TP
\fB\-e\fR \fIderived\fR, \fB\-\-derived\fR=\fIderived\fR
تعیین متریک‌های کارایی مشتق‌شده
.RI ( derived ).
اگر
.I derived
با یک اسلش (``/'') یا با یک نقطه (``.'') آغاز شود، به عنوان یک فایل پیکربندی متریک‌های مشتق‌شدهٔ PCP تفسیر خواهد شد؛ در غیر این صورت به عنوان عبارات متریک‌های مشتق‌شده که با کاما یا نقطه‌ویرگول از هم جدا شده‌اند تفسیر می‌شود.
برای شرح کامل متریک‌های مشتق‌شده و فایل‌های پیکربندی متریک‌های مشتق‌شدهٔ PCP ببینید
.BR pmLoadDerivedConfig (3)
و
.BR pmRegisterDerived (3).
همچنین، استفاده از نحو پیکربندی
.BR pmrep.conf (5)
امکان تعریف متریک‌های مشتق‌شده را به عنوان بخشی از مجموعه‌متریک‌ها (metricsets) فراهم می‌کند.
.RS
.PP
در صورت بروز مشکل در متریک‌های مشتق‌شده، صفحات راهنمای یادشده را با جزئیات بررسی کرده و مطمئن شوید که تمام متریک‌های مورد نیاز در دسترس هستند، به ویژه هنگام استفاده از آرشیوها.
از
.B \-Dderive
برای مشاهده اطلاعات اشکال‌زدایی بیشتر پیرامون تجزیه و ارزیابی متریک‌های مشتق‌شده استفاده کنید.
.RE
.TP
\fB\-E\fR \fIlines\fR, \fB\-\-repeat\-header\fR=\fIlines\fR
تکرار سرآیند پس از هر
.I lines
سطر از خروجی.
هنگامی که از \fB\-1\fR یا \fB\-7\fR استفاده نمی‌شود، از \fBauto\fR برای تکرار سرآیند بر اساس ارتفاع ترمینال استفاده کنید.
همچنین ببینید
.B \-1
و
.BR \-7 .
.TP
\fB\-f\fR \fIformat\fR, \fB\-\-timestamp\-format\fR=\fIformat\fR
استفاده از رشتهٔ
.I format
برای قالب‌بندی برچسب زمان.
این قالب با متد
.B datetime.strftime
پایتون استفاده خواهد شد که تا حد زیادی مشابه با مورد شرح‌داده‌شده در
.BR strftime (3)
است.
یک رشتهٔ
.I format
خالی (یعنی "") برچسب‌های زمان را از خروجی حذف خواهد کرد.
در صورت استفاده از مقصد خروجی
.IR stdout ،
پیش‌فرض
.B %H:%M:%S
است.
در صورت استفاده از مقصد خروجی
.IR csv ،
پیش‌فرض
.B "%Y-%m-%d %H:%M:%S"
است.
.TP
\fB\-F\fR \fIoutfile\fR, \fB\-\-output\-file\fR=\fIoutfile\fR
تعیین فایل خروجی
.IR outfile .
ببینید
.BR \-o .
.TP
\fB\-g\fR, \fB\-\-separate\-header\fR
خروجی دادن شماره ستون و اطلاعات کامل متریک، هر کدام در یک خط، پیش از چاپ مقادیر متریک.
.TP
\fB\-G\fR, \fB\-\-no\-globals\fR
عدم گنجاندن متریک‌های سراسری در گزارش‌دهی (ببینید
.BR pmrep.conf (5)).
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
دریافت متریک‌های کارایی از
.BR pmcd (1)
روی
.IR host ،
به جای پیش‌فرض localhost.
.TP
\fB\-H\fR, \fB\-\-no\-header\fR
هیچ سرآیندی چاپ نشود.
.TP
\fB\-i\fR \fIinstances\fR, \fB\-\-instances\fR=\fIinstances\fR
تنها نمونه‌های
.RI ( instances )
مشخص‌شده از متریک را بازیابی و گزارش می‌کند.
به‌طور پیش‌فرض، تمام نمونه‌های موجود در ابتدا گزارش می‌شوند، مگر هنگام نوشتن در یک آرشیو (ببینید
.BR \-o )
که در آن صورت تمام نمونه‌های آتی نیز گزارش خواهند شد.
.RS
.PP
نمونه‌های
.I instances
مشخص‌شده در هنگام راه‌اندازی ابزار، از میان نمونه‌های اولیهٔ موجود فیلتر می‌شوند.
بنابراین، نمونه‌هایی که با فیلتر مطابقت دارند اما پس از راه‌اندازی ابزار ظاهر می‌شوند گزارش نخواهند شد؛ از
.B \-j
برای تغییر این رفتار استفاده کنید.
.PP
این یک گزینهٔ سراسری است که برای تمام متریک‌های دارای مقادیر مجموعه‌ای (set-valued) استفاده می‌شود، مگر اینکه یک فیلتر نمونهٔ خاص برای متریک به عنوان بخشی از یک
.IR metricspec
ارائه شده باشد.
به‌طور پیش‌فرض، متریک‌های تک‌مقداری «مسطح» (flat) بدون نمونه کماکان طبق معمول گزارش می‌شوند؛ از
.B \-v
برای تغییر این رفتار استفاده کنید..PP
.I instances
فهرستی از یک یا چند مشخصهٔ پالایهٔ نمونه است که با کاما از یکدیگر جدا شده‌اند.
پالایه‌های حاوی کاما یا فاصله
باید درون نقل‌قول تکی (\(aq) یا جفت (\(dq) قرار گیرند.
توجه داشته باشید که به عنوان بخشی از یک
.I metricspec
در خط فرمان، در فهرستی با بیش از یک پالایه،
هم خود فهرست و هم هر پالایه باید مطابق آنچه در زیر نشان داده شده در نقل‌قول قرار گیرند.
همچنین می‌توان یک پالایهٔ منفرد را با خطوط عمودی (|)
به عنوان عبارت باقاعدهٔ جداساز نمونه تعریف کرد تا نقل‌قول‌گذاری آسان‌تر شود؛
در ادامه را ببینید.
.PP
استفاده از چندین گزینهٔ
.B \-i
به عنوان یک روش جایگزین برای مشخص کردن بیش از
یک پالایهٔ نمونهٔ غیرمختص به متریک مجاز است.
.PP
یک پالایهٔ نمونهٔ مجزا می‌تواند یکی از موارد زیر باشد:
.TP 10
.I name
نام کامل نمونه.
به عنوان مثال،
\fBsda\fP برای نمونه‌های \fIdisk.dev\fP یا
\fBeth0\fP برای نمونه‌های \fInetwork.interface\fP.
.TP
.I PID
شناسهٔ فرایند برای نمونه‌های \fIproc\fP.
.TP
.I command
نام پایهٔ یک فرایند برای نمونه‌های \fIproc\fP.
به عنوان مثال،
\fBpmcd\fP با تمام فرایندهای
.BR pmcd (1)
بدون در نظر گرفتن مسیر یا PID آن‌ها مطابقت خواهد داشت.
.TP
.I regex
عبارت باقاعده.
به عنوان مثال،
\fB.*python.*\fP با تمام نمونه‌هایی که رشتهٔ
\fBpython\fP را به عنوان بخشی از نام نمونهٔ خود دارند مطابقت دارد،
به این معنی که با تمام فرایندهای Python
صرف‌نظر از مسیر، PID یا نسخهٔ آن‌ها منطبق خواهد شد.
.PP
به عنوان مثال، دستورات زیر نمونه‌های یکسانی را گزارش می‌دهند:
.EX
$ pmrep \-i '. minute' kernel.all.load
$ pmrep \-i '1 minute','5 minute' kernel.all.load
$ pmrep \-i "'1 minute','5 minute'" kernel.all.load
$ pmrep \-i '1 minute' \-i '5 minute' kernel.all.load
$ pmrep kernel.all.load,,"'1 minute','5 minute'"
$ pmrep kernel.all.load,,'1 minute|5 minute'
.EE
.PP
با این حال، این دستور فقط نمونهٔ 1-minute را گزارش می‌کند:
.EX
$ pmrep \-i '1 minute','5 minute' kernel.all.load,,'1 minute'
.EE
.PP
و این مورد همهٔ نمونه‌ها را گزارش می‌دهد (به دلیل regex ویژهٔ هر متریک):
.EX
$ pmrep \-i '1 minute','5 minute' 'kernel.all.load,,.*'
.EE
.RE
.TP
\fB\-I\fR, \fB\-\-ignore\-incompat\fR
مشابه متریک‌های ناشناخته که در بالا برای گزینهٔ
.B \-5
توضیح داده شد، متریکی که از
.B pmrep
خواسته شده گزارش شود ممکن است به چند دلیل «ناسازگار» در نظر گرفته شود:
نوع متریکی که توسط
.B pmrep
پشتیبانی نمی‌شود (مانند PM_TYPE_AGGREGATE یا PM_TYPE_EVENT)،
یا تعریف یک متریک اشتقاقی که حاوی خطاهای معنایی است،
یا متریکی که در PMNS شناخته شده است اما متادادهٔ آن در دسترس نیست.
به‌طور پیش‌فرض، اگر
.B هر
متریک درخواست‌شده‌ای ناسازگار باشد،
.B pmrep
خطاها را گزارش کرده و خارج می‌شود.
گزینهٔ
.B \-I
رفتار پیش‌فرض را تغییر می‌دهد و
.B pmrep
هر متریک ناسازگار را به‌صورت خاموش نادیده می‌گیرد، به شرط آنکه
دست‌کم یک متریک سازگار برای گزارش دادن باقی بماند.
این گزینه به‌ویژه هنگام درخواست گره‌های غیربرگ درخت PMNS برای گزارش‌گیری در حالتی که
متریک‌های مرتبط متاداده‌های متفاوتی دارند مفید است.
.TP
\fB\-\-include\-texts\fR
هنگام نوشتن یک بایگانی PCP،
متن‌های راهنمای متریک PCP را در بایگانی ایجادشده می‌گنجاند.
.TP
\fB\-j\fR, \fB\-\-live\-filter\fR
پالایش زندهٔ نمونه‌ها را انجام می‌دهد.
این کار امکان ثبت تمام نمونه‌های نام‌گذاری‌شده را فراهم می‌کند حتی اگر فرایندها
در مقطعی مجدداً راه‌اندازی شوند (برخلاف حالت بدون پالایش زنده).
انجام پالایش زنده روی تعداد بسیار زیادی از نمونه‌ها مقداری سربار داخلی ایجاد خواهد کرد،
بنابراین احتیاط کاربر توصیه می‌شود.
همچنین ببینید
.BR \-1 " و "
.BR \-n .
.TP
\fB\-J\fR \fIrank\fR, \fB\-\-rank\fR=\fIrank\fR
نتایج را به بالاترین/پایین‌ترین نمونه‌های
.IR rank \-شدهٔ
متریک‌های چندمقداری (set-valued) محدود می‌کند.
یک عدد صحیح مثبت نمونه‌های با بالاترین مقدار را در گزارش لحاظ می‌کند.
یک عدد صحیح منفی نمونه‌های با پایین‌ترین مقدار را در گزارش لحاظ می‌کند.
مقدار صفر هیچ رتبه‌بندی‌ای انجام نمی‌دهد.
رتبه‌بندی به معنای مرتب‌سازی نیست، ببینید
.BR \-6 .
همچنین ببینید
.BR \-2
و
.BR \-8 .
.TP
\fB\-k\fR, \fB\-\-extended\-csv\fR
خروجی CSV گسترش‌یافته، مشابه با
.BR sadf (1)
می‌نویسد.
همچنین ببینید
.BR \-\-csv\-unit\-info .
.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 \fIdelimiter\fR, \fB\-\-delimiter\fR=\fIdelimiter\fR
جداکننده‌ای (\c
.IR delimiter )
را تعیین می‌کند که هر ستون از خروجی
.I csv
یا
.I stdout
را جدا می‌سازد.
پیش‌فرض برای
.I stdout
دو فاصله (\(lq  \(rq) و برای
.I csv
کاما (\(lq,\(rq) است.
هنگام استفاده از جداکننده‌ای غیر از فاصله،
تمام نمونه‌های آن جداکننده در مقادیر رشته‌ای با
نویسهٔ خط زیرین (\(lq_\(rq) جایگزین خواهند شد.
توجه داشته باشید که بسیاری از مجموعه‌متریک‌های پیش‌فرض یک جداکننده مشخص می‌کنند (که ممکن است
کاما نباشد)، بنابراین شاید لازم باشد از این گزینه به همراه مجموعه‌متریک‌ها استفاده شود تا صراحتاً
جداکننده برای خروجی CSV روی کاما تنظیم گردد، یعنی \c
.B \-\-delimiter=,
.TP
\fB\-L\fR, \fB\-\-local\-PMDA\fR
از یک بافت محلی برای جمع‌آوری متریک‌ها از DSO PMDAها روی میزبان محلی
بدون PMCD استفاده می‌کند.
همچنین ببینید
.BR \-K .
.TP
\fB\-m\fR, \fB\-\-include\-labels\fR
برچسب‌های متریک PCP را در خروجی می‌گنجاند.
.TP
\fB\-n\fR, \fB\-\-invert\-filter\fR
رتبه‌بندی را قبل از پالایش زنده انجام می‌دهد.
به‌طور پیش‌فرض، پالایش زندهٔ نمونه‌ها (در صورت درخواست، ببینید
.BR \-j )
قبل از رتبه‌بندی نمونه‌ها (در صورت درخواست، ببینید
.BR \-J )
انجام می‌شود.
با این گزینه، منطق معکوس شده و رتبه‌بندی قبل از
پالایش زنده رخ می‌دهد.
.TP
\fB\-N\fR \fIpredicate\fR, \fB\-\-predicate\fR=\fIpredicate\fR
فهرستی جداشده با کاما از متریک‌های مرجع پالایهٔ
.I predicate
را مشخص می‌کند.
به‌طور پیش‌فرض، رتبه‌بندی (ببینید
.BR \-J )
برای هر متریک به صورت جداگانه صورت می‌گیرد.
با گزاره‌ها (predicates)، رتبه‌بندی تنها برای
متریک‌های گزارهٔ مشخص‌شده انجام می‌شود.
هنگام گزارش‌گیری، باقی متریک‌هایی که دامنهٔ نمونهٔ (\c
.IR "instance domain" )
یکسانی با گزاره دارند (ببینید
.BR PCPIntro (1))
تنها شامل نمونه‌هایی از گزارهٔ متناظر خواهند بود که بالاترین/پایین‌ترین رتبه را کسب کرده‌اند.
رتبه‌بندی به معنای مرتب‌سازی نیست، ببینید
.BR \-6 .
.RS.PP
بنابراین برای نمونه، استفاده از \fBproc.memory.rss\fP
(اندازه حافظه مقیم فرایند)
به‌عنوان متریک
.I predicate
همراه با \fBproc.io.total_bytes\fP و \fBmem.util.used\fP به‌عنوان
متریک‌هایی برای گزارش، هنگام گزارش مجموع بایت‌های نوشته‌شده توسط فرایندها، تنها فرایندهایی که از بیشترین/کمترین (مطابق با
.BR \-J )
حافظه استفاده می‌کنند گنجانده خواهند شد.
از آنجا که \fBmem.util.used\fP یک متریک تک‌مقداری است (و در نتیجه دامنه نمونه یکسانی با متریک‌های مرتبط با فرایند ندارد)،
طبق معمول گزارش خواهد شد.
.RE
.TP
\fB\-\-no\-inst\-info\fR
حذف اطلاعات نمونه (instance) از سرآیندها.
در صورت استفاده از سرآیند جداگانه قابل اعمال نیست (نگاه کنید به \fB\-g\fR).
.TP
\fB\-o\fR \fIoutput\fR, \fB\-\-output\fR=\fIoutput\fR
استفاده از مقصد
.I output
برای گزارش‌دهی.
مقصد پیش‌فرض
.IR stdout
است.
گزینه‌های در دسترس برای مقصد خروجی عبارتند از:
.RS
.TP 2
.I archive
ضبط متریک‌ها درون یک بایگانی PCP که بعداً می‌تواند با ابزارهای PCP، از جمله خود
.B pmrep
بازپخش شود.
برای جزئیات درباره فایل‌های بایگانی PCP نگاه کنید به
.BR LOGARCHIVE (5)
و
.BR PCPIntro (1) .
نیازمند
.BR \-F
است.
.TP
.I csv
چاپ متریک‌ها در قالب CSV (تابع گزینه‌های قالب‌بندی).
.TP
.I stdout
چاپ متریک‌ها در stdout (قالب آن تابع گزینه‌های قالب‌بندی است).
.RE
.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, \fB\-\-timestamps\fR
چاپ برچسب‌های زمانی.
به‌طور پیش‌فرض هیچ برچسب زمانی چاپ نمی‌شود.
.TP
\fB\-P\fR \fIprecision\fR, \fB\-\-precision\fR=\fIprecision\fR
استفاده از
.I precision
برای مقادیر عددی غیر صحیح در خروجی.
اگر مقدار برای عرض ستون خود بیش از حد عریض باشد،
.I precision
یکی یکی کاهش می‌یابد تا زمانی که مقدار جا شود،
یا در صورتی که جا نشود اصلاً چاپ نخواهد شد.
پیش‌فرض استفاده از ۳ رقم اعشار است (در صورت امکان).
این گزینه مشخصات احتمالی اختصاصی هر متریک را بازنویسی \fIنخواهد کرد\fP.
.TP
\fB\-q\fR \fIscale\fR, \fB\-\-count\-scale\fR=\fIscale\fR
.I واحد/مقیاس
برای متریک‌های شمارشی؛ مقادیر ممکن شامل
.BR "count x 10^\-1" ,
.BR "count" ,
.BR "count x 10" ,
.BR "count x 10^2" ,
و به همین ترتیب از
.B 10^\-8
تا
.BR 10^7
است.
.\" https://bugzilla.redhat.com/show_bug.cgi?id=1264124
(این مقادیر در حال حاضر به فاصله حساس هستند.)
این گزینه مشخصات احتمالی اختصاصی هر متریک را بازنویسی \fIنخواهد کرد\fP.
همچنین نگاه کنید به
.BR pmParseUnitsStr (3).
.TP
\fB\-Q\fR \fIscale\fR, \fB\-\-count\-scale\-force\fR=\fIscale\fR
مشابه
.B \-q
اما این گزینه مشخصات اختصاصی هر متریک را بازنویسی \fIخواهد کرد\fP.
.TP
\fB\-r\fR, \fB\-\-raw\fR
خروجی دادن مقادیر خام متریک‌ها، شمارنده‌های تجمعی به نرخ تبدیل نمی‌شوند.
هنگام نوشتن بایگانی‌ها، همواره از مقادیر خام استفاده می‌شود.
این گزینه مشخصات احتمالی اختصاصی هر متریک را بازنویسی \fIخواهد کرد\fP.
.TP
\fB\-R\fR, \fB\-\-raw\-prefer\fR
مشابه
.B \-r
اما این گزینه مشخصات اختصاصی هر متریک را بازنویسی \fIنخواهد کرد\fP.
.TP
\fB\-s\fR \fIsamples\fR, \fB\-\-samples\fR=\fIsamples\fR
آرگومان
.I samples
تعداد نمونه‌هایی را که باید دریافت و گزارش شوند تعریف می‌کند.
اگر
.I samples
برابر 0 باشد یا
.B \-s
مشخص نشده باشد،
.B pmrep
به‌طور پیوسته (در حالت بلادرنگ) یا تا انتهای مجموعه بایگانی‌های PCP (در حالت بایگانی) نمونه‌برداری و گزارش‌دهی خواهد کرد.
همچنین نگاه کنید به
.BR \-T .
.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)
پیروی می‌کند، و در ساده‌ترین شکل می‌تواند یک عدد صحیح بدون علامت باشد
(واحد ضمنی در این حالت ثانیه است).
همچنین نگاه کنید به گزینه‌های
.B \-T
و
.BR \-u .
.TP
\fB\-T\fR \fIendtime\fR, \fB\-\-finish\fR=\fIendtime\fR
هنگام گزارش متریک‌های بایگانی‌شده، گزارش محدود به رکوردهایی خواهد بود که قبل از
.IR endtime
یا در همان زمان ثبت شده باشند.
برای شرح کامل ساختار دستوری
.IR endtime
به
.BR PCPIntro (1)
مراجعه کنید.
.RS
.PP
هنگامی که برای تعیین مدت زمان اجرا پیش از خروج \fBpmrep\fP استفاده می‌شود،
اگر هیچ \fIsamples\fP داده نشده باشد (نگاه کنید به \fB\-s\fP)، تعداد
نمونه‌های گزارش‌شده به \fIinterval\fP بستگی خواهد داشت (نگاه کنید به \fB\-t\fP).
اگر
.I samples
داده شده باشد، آنگاه
.I interval
تنظیم خواهد شد تا امکان گزارش‌دهیِ
.I samples
در طول زمان اجرا فراهم شود.
در صورتی که هر سه گزینهٔ
.BR \-T ,
.BR \-s ,
و
.B \-t
داده شده باشند،
.I endtime
زمان واقعی اجرای
.B pmrep
را تعیین می‌کند.
.RE
.TP
\fB\-u\fR, \fB\-\-no\-interpol\fR
هنگام گزارش متریک‌های بایگانی‌شده، به‌طور پیش‌فرض مقادیر بر اساس بازه نمونه‌برداری انتخاب‌شده (گزینهٔ \c
.B \-t
) گزارش می‌شوند، نه بر اساس بازه زمانی واقعی رکوردها در یک بایگانی.
بدین منظور، PCP مقادیر مورد گزارش را بر اساس رکوردهای بایگانی درونیابی می‌کند.
با گزینهٔ
.B \-u
گزارش‌دهی درونیابی‌نشده فعال می‌شود، هر مقدار ثبت‌شده برای متریک‌های انتخاب‌شده گزارش می‌گردد و بازه نمونه‌برداری درخواستی (\c
.BR \-t )
نادیده گرفته می‌شود.
.RS.PP
بنابراین برای مثال، اگر یک بایگانی PCP حاوی مقادیر ثبت‌شده برای هر ۱۰
ثانیه باشد و بازه نمونه‌برداری درخواستی ۱ ساعت باشد، به‌طور پیش‌فرض
.B pmrep
از یک طرح درون‌یابی برای محاسبه مقادیر معیارهای درخواستی از روی مقادیر
ثبت‌شده در مجاورت این معیارهای درخواستی استفاده می‌کند و مقادیر برای هر ۱ ساعت
گزارش می‌شوند.
با
.B \-u
هر رکورد در هر ۱۰ ثانیه به همان صورت گزارش داده می‌شود (مقادیر گزارش‌شده
همچنان مشمول تبدیل نرخ هستند؛ برای غیرفعال کردن از
.B \-r
یا
.B \-R
استفاده کنید).
.RE
.TP
\fB\-U\fR, \fB\-\-no\-unit\-info\fR
حذف اطلاعات یکا از سرآیندهای \fIstdout\fP.
.TP
\fB\-v\fR, \fB\-\-omit\-flat\fR
تنها گزارش معیارهای مجموعه‌مقدار دارای نمونه (مانند disk.dev.read) و
صرف‌نظر کردن از معیارهای تک‌مقداری «تخت» فاقد نمونه (مانند
kernel.all.sysfork).
ببینید:
.B \-i
و
.BR \-I .
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-w\fR \fIwidth\fR, \fB\-\-width\fR=\fIwidth\fR
تنظیم
.I width
(عرض) ستون خروجی
.IR stdout .
رشته‌ها تا این عرض بریده خواهند شد.
مقدار
.I width
پیش‌فرض، کوتاه‌ترین مقداری است که برچسب متنی معیار در آن جا می‌شود؛ حداقل مقدار اجباری ۳ است.
این گزینه مشخصات احتمالی مربوط به هر معیار را بازنویسی \fIنخواهد کرد\fP.
.TP
\fB\-W\fR \fIwidth\fR, \fB\-\-width\-force\fR=\fIwidth\fR
مانند
.B \-w
اما این گزینه مشخصات مربوط به هر معیار را بازنویسی \fIخواهد کرد\fP.
.TP
\fB\-x\fR, \fB\-\-extended\-header\fR
چاپ سرآیند گسترش‌یافته.
.TP
\fB\-X\fR \fIlabel\fR, \fB\-\-colxrow\fR=\fIlabel\fR
جابه‌جایی ستون‌ها و سطرها در خروجی \fIstdout\fP، گزارش یک نمونه در هر
سطر، با استفاده از \fIlabel\fP به‌عنوان برچسب متنی ستون نمونه‌ها.
برای فعال کردن جابه‌جایی بدون یک برچسب ستون مشخص، از یک رشته خالی ("") استفاده کنید.
این تغییر در خروجی امکان استفاده از
.BR grep (1)
را برای فیلتر کردن نتایج یا شبیه‌سازی نزدیک‌تر ابزارهای دیگر فراهم می‌کند.
همچنین ببینید:
.BR \-i " و "
.BR \-6 .
.TP
\fB\-y\fR \fIscale\fR, \fB\-\-time\-scale\fR=\fIscale\fR
.I یکا/مقیاس
برای معیارهای زمانی؛ مقادیر ممکن شامل
.BR nanosec ،
.BR ns ،
.BR microsec ،
.BR us ،
.BR millisec ،
.BR ms
و به همین ترتیب تا
.BR hour ،
.BR hr .
این گزینه مشخصات احتمالی مربوط به هر معیار را بازنویسی \fIنخواهد کرد\fP.
همچنین ببینید:
.BR pmParseUnitsStr (3).
.TP
\fB\-Y\fR \fIscale\fR, \fB\-\-time\-scale\-force\fR=\fIscale\fR
مانند
.B \-y
اما این گزینه مشخصات مربوط به هر معیار را بازنویسی \fIخواهد کرد\fP.
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
استفاده از منطقه زمانی محلی میزبانی که منبع معیارهای کارایی است،
همان‌طور که توسط گزینه‌های
.B \-h
یا
.B \-a
مشخص شده است.
حالت پیش‌فرض، استفاده از منطقه زمانی میزبان محلی است.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
استفاده از
.I timezone
برای تاریخ و زمان.
.I Timezone
در قالب متغیر محیطی
.B TZ
است، همان‌گونه که در
.BR environ (7)
شرح داده شده است.
توجه داشته باشید که هنگام گنجاندن رشته منطقه زمانی در خروجی، آفست‌های UTC به سبک ISO 8601
استفاده می‌شوند (بنابراین موردی مانند \-Z EST+5 به UTC-5 تبدیل خواهد شد).
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج..SH "مثال‌ها (EXAMPLES)"
مثال‌های زیر از امکانات استاندارد PCP برای جمع‌آوری مقادیر متریک‌ها استفاده می‌کنند و نیازی به ابزارهای بیرونی نیست.
مجموعه‌متریک‌های (.IR metricsets )
ارجاع‌شده که با دو‌نقطه آغاز می‌شوند، بخشی از پیکربندی پیش‌فرض \fBpmrep\fR هستند.
در bash و zsh، کلید Tab گزینه‌های موجود، متریک‌ها و پس از دونقطه مجموعه‌متریک‌ها را به‌طور خودکار تکمیل می‌کند.
.PP
نمایش متریک‌های رابط شبکه در میزبان محلی:
.RS +4
.ft B
.nf
$ pmrep network.interface.total.bytes
.fi
.ft P
.RE
.PP
نمایش تمامی متریک‌های خروجی شبکه برای رابط
.IR wlan0 :
.RS +4
.ft B
.nf
$ pmrep \-i wlan0 \-v network.interface.out
.fi
.ft P
.RE
.PP
نمایش مجموع مصرف slab (به مگابایت) برای دو نمونهٔ slab مشخص:
.RS +4
.ft B
.nf
$ pmrep mem.slabinfo.slabs.total_size,,'kmalloc\-4k|xfs_inode',MB
.fi
.ft P
.RE
.PP
نمایش اطلاعات دارای برچسب زمان، شبیه به
.BR vmstat (8)
با استفاده از مگابایت به جای کیلوبایت، به همراه تعداد inodeهای استفاده‌شده:
.RS +4
.ft B
.nf
$ pmrep \-p \-B MB :vmstat vfs.inodes.count
.fi
.ft P
.RE
.PP
نمایش خواندن و نوشتن دیسک به‌ازای هر دستگاه از میزبان
.I server1
با بازه زمانی دو ثانیه و با قالب خروجی CSV مشابه با
.BR sadf (1):
.RS +4
.ft B
.nf
$ pmrep \-h server1 \-t 2s \-o csv \-k disk.dev.read disk.dev.write
.fi
.ft P
.RE
.PP
نمایش فرایندهایی با حداقل ۱۰۰ مگابایت مصرف حافظه با استفاده از
سرآیندهای پویا، علاوه بر این استفاده از
.B \-g
جهت نمایش نام کامل نمونه‌ها (فرایندها):
.RS +4
.ft B
.nf
$ pmrep \-b MB \-\-limit\-filter 100 \-\-dynamic\-header proc.memory.rss
.fi
.ft P
.RE
.PP
نمایش مجموعه‌متریک از‌پیش‌تعریف‌شده از
.BR pmrep.conf (5)
پیش‌فرض حاوی جزئیات مربوط به درخواست‌های I/O توسط فرایند(های) جاری
.IR pmlogger :
.RS +4
.ft B
.nf
$ pmrep \-gp \-i pmlogger :proc\-io
.fi
.ft P
.RE
.PP
نمایش سه فرایندی که بیشترین مصرف CPU را دارند:
.RS +4
.ft B
.nf
$ pmrep \-1gUJ 3 proc.hog.cpu
.fi
.ft P
.RE
.PP
نمایش هم‌زمان اطلاعاتی شبیه به
.B sar \-w
و
.B sar \-W
از آرشیو PCP در مسیر
.I ./20150921.09.13
که مقادیر ثبت‌شده بین ساعات ۱۵ تا ۱۷ را نشان می‌دهد:
.RS +4
.ft B
.nf
$ pmrep \-a ./20150921.09.13 \-S @15:00 \-T @17:00 :sar\-w :sar\-W
.fi
.ft P
.RE
.PP
ضبط مرتبط‌ترین اطلاعات مربوط به CPU، حافظه و I/O برای
تمامی فرایندهای جاوا روی سامانه (فعلی و آینده) در آرشیو
.I ./a
با فواصل زمانی یک‌دقیقه‌ای در رأس هر دقیقه در یک فرایند پس‌زمینه:
.RS +4
.ft B
.nf
$ pmrep \-\-daemonize \-A 1m \-t 1m \-i '.*java.*' \-j \-o archive \-F ./a \\
    :proc\-info :proc\-cpu :proc\-mem :proc\-io
.fi
.ft P
.RE
.PP
ضبط تمامی متریک‌های 389 Directory Server، سیستم‌فایل XFS، و CPU/حافظه/دیسک
هر پنج ثانیه یک‌بار به مدت پنج دقیقه در آرشیو PCP در
.IR ./a :
.RS +1
.ft B
.nf
$ pmrep \-t 5s \-T 5m \-o archive \-F ./a ds389 xfs kernel.all.cpu mem disk
.fi
.ft P
.RE
.PP
ضبط اطلاعات حافظه و I/O برای سه فرایندی
که بیشترین مصرف حافظه را دارند:
.RS +1
.ft B
.nf
$ pmrep \-o archive \-F ./a \-J 3 \-N proc.memory.rss proc.memory proc.io
.fi
.ft P
.RE.SH "فایل‌ها (FILES)"
.TP 5
.I pmrep.conf
فایل پیکربندی \fBpmrep\fP (رجوع کنید به \fB\-c\fP)
.TP
.I \f(CR$PCP_SYSCONF_DIR\fP/pmrep/*.conf
فایل‌های پیکربندی پیش‌فرض \fBpmrep\fP ارائه‌شده توسط سیستم
.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) مراجعه کنید.
.PP
به‌طور ویژه،
.B PCP_DISCRETE_ONCE
می‌تواند تنظیم شود تا اطمینان حاصل شود مقادیر معیارهای گسسته تنها یک بار گزارش می‌شوند، مگر اینکه در زمانی تغییر کنند.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینهٔ
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی‌های اضافی را روی
.I stderr
فعال می‌کند تا به بررسی و ارزیابی مشکلات کمک کند، هرچند که اطلاعات گاهی مبهم بوده و در درجهٔ اول برای راهنمایی توسعه‌دهندگان به‌جای کاربران نهایی در نظر گرفته شده است.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینهٔ
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی ویژهٔ
.B pmrep
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl1	T{
.ad l
تخلیهٔ کلیدواژه‌ها برای پیکربندی‌ها و مشخصات
T}
_
derive	T{
.ad l
تخلیهٔ جزئیات هنگام تجزیهٔ هر معیار مشتق‌شده
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR mkaf (1),
.BR pcp (1),
.BR pcp2elasticsearch (1),
.BR pcp2graphite (1),
.BR pcp2influxdb (1),
.BR pcp2json (1),
.BR pcp2spark (1),
.BR pcp2xlsx (1),
.BR pcp2xml (1),
.BR pcp2zabbix (1),
.BR pcp\-atop (1),
.BR pmcd (1),
.BR pmchart (1),
.BR pmdiff (1),
.BR pmdumptext (1),
.BR pminfo (1),
.BR pmiostat (1),
.BR pmlogdump (1),
.BR pmlogextract (1),
.BR pmlogsummary (1),
.BR pmprobe (1),
.BR pmstat (1),
.BR pmval (1),
.BR sadf (1),
.BR sar (1),
.BR PMAPI (3),
.BR pmGetOptions (3),
.BR pmLoadDerivedConfig (3),
.BR pmParseUnitsStr (3),
.BR pmRegisterDerived (3),
.BR pmSpecLocalPMDA (3),
.BR strftime (3),
.BR LOGARCHIVE (5),
.BR PMNS (5),
.BR pcp.conf (5),
.BR pmrep.conf (5),
.BR environ (7)
و
.BR vmstat (8).

.\" control lines for scripts/man-spell
.\" +ok+ CdgGHIjkLmnprRuUvVxz EST NUMA XFS csv datetime
.\" +ok+ eth incompat influxdb inodes java
.\" +ok+ kmalloc metricset metricsets sda slabinfo
.\" +ok+ total_bytes total_size vfs vmstat wlan
.\" +ok+ xfs xfs_inode zsh
.\" +ok+ ds {from ds389} gp gUJ {all from command line -xxx args}
.\" +ok+ sp {from .sp in troff macro} un {from (un)available)}
.\" +ok+ Dderive {from -Dderive}
.\" +ok+ PCP_DISCRETE_ONCE {from pmrep-only env var}