\"macro stdmacro
.\"
.\" Copyright (C) 2015-2021 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 PCP2GRAPHITE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pcp2graphite \- صادرکننده معیارهای کارایی از PCP به Graphite
.SH "خلاصه دستور (SYNOPSIS)"
\fBpcp2graphite\fP
[\fB\-5CGHIjLnrRvV?\fP]
[\fB\-4\fP \fIaction\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]
[\f3\-D\f1 \f2debug\f1]
[\fB\-\-daemonize\fP]
[\fB\-e\fP \fIderived\fP]
[\fB\-E\fP \fItext-port\fP]
[\fB\-g\fP \fIserver\fP]
[\fB\-h\fP \fIhost\fP]
[\fB\-i\fP \fIinstances\fP]
[\fB\-J\fP \fIrank\fP]
[\fB\-K\fP \fIspec\fP]
[\fB\-N\fP \fIpredicate\fP]
[\fB\-O\fP \fIorigin\fP]
[\fB\-p\fP \fIpickle-port\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\-x\fP \fIprefix\fP]
[\fB\-X\fP \fIpickle-protocol\fP]
[\fB\-y\fP|\fB\-Y\fP \fItime-scale\fP]
\fImetricspec\fP
[...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp2graphite
ابزاری با قابلیت سفارشی‌سازی برای صدور معیارهای کارایی از PCP به Graphite است.
هر معیار کارایی موجود، به‌صورت زنده یا بایگانی‌شده، سیستمی یا برنامه‌ای، می‌تواند با استفاده از آرگومان‌های خط فرمان یا یک فایل پیکربندی برای صدور انتخاب شود.
.PP
دستور
.B pcp2graphite
ارتباط نزدیکی با
.BR pmrep (1)
دارد. برای شرح
.I metricspec
پذیرفته‌شده در خط فرمان
.BR pcp2graphite ،
به
.BR pmrep (1)
مراجعه کنید. برای شرح نحو فایل پیکربندی
.B pcp2graphite.conf
به
.BR pmrep.conf (5)
مراجعه نمایید. این صفحه گزینه‌های اختصاصی
.B pcp2graphite
و تفاوت‌های فایل پیکربندی آن با
.BR pmrep.conf (5)
را توصیف می‌کند. همچنین
.BR pmrep (1)
چندین مثال کاربردی را فهرست می‌کند که بیشتر آن‌ها برای
.B pcp2graphite
نیز قابل استفاده هستند.
.PP
تنها گزینه‌های خط فرمان ذکرشده در این صفحه پشتیبانی می‌شوند؛ سایر گزینه‌های موجود برای
.BR pmrep (1)
پشتیبانی نمی‌شوند.
.PP
گزینه‌های مشخص‌شده از طریق متغیرهای محیطی (به
.BR pmGetOptions (3)
مراجعه کنید) مقادیر پیش‌فرض توکار متناظر را (در صورت وجود) بازنویسی می‌کنند.
گزینه‌های فایل پیکربندی، متغیرهای محیطی متناظر را (در صورت وجود) بازنویسی می‌کنند.
گزینه‌های خط فرمان، گزینه‌های فایل پیکربندی متناظر را (در صورت وجود) بازنویسی می‌کنند.
.SH "فایل پیکربندی (CONFIGURATION FILE)"
دستور
.B pcp2graphite
از یک فایل پیکربندی با نحو توصیف‌شده در
.BR pmrep.conf (5)
استفاده می‌کند. گزینه‌های زیر با
.B pmrep.conf
مشترک هستند:
.BR version ،
.BR source ،
.BR speclocal ،
.BR derived ،
.BR header ،
.BR globals ،
.BR samples ،
.BR interval ،
.BR type ،
.BR type_prefer ،
.BR ignore_incompat ،
.BR names_change ،
.BR instances ،
.BR live_filter ،
.BR rank ،
.BR limit_filter ،
.BR limit_filter_force ،
.BR invert_filter ،
.BR predicate ،
.BR omit_flat ،
.BR precision ،
.BR precision_force ،
.BR count_scale ،
.BR count_scale_force ،
.BR space_scale ،
.BR space_scale_force ،
.BR time_scale ،
.BR time_scale_force .
بقیه گزینه‌های
.B pmrep.conf
برای سازگاری شناسایی می‌شوند اما نادیده گرفته می‌شوند.
.SS "گزینه‌های اختصاصی pcp2graphite"
graphite_host (رشته)
.RS 4
مشخص کردن نام میزبان یا نشانی IP سرور مقصد Graphite.
گزینه خط فرمان متناظر
.B \-g
است.
پیش‌فرض
.B localhost
است.
.RE
.PP
graphite_port (عدد صحیح)
.RS 4
مشخص کردن شماره درگاه سرور Graphite (متن ساده یا pickle).
گزینه‌های خط فرمان متناظر
.B \-p
و
.B \-E
هستند.
پیش‌فرض
.B 2004
است.
.RE
.PP
pickle (بولی)
.RS 4
مشخص کردن استفاده یا عدم استفاده از پروتکل pickle.
گزینه‌های خط فرمان متناظر
.B \-p
و
.B \-E
هستند.
پیش‌فرض
.B yes
است.
.RE
.PP
pickle_protocol (عدد صحیح)
.RS 4
مشخص کردن نسخه پروتکل pickle.
گزینه خط فرمان متناظر
.B \-X
است.
پیش‌فرض
.B 0
است.
.RE
.PP
prefix (رشته)
.RS 4
مشخص کردن پیشوند معیارهای ارسالی به سرور.
گزینه خط فرمان متناظر
.B \-x
است.
پیش‌فرض
.B pcp.
است.
.RE
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-0\fR \fIprecision\fR, \fB\-\-precision\-force\fR=\fIprecision\fR
مانند
.B \-P
است، اما این گزینه مشخصات تعیین‌شده برای هر معیار را بازنویسی \fIخواهد کرد\fP.
.TP
\fB\-4\fR \fIaction\fR, \fB\-\-names\-change\fR=\fIaction\fR
اقدام (\fIaction\fR) مورد نظر هنگام دریافت رویداد تغییر نام معیارها در حین نمونه‌برداری را مشخص می‌کند.
این رویدادها زمانی رخ می‌دهند که یک PMDA مدتی پس از راه‌اندازی، معیارهای جدیدی کشف کرده و به ابزارهای کلاینت در حال اجرا مانند
.B pcp2graphite
اطلاع دهد.
مقادیر معتبر برای
.I action
عبارتند از \fBupdate\fP (تازه‌سازی معیارهای در حال نمونه‌برداری)،
\fBignore\fP (نادیده گرفتن \- رفتار پیش‌فرض)
و \fBabort\fP (خروج از برنامه در صورت وقوع چنین رویدادی).
.TP
\fB\-5\fR, \fB\-\-ignore\-unknown\fR
نادیده گرفتن خاموش هر نام معیاری که قابل حل نباشد.
حداقل یک معیار باید پیدا شود تا ابزار شروع به کار کند.
.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
مشخص شده‌اند بازیابی می‌شوند؛ این آرگومان فهرستی جداشده با کاما از نام‌ها است که هر کدام می‌توانند نام پایه یک بایگانی یا نام پوشه‌ای حاوی یک یا چند بایگانی باشند.
.TP
\fB\-A\fR \fIalign\fR, \fB\-\-align\fR=\fIalign\fR
هم‌تراز کردن اجباری نمونه اولیه بر روی مرز یک واحد زمانی طبیعی
.IR align .
برای شرح کامل نحو
.I 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
واحد/مقیاس (\fIscale\fR) برای معیارهای فضا (بایت)؛ مقادیر ممکن شامل
.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
مشخص کردن فایل یا پوشه پیکربندی (\fIconfig\fR) مورد استفاده.
در صورتی که \fIconfig\fP یک پوشه باشد، تمام فایل‌های درون آن که به
\fB.conf\fR
ختم می‌شوند لحاظ خواهند شد.
مقدار پیش‌فرض اولین مورد یافت‌شده از میان موارد زیر است:
.IR ./pcp2graphite.conf ،
.IR \f(CR$HOME\fP/.pcp2graphite.conf ،
.IR \f(CR$HOME\fP/pcp/pcp2graphite.conf
و
.IR \f(CR$PCP_SYSCONF_DIR\fP/pcp2graphite.conf .
برای جزئیات به بخش بالا و
.BR pmrep.conf (5)
مراجعه کنید.
.TP
\fB\-\-container\fR=\fIcontainer\fR
واکشی معیارهای کارایی از کانتینر (\fIcontainer\fR) مشخص‌شده، به‌صورت محلی یا از راه دور (به
.B \-h
مراجعه کنید).
.TP
\fB\-C\fR, \fB\-\-check\fR
خروج پیش از گزارش هرگونه مقدار، اما پس از تجزیه پیکربندی و معیارها و چاپ هدرهای احتمالی.
.TP
.B \-\-daemonize
اجرا به‌صورت پس‌زمینه (Daemonize) در زمان راه‌اندازی.
.TP
\fB\-e\fR \fIderived\fR, \fB\-\-derived\fR=\fIderived\fR
مشخص کردن معیارهای کارایی مشتق‌شده (\fIderived\fR).
اگر
.I derived
با یک اسلش («/») یا با یک نقطه («.») شروع شود، به عنوان یک فایل پیکربندی معیارهای مشتق‌شده PCP تفسیر خواهد شد؛ در غیر این صورت به عنوان عبارات معیارهای مشتق‌شده جداشده با کاما یا نقطه‌ویرگول تفسیر می‌شود.
برای شرح کامل معیارهای مشتق‌شده و فایل‌های پیکربندی معیارهای مشتق‌شده PCP به
.BR pmLoadDerivedConfig (3)
و
.BR pmRegisterDerived (3)
مراجعه کنید.
متناوباً، استفاده از نحو پیکربندی
.BR pmrep.conf (5)
امکان تعریف معیارهای مشتق‌شده را به عنوان بخشی از مجموعه‌معیارها فراهم می‌کند.
.RS
.PP
در صورت بروز مشکل در معیارهای مشتق‌شده، صفحات راهنمای یادشده را به دقت بررسی کرده و اطمینان حاصل کنید که تمام معیارهای مورد نیاز، به‌ویژه هنگام استفاده از بایگانی‌ها، در دسترس هستند.
از
.B \-Dderive
برای مشاهده اطلاعات اشکال‌زدایی اضافی درباره تجزیه معیارهای مشتق‌شده استفاده کنید.
.RE
.TP
\fB\-E\fR \fIport\fR, \fB\-\-text\-port\fR=\fIport\fR
درگاه متن ساده (\fIport\fR) سرور Graphite.
استفاده از این گزینه پروتکل pickle را غیرفعال می‌کند.
.TP
\fB\-g\fR \fIserver\fR, \fB\-\-graphite\-host\fR=\fIserver\fR
نام میزبان یا نشانی IP سرور مقصد Graphite.
.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
بازیابی و گزارش فقط نمونه‌های (\fIinstances\fR) مشخص‌شده معیار.
به‌طور پیش‌فرض تمام نمونه‌ها، اعم از موجود و آینده، گزارش می‌شوند.
.RS
.PP
برای شرح کامل این گزینه به
.BR pmrep (1)
مراجعه کنید.
.RE
.TP
\fB\-I\fR, \fB\-\-ignore\-incompat\fR
نادیده گرفتن معیارهای ناسازگار.
به‌طور پیش‌فرض معیارهای ناسازگار (یعنی نوع آن‌ها پشتیبانی نمی‌شود یا طبق درخواست مقیاس‌پذیر نیستند) باعث می‌شوند
.B pcp2graphite
با یک پیام خطا متوقف شود.
با این گزینه، تمامی معیارهای ناسازگار به‌صورت خاموش از گزارش حذف می‌شوند.
این گزینه به‌ویژه هنگام درخواست گره‌های غیربرگ درخت PMNS برای گزارش‌دهی مفید است.
.TP
\fB\-j\fR, \fB\-\-live\-filter\fR
انجام فیلتر زنده نمونه‌ها.
این قابلیت امکان به دام انداختن تمام نمونه‌های نام‌گذاری‌شده را حتی در صورت راه‌اندازی مجدد فرآیندها در طول زمان فراهم می‌کند (برخلاف حالت بدون فیلتر زنده).
انجام فیلتر زنده روی تعداد بسیار زیادی از نمونه‌ها سربار داخلی اضافه می‌کند، بنابراین رعایت احتیاط توصیه می‌شود.
همچنین به
.B \-n
مراجعه کنید.
.TP
\fB\-J\fR \fIrank\fR, \fB\-\-rank\fR=\fIrank\fR
محدود کردن نتایج به بالاترین/پایین‌ترین رتبه (\fIrank\fR) نمونه‌های معیارهای چندمقداره.
یک عدد صحیح مثبت، نمونه‌هایی با بالاترین مقدار را در گزارش لحاظ می‌کند.
یک عدد صحیح منفی، نمونه‌هایی با کمترین مقدار را در گزارش لحاظ می‌کند.
مقدار صفر هیچ رتبه‌بندی انجام نمی‌دهد.
رتبه‌بندی به معنای مرتب‌سازی نیست، به
.B \-6
مراجعه کنید.
همچنین به
.B \-8
مراجعه کنید.
.TP
\fB\-K\fR \fIspec\fR, \fB\-\-spec\-local\fR=\fIspec\fR
هنگام واکشی معیارها از یک بافت محلی (به
.B \-L
مراجعه کنید)، گزینه
.B \-K
می‌تواند برای کنترل DSO PMDAهایی که باید قابل دسترسی باشند استفاده شود.
آرگومان
.I spec
از نحو توصیف‌شده در
.BR pmSpecLocalPMDA (3)
پیروی می‌کند.
می‌توان از بیش از یک گزینه
.B \-K
استفاده کرد.
.TP
\fB\-L\fR, \fB\-\-local\-PMDA\fR
استفاده از یک بافت محلی برای جمع‌آوری معیارها از DSO PMDAها روی میزبان محلی بدون PMCD.
همچنین به
.B \-K
مراجعه کنید.
.TP
\fB\-n\fR, \fB\-\-invert\-filter\fR
انجام رتبه‌بندی پیش از فیلتر زنده.
به‌طور پیش‌فرض، فیلتر زنده نمونه‌ها (در صورت درخواست، به
.B \-j
مراجعه کنید) پیش از رتبه‌بندی نمونه‌ها (در صورت درخواست، به
.B \-J
مراجعه کنید) رخ می‌دهد.
با این گزینه، منطق معکوس شده و رتبه‌بندی پیش از فیلتر زنده انجام می‌شود.
.TP
\fB\-N\fR \fIpredicate\fR, \fB\-\-predicate\fR=\fIpredicate\fR
مشخص کردن فهرستی جداشده با کاما از معیارهای مرجع فیلتر گزاره‌ای (\fIpredicate\fR).
به‌طور پیش‌فرض، رتبه‌بندی (به
.B \-J
مراجعه کنید) برای هر معیار به‌صورت جداگانه انجام می‌شود.
با گزاره‌ها، رتبه‌بندی فقط برای معیارهای گزاره‌ای مشخص‌شده انجام خواهد شد.
هنگام گزارش‌دهی، بقیه معیارهایی که دامنه نمونه یکسانی (به
.BR PCPIntro (1)
مراجعه کنید) با گزاره دارند، فقط شامل بالاترین/پایین‌ترین رتبه نمونه‌های گزاره متناظر خواهند بود.
رتبه‌بندی به معنای مرتب‌سازی نیست، به
.B \-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\-O\fR \fIorigin\fR, \fB\-\-origin\fR=\fIorigin\fR
هنگام گزارش معیارهای بایگانی‌شده، شروع گزارش‌دهی در مبدأ زمانی
.I origin
درون پنجره زمانی (به
.B \-S
و
.B \-T
مراجعه کنید).
برای شرح کامل نحو
.I origin
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-p\fR \fIport\fR, \fB\-\-pickle\-port\fR=\fIport\fR
درگاه پروتکل pickle سرور Graphite.
استفاده از این گزینه پروتکل pickle را فعال می‌کند.
.TP
\fB\-P\fR \fIprecision\fR, \fB\-\-precision\fR=\fIprecision\fR
استفاده از دقت اعشار (\fIprecision\fR) برای مقادیر عددی غیرصحیح در خروجی.
حالت پیش‌فرض استفاده از ۳ رقم اعشار است (در صورت کاربرد).
این گزینه مشخصات احتمالی تعیین‌شده برای هر معیار را بازنویسی \fIنخواهد کرد\fP.
.TP
\fB\-q\fR \fIscale\fR, \fB\-\-count\-scale\fR=\fIscale\fR
واحد/مقیاس (\fIscale\fR) برای معیارهای شمارشی؛ مقادیر ممکن شامل
.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 pcp2graphite
به‌صورت پیوسته (در حالت بلادرنگ) یا تا پایان مجموعه بایگانی‌های PCP (در حالت بایگانی) نمونه‌برداری و گزارش خواهد کرد.
همچنین به
.B \-T
مراجعه کنید.
.TP
\fB\-S\fR \fIstarttime\fR, \fB\-\-start\fR=\fIstarttime\fR
هنگام گزارش معیارهای بایگانی‌شده، گزارش محدود به رکوردهایی خواهد شد که در یا پس از زمان شروع (\fIstarttime\fR) ثبت شده‌اند.
برای شرح کامل نحو
.I starttime
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-t\fR \fIinterval\fR, \fB\-\-interval\fR=\fIinterval\fR
تنظیم بازه گزارش‌دهی (\fIinterval\fR) به مقداری غیر از مقدار پیش‌فرض ۱ ثانیه.
آرگومان
.I interval
از نحو توصیف‌شده در
.BR PCPIntro (1)
پیروی می‌کند و در ساده‌ترین شکل می‌تواند یک عدد صحیح بدون علامت باشد (واحد ضمنی در این حالت ثانیه است).
همچنین به گزینه
.B \-T
مراجعه کنید.
.TP
\fB\-T\fR \fIendtime\fR, \fB\-\-finish\fR=\fIendtime\fR
هنگام گزارش معیارهای بایگانی‌شده، گزارش محدود به رکوردهایی خواهد شد که در یا پیش از زمان پایان (\fIendtime\fR) ثبت شده‌اند.
برای شرح کامل نحو
.I endtime
به
.BR PCPIntro (1)
مراجعه کنید.
.RS
.PP
هنگامی که برای تعیین زمان اجرا پیش از خروج \fBpcp2graphite\fP استفاده می‌شود، اگر هیچ \fIsamples\fP داده نشده باشد (به \fB\-s\fP مراجعه کنید)، تعداد نمونه‌های گزارش‌شده به \fIinterval\fP بستگی دارد (به \fB\-t\fP مراجعه کنید).
اگر
.I samples
مشخص شده باشد، آن‌گاه
.I interval
طوری تنظیم می‌شود که امکان گزارش
.I samples
در طول زمان اجرا فراهم گردد.
در صورتی که هر سه گزینه
.BR \-T ،
.B \-s
و
.B \-t
مشخص شده باشند،
.I endtime
زمان واقعی اجرای
.B pcp2graphite
را تعیین می‌کند.
.RE
.TP
\fB\-v\fR, \fB\-\-omit\-flat\fR
گزارش فقط معیارهای چندمقداره دارای نمونه (مانند disk.dev.read) و صرف‌نظر از معیارهای تک‌مقداره «تخت» بدون نمونه (مانند kernel.all.sysfork).
به
.B \-i
و
.B \-I
مراجعه کنید.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-x\fR \fIprefix\fR, \fB\-\-prefix\fR=\fIprefix\fR
پیشوند (\fIprefix\fR) معیارها برای مقادیر اندازه‌گیری‌شده ارسالی به سرور.
.TP
\fB\-X\fR \fIprotocol\fR, \fB\-\-pickle\-protocol\fR=\fIprotocol\fR
شماره نسخه پروتکل pickle (\fIprotocol\fR).
.TP
\fB\-y\fR \fIscale\fR, \fB\-\-time\-scale\fR=\fIscale\fR
واحد/مقیاس (\fIscale\fR) برای معیارهای زمان؛ مقادیر ممکن شامل
.BR nanosec ،
.BR ns ،
.BR microsec ،
.BR us ،
.BR millisec ،
.BR ms
و غیره تا
.BR hour ،
.B 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\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "فایل‌ها (FILES)"
.TP 5
.I pcp2graphite.conf
فایل پیکربندی \fBpcp2graphite\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
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR mkaf (1),
.BR pcp (1),
.BR pcp2elasticsearch (1),
.BR pcp2influxdb (1),
.BR pcp2json (1),
.BR pcp2spark (1),
.BR pcp2xlsx (1),
.BR pcp2xml (1),
.BR pcp2zabbix (1),
.BR pmcd (1),
.BR pminfo (1),
.BR pmrep (1),
.BR pmGetOptions (3),
.BR pmLoadDerivedConfig (3),
.BR pmParseUnitsStr (3),
.BR pmRegisterDerived (3),
.BR pmSpecLocalPMDA (3),
.BR LOGARCHIVE (5),
.BR pcp.conf (5),
.BR pmrep.conf (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ limit_filter_force count_scale_force space_scale_force
.\" +ok+ time_scale_force ignore_incompat pickle_protocol precision_force
.\" +ok+ invert_filter graphite_host graphite_port names_change
.\" +ok+ limit_filter live_filter total_bytes count_scale
.\" +ok+ space_scale type_prefer metricsets time_scale plaintext
.\" +ok+ omit_flat incompat influxdb
.\" +ok+ CGHIjLnrRvV {from -5CGHIjLnrRvV? but 5 is not a char in an ispell "word"}