'\"macro stdmacro
.\"
.\" Copyright (C) 2015-2026 Marko Myllynen <myllynen@redhat.com>
.\"
.\" 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.CONF 5 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmrep.conf \- فایل پیکربندی pmrep
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmrep
ابزاری قابل سفارشی‌سازی برای گزارش‌گیری معیارهای عملکرد (کارایی) است.
هر معیار عملکرد موجود، زنده یا بایگانی‌شده، مربوط به سیستم و/یا
برنامه، می‌تواند برای گزارش‌گیری با استفاده از یکی از گزینه‌های خروجی موجود
به همراه گزینه‌های قالب‌بندی قابل اعمال انتخاب شود.
.PP
معیارهای مورد نظر در آرگومان(های)
.I metricspec
در خط فرمان
.B pmrep
نام برده می‌شوند.
این metricspecها معیارهای منفرد یا مجموعه‌معیارهای (metricsets) از پیش تعریف‌شده عملکرد را
مشخص می‌کنند که باید از فایل‌های پیکربندی شرح‌داده‌شده در زیر خوانده شوند.
برای جزئیات آرگومان‌های خط فرمان به
.BR pmrep (1)
مراجعه کنید.
.PP
فایل پیکربندی
.B pmrep.conf
امکان تنظیم مقادیر پیش‌فرض زمان اجرا و تعریف هر تعداد
.I metricsets
سفارشی را برای
.B pmrep
فراهم می‌کند.
یک metricset یک مجموعه دلخواه تعریف‌شده توسط کاربر از معیارهای کارایی است.
این به کاربران اجازه می‌دهد مجموعه‌معیارهای سفارشی بسازند که به‌طور خاص
مربوط به برنامه یا محیط کاری آنها است.
به جای وابستگی به آنچه ابزارهای موجود ارائه می‌دهند یا جمع‌آوری داده‌های
مورد نیاز با چندین ابزار جداگانه، کاربران می‌توانند مجموعه‌معیارهای سفارشی را
صرفاً با ویرایش
.B pmrep.conf
تعریف کنند.
برای مشخصات \fImetricset\fP به ادامه متن مراجعه کنید.
.PP
در صورتی که فایل‌های پیکربندی \fBpmrep\fP از یک دایرکتوری خوانده شوند،
مقادیر بخش‌های \fB[options]\fP و \fB[global]\fP از هر فایلی که در آن تعریف شده باشند
ترکیب خواهند شد.
آخرین تعریف یک دستورالعمل اولویت دارد،
به این معنی که در صورت تعریف چندباره، آخرین تعریف استفاده خواهد شد.
با این حال، بخش‌های سفارشی \fImetricset\fP ترکیب نخواهند شد،
و تنها آخرین تعریف یافت‌شده برای گزارش‌گیری استفاده خواهد شد.
.PP
گزینه‌های اعمال‌شده از طریق متغیرهای محیطی (به
.BR pmGetOptions (3)
مراجعه کنید) مقادیر پیش‌فرض داخلی متناظر (در صورت وجود) را بازنویسی می‌کنند.
گزینه‌های فایل پیکربندی، متغیرهای محیطی متناظر (در صورت وجود) را لغو و بازنویسی می‌کنند.
گزینه‌های خط فرمان، گزینه‌های متناظر فایل پیکربندی (در صورت وجود) را لغو و بازنویسی می‌کنند.
.SH "قالب فایل (FILE FORMAT)"
این فایل دارای نحو مشابه ini است و از بخش‌ها (sections) و تنظیمات (settings) تشکیل شده است.
یک بخش با نام بخش درون براکت آغاز می‌شود و تا شروع بخش بعدی ادامه می‌یابد.
یک بخش نمونه با دو تنظیم در ادامه آمده است:
.sp 1
.RS 4
.nf
[\fIsection\fP]
\fIkey\fP = \fIvalue\fP
\fIkey2\fP = \fIvalue2\fP
.fi
.RE
.PP
انواع داده‌های پشتیبانی‌شده برای مقادیر شامل رشته (string)، عدد صحیح (integer) و بولی (boolean) هستند.
مقادیر نباید درون علامت نقل‌قول (کوتیشن) قرار گیرند، مگر زمانی که مقدار صرفاً از
فاصله خالی (whitespace) تشکیل شده باشد (برای نمونه، جداکننده ستونی که تنها فاصله خالی است).
.PP
توضیحات درون‌خطی (کامنت) با علامت هش (``#'') یا نقطه-ویرگول (``;'') آغاز می‌شوند.
توضیحات در انتهای خطوط (Inline comments) پشتیبانی نمی‌شوند.
.PP
فایل
.B pmrep.conf
باید توسط کاربری که
.B pmrep
را اجرا می‌کند قابل خواندن باشد.
.PP
هر گزینه‌ای که در زیر با یک گزینه خط فرمان متناظر شرح داده شده است، توضیحات عملکردی تکمیلی در
.BR pmrep (1)
دارد.
.SH "بخش‌های ویژه (SPECIAL SECTIONS)"
.SS "بخش [options]"
بخش
.B [options]
هر بار که
.B pmrep
اجرا می‌شود خوانده شده و گزینه‌های پیش‌فرض زمان اجرا را تعریف می‌کند.
این گزینه‌ها ممکن است توسط گزینه‌های خاص metricspec یا گزینه‌های خط فرمان
بازنویسی شوند.
تعریف معیارها در این بخش مجاز نیست.
.PP
\fBتنظیمات مجاز\fP
.PP
version (integer)
.RS 4
نسخه فایل پیکربندی را نشان می‌دهد.
مقدار پیش‌فرض \fB1\fP است.
تنها مقدار پشتیبانی‌شده فعلی \fB1\fP است.
.RE
.PP
source (string)
.RS 4
منبع معیارها را مشخص می‌کند.
اگر مقدار حاوی اسلش (``/'') باشد به عنوان یک بایگانی PCP تفسیر می‌شود.
اگر روی نویسه ویژه ``@'' تنظیم شود، از بافتار محلی DSO PMDA استفاده می‌شود.
در غیر این صورت به عنوان نام میزبان (hostname) تفسیر می‌شود.
پارامترهای خط فرمان متناظر \fB\-a\fP، \fB\-h\fP
و \fB\-L\fP هستند.
مقدار پیش‌فرض \fBlocal:\fP است (به
.BR PCPIntro (1)
مراجعه کنید).
.RE
.PP
output (string)
.RS 4
مقصد خروجی را مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-o\fP است.
برای مقاصد خروجی پشتیبانی‌شده، به
.BR pmrep (1)
مراجعه کنید.
مقدار پیش‌فرض \fBstdout\fP است.
.RE
.PP
speclocal (string)
.RS 4
واحدهای DSO PMDA محلی را مشخص می‌کند که هنگام استفاده از بافتار DSO PMDA محلی
باید در دسترس باشند.
گزینه خط فرمان متناظر \fB\-K\fP است.
برای شرح نحو، به
.BR pmSpecLocalPMDA (3)
مراجعه کنید.
برای جداسازی بیش از یک \fIspec\fP از نقطه-ویرگول (``;'') استفاده کنید.
به طور پیش‌فرض تعریف‌نشده است.
.RE
.PP
derived (string)
.RS 4
مشخصات معیارهای اشتقاقی (derived metrics).
گزینه خط فرمان متناظر \fB\-e\fP است.
برای شرح نحو، به
.BR pmrep (1)
مراجعه کنید.
به طور پیش‌فرض تعریف‌نشده است.
.RE
.PP
daemonize (boolean)
.RS 4
مشخص می‌کند که آیا در زمان راه‌اندازی به صورت دیمن اجرا شود یا خیر.
گزینه خط فرمان متناظر \fB\-\-daemonize\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
header (boolean)
.RS 4
مشخص می‌کند که آیا هدرها چاپ شوند یا خیر.
گزینه خط فرمان متناظر \fB\-H\fP است.
مقدار پیش‌فرض \fByes\fP است.
.RE
.PP
instinfo (boolean)
.RS 4
مشخص می‌کند که آیا اطلاعات نمونه (instance) به عنوان بخشی از هدرها گنجانده شود یا خیر.
گزینه خط فرمان متناظر \fB\-\-no\-inst\-info\fP است.
مقدار پیش‌فرض \fByes\fP است.
.RE
.PP
unitinfo (boolean)
.RS 4
مشخص می‌کند که آیا اطلاعات واحد سنجش به عنوان بخشی از هدرهای stdout گنجانده شود یا خیر.
گزینه خط فرمان متناظر \fB\-U\fP است.
مقدار پیش‌فرض \fByes\fP است.
.RE
.PP
csv_unitinfo (boolean)
.RS 4
مشخص می‌کند که آیا اطلاعات واحد سنجش به عنوان بخشی از هدرهای CSV گنجانده شود یا خیر.
گزینه خط فرمان متناظر \fB\-\-csv\-unit\-info\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
globals (boolean)
.RS 4
مشخص می‌کند که آیا معیارهای بخش \fB[global]\fP
(به زیر مراجعه کنید) برای گزارش‌گیری گنجانده شوند یا خیر.
گزینه خط فرمان متناظر \fB\-G\fP است.
مقدار پیش‌فرض \fByes\fP است.
.RE
.PP
timestamp (boolean)
.RS 4
مشخص می‌کند که آیا برچسب زمان (timestamp) چاپ شود یا خیر.
گزینه خط فرمان متناظر \fB\-p\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
samples (integer)
.RS 4
تعداد نمونه‌هایی که باید چاپ شوند را مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-s\fP است.
به طور پیش‌فرض تعریف‌نشده است (به معنای تعداد نامحدود نمونه‌ها است،
مگر اینکه توسط گزینه‌های دیگر محدود شود).
.RE
.PP
interval (string)
.RS 4
بازه زمانی بین نمونه‌ها را مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-o\fP است.
از نحو زمان شرح‌داده‌شده در
.BR PCPIntro (1)
پیروی می‌کند.
مقدار پیش‌فرض \fB1s\fP است.
.RE
.PP
delay (boolean)
.RS 4
مشخص می‌کند که هنگام بازپخش از یک بایگانی، آیا بین نمونه‌ها مکث صورت گیرد
یا اینکه بازپخش با حداکثر سرعت انجام شود.
گزینه خط فرمان متناظر \fB\-d\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
type (string)
.RS 4
مشخص می‌کند که آیا مقادیر خام معیار با غیرفعال کردن تمام تبدیل‌های نرخ خروجی داده شوند،
یا شمارنده‌های تجمعی به نرخ (نرخ در ثانیه) تبدیل شوند (پیش‌فرض).
گزینه خط فرمان متناظر \fB\-r\fP است.
مقادیر مجاز \fBdefault\fP یا \fBraw\fP هستند.
.RE
.PP
type_prefer (string)
.RS 4
همانند \fBtype\fP است اما مشخصات احتمالی نوع مربوط به هر معیار را بازنویسی نمی‌کند.
گزینه خط فرمان متناظر \fB\-R\fP است.
مقادیر مجاز \fBdefault\fP یا \fBraw\fP هستند.
.RE
.PP
ignore_incompat (boolean)
.RS 4
نشان می‌دهد معیارهای ناسازگار باید نادیده گرفته شوند.
گزینه خط فرمان متناظر \fB\-I\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
ignore_unknown (boolean)
.RS 4
نشان می‌دهد معیارهای ناشناخته باید نادیده گرفته شوند.
گزینه خط فرمان متناظر \fB\-5\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
names_change (string)
.RS 4
اقدامی را مشخص می‌کند که در صورت تغییرات PMNS در طول نمونه‌گیری باید انجام شود.
گزینه خط فرمان متناظر \fB\-4\fP است.
مقدار پیش‌فرض \fBignore\fP است.
.RE
.PP
instances (string)
.RS 4
نمونه‌هایی که باید گزارش شوند را مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-i\fP است.
به طور پیش‌فرض تعریف‌نشده است (همه نمونه‌ها گزارش می‌شوند).
.RE
.PP
live_filter (boolean)
.RS 4
نشان می‌دهد فیلترسازی زنده باید فعال شود.
گزینه خط فرمان متناظر \fB\-j\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
rank (integer)
.RS 4
مقداری را مشخص می‌کند که برای رتبه‌بندی نمونه‌ها استفاده می‌شود.
گزینه خط فرمان متناظر \fB\-J\fP است.
به طور پیش‌فرض تعریف‌نشده است (همه نمونه‌ها گزارش می‌شوند).
.RE
.PP
overall_rank (boolean)
.RS 4
نشان می‌دهد رتبه‌بندی کلی باید انجام شود.
گزینه خط فرمان متناظر \fB\-2\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
overall_rank_alt (boolean)
.RS 4
نشان می‌دهد رتبه‌بندی کلی با قالب خروجی جایگزین باید انجام شود.
گزینه خط فرمان متناظر \fB\-3\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
limit_filter (integer)
.RS 4
مقداری را مشخص می‌کند که با فیلترسازی حد آستانه استفاده می‌شود.
گزینه خط فرمان متناظر \fB\-8\fP است.
به طور پیش‌فرض تعریف‌نشده است (همه نمونه‌ها گزارش می‌شوند).
.RE
.PP
limit_filter_force (integer)
.RS 4
همانند \fBlimit_filter\fP است اما مشخصات احتمالی بر حسب هر معیار را بازنویسی می‌کند.
گزینه خط فرمان متناظر \fB\-9\fP است.
به طور پیش‌فرض تعریف‌نشده است (همه نمونه‌ها گزارش می‌شوند).
.RE
.PP
invert_filter (boolean)
.RS 4
نشان می‌دهد فیلترسازی معکوس باید انجام شود.
گزینه خط فرمان متناظر \fB\-n\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
predicate (string)
.RS 4
معیارهایی را که باید به عنوان معیارهای گزاره (predicate) استفاده شوند مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-N\fP است.
به طور پیش‌فرض تعریف‌نشده است.
.RE
.PP
sort_metric (string)
.RS 4
معیارهایی را که باید به عنوان معیارهای مرجع مرتب‌سازی استفاده شوند مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-6\fP است.
به طور پیش‌فرض تعریف‌نشده است.
.RE
.PP
omit_flat (boolean)
.RS 4
نشان می‌دهد معیارهای تک‌مقدار «مسطح» (flat) باید از گزارش‌گیری حذف شوند.
گزینه خط فرمان متناظر \fB\-v\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
include_labels (boolean)
.RS 4
نشان می‌دهد برچسب‌های معیار PCP باید در خروجی گنجانده شوند.
گزینه خط فرمان متناظر \fB\-m\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
include_texts (boolean)
.RS 4
نشان می‌دهد هنگام نوشتن بایگانی PCP، متون راهنمای PCP باید در بایگانی ایجادشده گنجانده شوند.
گزینه خط فرمان متناظر \fB\-\-include\-texts\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
colxrow (string)
.RS 4
مشخص می‌کند که ستون‌ها و سطرها در خروجی \fIstdout\fP جابجا شوند و از مقدار به عنوان برچسب متنی معیار استفاده شود.
گزینه خط فرمان متناظر \fB\-X\fP است.
به طور پیش‌فرض تعریف‌نشده است (بدون جابجایی).
.RE
.PP
width (integer)
.RS 4
عرض ستون‌های خروجی stdout را مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-w\fP است.
حداقل مقدار اجباری \fB3\fP است.
مقدار پیش‌فرض کوتاه‌ترین عرضی است که می‌تواند برچسب متنی معیار را در خود جای دهد.
.RE
.PP
width_force (integer)
.RS 4
همانند \fBwidth\fP است اما مشخصات احتمالی بر حسب هر معیار را بازنویسی می‌کند.
گزینه خط فرمان متناظر \fB\-W\fP است.
حداقل مقدار اجباری \fB3\fP است.
.RE
.PP
precision (integer)
.RS 4
مشخص می‌کند چند رقم اعشار برای مقادیر خروجی عددی غیر صحیح استفاده شود.
گزینه خط فرمان متناظر \fB\-P\fP است.
مقدار پیش‌فرض \fB3\fP است.
.RE
.PP
precision_force (integer)
.RS 4
همانند \fBprecision\fP است اما مشخصات احتمالی بر حسب هر معیار را بازنویسی می‌کند.
گزینه خط فرمان متناظر \fB\-0\fP است.
به طور پیش‌فرض تعریف‌نشده است.
.RE
.PP
delimiter (string)
.RS 4
جداکننده ستون‌ها را مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-l\fP است.
مقدار پیش‌فرض به مقصد خروجی بستگی دارد، به
.BR pmrep (1)
مراجعه کنید.
.RE
.PP
extcsv (boolean)
.RS 4
مشخص می‌کند آیا خروجی CSV گسترش‌یافته مشابه
.BR sadf (1)
نوشته شود یا خیر.
گزینه خط فرمان متناظر \fB\-k\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
extheader (boolean)
.RS 4
مشخص می‌کند آیا هدر گسترش‌یافته چاپ شود یا خیر.
گزینه خط فرمان متناظر \fB\-x\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
fixed_header (boolean)
.RS 4
نشان می‌دهد باید از یک هدر ثابت استفاده شود.
گزینه خط فرمان متناظر \fB\-7\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
repeat_header (integer)
.RS 4
مشخص می‌کند هدر هر چند وقت یک‌بار تکرار شود.
گزینه خط فرمان متناظر \fB\-E\fP است.
مقدار \fBauto\fR از ارتفاع ترمینال استفاده می‌کند.
مقدار پیش‌فرض \fB0\fP است (هدر تکرار نمی‌شود).
.RE
.PP
dynamic_header (boolean)
.RS 4
نشان می‌دهد باید از یک هدر پویا استفاده شود.
گزینه خط فرمان متناظر \fB\-1\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
separate_header (boolean)
.RS 4
مشخص می‌کند آیا یک هدر جداگانه چاپ شود یا خیر.
گزینه خط فرمان متناظر \fB\-g\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
timefmt (string)
.RS 4
رشته قالب برای قالب‌بندی برچسب زمان را مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-f\fP است.
مقدار پیش‌فرض \fB%H:%M:%S\fP است.
.RE
.PP
interpol (boolean)
.RS 4
مشخص می‌کند آیا مقادیر گزارش‌شده از بایگانی درون‌یابی (interpolate) شوند یا خیر.
گزینه خط فرمان متناظر \fB\-u\fP است.
برای توضیحات کامل به
.BR pmrep (1)
مراجعه کنید.
مقدار پیش‌فرض \fByes\fP است.
.RE
.PP
count_scale (string)
.RS 4
واحد/مقیاس را برای معیارهای شمارنده مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-q\fP است.
برای نحو پشتیبانی‌شده، به
.BR pmrep (1)
مراجعه کنید.
به طور پیش‌فرض تعریف‌نشده است (بدون تغییر مقیاس).
.RE
.PP
count_scale_force (string)
.RS 4
همانند \fBcount_scale\fP است اما مشخصات احتمالی بر حسب هر معیار را بازنویسی می‌کند.
گزینه خط فرمان متناظر \fB\-Q\fP است.
به طور پیش‌فرض تعریف‌نشده است.
.RE
.PP
space_scale (string)
.RS 4
واحد/مقیاس را برای معیارهای فضا (حافظه/دیسک) مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-b\fP است.
برای نحو پشتیبانی‌شده، به
.BR pmrep (1)
مراجعه کنید.
به طور پیش‌فرض تعریف‌نشده است (بدون تغییر مقیاس).
.RE
.PP
space_scale_force (string)
.RS 4
همانند \fBspace_scale\fP است اما مشخصات احتمالی بر حسب هر معیار را بازنویسی می‌کند.
گزینه خط فرمان متناظر \fB\-B\fP است.
به طور پیش‌فرض تعریف‌نشده است.
.RE
.PP
time_scale (string)
.RS 4
واحد/مقیاس را برای معیارهای زمان مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-y\fP است.
برای نحو پشتیبانی‌شده، به
.BR pmrep (1)
مراجعه کنید.
به طور پیش‌فرض تعریف‌نشده است (بدون تغییر مقیاس).
.RE
.PP
time_scale_force (string)
.RS 4
همانند \fBtime_scale\fP است اما مشخصات احتمالی بر حسب هر معیار را بازنویسی می‌کند.
گزینه خط فرمان متناظر \fB\-Y\fP است.
به طور پیش‌فرض تعریف‌نشده است.
.RE
.SS "بخش [global]"
بخش
.B [global]
برای تعریف معیارهایی استفاده می‌شود که علاوه بر هر معیار یا مجموعه‌معیار دیگری که جداگانه تعریف شده است، گزارش خواهند شد.
گزینه‌های پیکربندی در این بخش مجاز نیستند.
معیارهای سراسری به طور پیش‌فرض گزارش می‌شوند؛ می‌توان از گزینه خط فرمان \fB\-G\fP
یا گزینه فایل پیکربندی \fBglobals\fP برای غیرفعال کردن معیارهای سراسری استفاده کرد.
.PP
\fBتنظیمات مجاز\fP
.PP
.RS 4
تنها \fImetricspecs\fP در این بخش مجاز هستند.
برای مشخصات metricspec به ادامه متن مراجعه کنید.
.RE
.SH "بخش‌های سفارشی (CUSTOM SECTIONS)"
هر بخش دیگری به جز \fB[options]\fP یا \fB[global]\fP به عنوان یک مشخصات
جدید \fImetricset\fP تفسیر خواهد شد.
نام بخش اختیاری است و معمولاً اشاره‌ای به دامنه پوشش یا هدف آن دارد.
یک بخش سفارشی ممکن است شامل گزینه‌ها، metricspecها یا هر دو باشد.
.PP
تمامی معیارهای مشخص‌شده در یک بخش سفارشی (metricset) هنگامی که \fBpmrep\fP
آن مجموعه‌معیار خاص را گزارش می‌دهد، گزارش خواهند شد.
بیش از یک مجموعه‌معیار (بخش سفارشی) را می‌توان در خط فرمان مشخص کرد که در این حالت
\fBpmrep\fP ترکیب تمام معیارهای مشخص‌شده در مجموعه‌معیارهای انتخاب‌شده را گزارش می‌کند.
.PP
\fBتنظیمات مجاز\fP
.PP
.RS 4
هر گزینه‌ای که در بخش \fB[options]\fP معتبر است در یک بخش سفارشی نیز معتبر است.
هر گزینه یا معیاری که در یک بخش سفارشی تعریف شود، همان گزینه یا معیاری را که احتمالاً پیش‌تر تعریف شده است بازنویسی می‌کند.
برای مشخصات metricspec به ادامه متن مراجعه کنید.
.RE
.SH "مشخصات مجموعه‌معیار (METRICSET SPECIFICATION)"
سه شکل برای
.I metricspec
وجود دارد.
نخست، در خط فرمان یک metricspec می‌تواند با یک دو‌نقطه (``:'') آغاز شود تا نشان‌دهنده ارجاع به یک
.I metricset
(بخش سفارشی) باشد که باید از یک فایل پیکربندی
.B pmrep
خوانده شود.
دوم، \fIشکل فشرده\fP (compact form) یک metricspec یک مشخصات معیار تک‌خطی است که هم در خط فرمان و هم در بخش‌های
\fB[global]\fP و سفارشی فایل پیکربندی قابل استفاده است.
تنها تفاوت استفاده از آن در فایل پیکربندی این است که نام معیار به عنوان کلید و مشخص‌کننده‌های اختیاری به عنوان مقادیر استفاده می‌شوند.
شکل فشرده metricspec با جزئیات کامل در
.BR pmrep (1)
مشخص شده است.
سوم، \fIشکل مفصل\fP (verbose form) یک metricspec است که تنها در فایل پیکربندی معتبر است (به زیر مراجعه کنید).
.PP
در یک بخش سفارشی، کلیدی که شامل نقطه (``.'') باشد به عنوان نام معیار تفسیر می‌شود و یک کلید غیرگزینه‌ای که نقطه نداشته باشد به عنوان یک شناسه (دستگیره/handle) برای پیوند دادن اعلان‌های مرتبط به یکدیگر تفسیر می‌شود.
این شناسه دلخواه است و به هیچ وجه به جز برای پیوند دادن مشخص‌کننده‌های زیر و معیار به یکدیگر استفاده نمی‌شود.
.PP
شکل مفصل یک metricspec با اعلانی شامل یک \fIشناسه\fP اجباری به عنوان کلید و نام معیار عملکرد (یک گره PMNS) به عنوان مقدار آن آغاز می‌شود.
این معادل شکل فشرده metricspec است که همان معیار کارایی را بدون هیچ یک از مشخص‌کننده‌های اختیاری تعریف می‌کند.
.PP
مشخص‌کننده‌های زیر در شکل مفصل اختیاری هستند و می‌توانند با هر ترتیبی به عنوان کلید استفاده شوند؛ به این صورت که شناسه اعلام‌شده قبلی و به دنبال آن یک نقطه و مشخص‌کننده می‌آید (مانند \fIidentifier\fP.\fIspecifier\fP).
همچنین به مثال ارائه‌شده در ادامه متن مراجعه کنید.
.RS
.TP 2
.I label
برچسب متنی معیار را برای مقاصد خروجی پشتیبانی‌کننده تعریف می‌کند.
.TP
.I formula
عبارت حسابی مورد نیاز را برای معیار تعریف می‌کند.
برای جزئیات، به
.BR pmRegisterDerived (3)
مراجعه کنید.
.TP
.I instances
نمونه‌هایی را که باید برای معیار گزارش شوند تعریف می‌کند.
برای جزئیات، به
.BR pmrep (1)
مراجعه کنید.
.TP
.I unit
تبدیل واحد/مقیاس را برای معیار تعریف می‌کند.
باید از نظر ابعادی سازگار باشد و برای معیارهای غیر رشته‌ای استفاده می‌شود.
برای مقادیر مجاز، به
.BR pmrep (1)
مراجعه کنید.
.TP
.I type
اگر روی \fBraw\fP تنظیم شود، تبدیل نرخ برای معیار غیرفعال خواهد شد.
.TP
.I width
عرض ستون خروجی را برای معیار تعیین می‌کند.
.TP
.I precision
دقت اعشار را برای مقادیر خروجی عددی غیر صحیح تعیین می‌کند.
.TP
.I limit
فیلتر حد مقدار را برای مقادیر عددی معیار تعیین می‌کند.
.RE
.SH "مثال‌ها (EXAMPLES)"
مثال زیر شامل یک بخش کوتاه \fB[options]\fP است که برخی مقادیر پیش‌فرض محلی مورد نظر را تنظیم می‌کند.
سپس معیارهای سراسری \fBkernel.all.sysfork\fP با استفاده از \fIشکل فشرده\fP
و \fBmem.util.allcache\fP با استفاده از \fIشکل مفصل\fP یک metricspec تعریف می‌شوند.
مورد دوم یک معیار اشتقاقی است که از فرمول مشخص‌شده استفاده می‌کند.
هر دوی این معیارها در گزارش‌گیری گنجانده خواهند شد مگر اینکه با \fB\-G\fP یا \fBglobals = no\fP غیرفعال شوند.
.PP
سه \fImetricset\fP مختلف نیز مشخص شده‌اند: \fBdb1\fP،
\fBdb2\fP و \fBsar\-w\fP.
.PP
مجموعه‌های پایگاه داده (DB) میزبانی را تعریف می‌کنند که باید به عنوان منبع معیارها استفاده شود.
هر دو از \fIشکل مفصل\fP یک metricspec استفاده می‌کنند (زیرا کلید غیرگزینه‌ای \fBset\fP فاقد نقطه است) تا همه معیارهای مربوط به \fBpostgresql\fP را شامل شوند.
.PP
مجموعه \fBsar\-w\fP مثالی است از نحوه شبیه‌سازی یک ابزار موجود با \fBpmrep\fP.
.PP
فایل‌های پیکربندی پیش‌فرض سیستم \fBpmrep\fP شامل مثال‌های بسیار بیشتری هستند.
کلید tab در خط فرمان پس از یک دو‌نقطه، مجموعه‌معیارهای موجود را تکمیل می‌کند (در bash و zsh).
.sp 1
.PP
.RS 4
.nf
[options]
timestamp = yes
interval = 2s
extheader = yes
repeat_header = auto
space_scale = MB

[global]
kernel.all.sysfork = forks,,,,8
cacheall = mem.util.allcache
cacheall.formula = mem.util.bufmem + mem.util.cached + mem.util.slab
cacheall.width = 12

[db1]
source = db\-host1.example.com
set = postgresql

[db2]
source = db\-host2.example.com
set = postgresql

[sar\-w]
header = yes
unitinfo = no
globals = no
timestamp = yes
precision = 2
delimiter = " "
kernel.all.sysfork = proc/s,,,,12
kernel.all.pswitch = cswch/s,,,,9
.fi
.RE
.sp 1
.SH "فایل‌ها (FILES)"
.TP
.I \f(CR$PCP_SYSCONF_DIR\fP/pmrep/*.conf
فایل‌های پیکربندی پیش‌فرض ارائه شده توسط سیستم برای \fBpmrep\fP
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP استفاده می‌شوند.
در هر نصب، فایل \fB/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.PP
برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmrep (1)،
.BR pmGetOptions (3)،
.BR pmRegisterDerived (3)
و
.BR pmSpecLocalPMDA (3).