'\"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 PCP2ZABBIX 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp2zabbix\f1 \- صادرکننده معیارهای کارایی PCP به Zabbix
.SH "خلاصه دستور (SYNOPSIS)"
\fBpcp2zabbix\fP
[\fB\-5CGHIjlLnrRvV?\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 \fIsend-interval\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 \fIport\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 \fIhostname\fP]
[\fB\-y\fP|\fB\-Y\fP \fItime-scale\fP]
\fImetricspec\fP
[...]
.SH "توضیحات (DESCRIPTION)"
.B pcp2zabbix
یک ابزار با قابلیت سفارشی‌سازی برای صادر کردن معیارهای کارایی از PCP به Zabbix است.
هر معیار کارایی دردسترس، به‌صورت زنده یا بایگانی‌شده، سیستمی و/یا برنامه‌ای، می‌تواند با استفاده از آرگومان‌های خط فرمان یا یک فایل پیکربندی برای صدور انتخاب شود.
.PP
.B pcp2zabbix
خویشاوند نزدیک
.BR pmrep (1)
است. برای شرح
.I metricspec
پذیرفته‌شده در خط فرمان
.BR pcp2zabbix ،
به
.BR pmrep (1)
مراجعه کنید. برای شرح ساختار فایل پیکربندی
.B pcp2zabbix.conf
به
.BR pmrep.conf (5)
مراجعه نمایید. این صفحه گزینه‌های اختصاصی
.B pcp2zabbix
و تفاوت‌های فایل پیکربندی با
.BR pmrep.conf (5)
را شرح می‌دهد.
.BR pmrep (1)
همچنین مثال‌هایی از کاربرد را فهرست می‌کند که بیشتر آن‌ها برای
.B pcp2zabbix
نیز قابل استفاده هستند.
.PP
تنها گزینه‌های خط فرمانی که در این صفحه فهرست شده‌اند پشتیبانی می‌شوند؛ سایر گزینه‌های موجود در
.BR pmrep (1)
پشتیبانی نمی‌شوند.
.PP
گزینه‌های تعیین‌شده از طریق مقادیر متغیرهای محیطی (ببینید
.BR pmGetOptions (3))
بر مقادیر پیش‌فرض توکار مربوطه (در صورت وجود) اولویت دارند. گزینه‌های فایل پیکربندی بر متغیرهای محیطی مربوطه (در صورت وجود) اولویت دارند. گزینه‌های خط فرمان نیز بر گزینه‌های متناظر در فایل پیکربندی (در صورت وجود) مقدم هستند..SH "فایل پیکربندی (CONFIGURATION FILE)"
.B pcp2zabbix
از یک فایل پیکربندی با ساختار نحوی شرح‌داده‌شده در
.BR pmrep.conf (5)
استفاده می‌کند.
گزینه‌های زیر با
.BR 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 "گزینه‌های اختصاصی pcp2zabbix"
zabbix_server (رشته)
.RS 4
نام میزبان یا نشانی IP سرور مقصد Zabbix را مشخص می‌کند.
اگر میزبانی توسط یک پراکسی پایش می‌شود، باید به جای آن از نام میزبان یا نشانی IP پراکسی استفاده شود.
گزینه خط فرمان متناظر \fB\-g\fP است.
پیش‌فرض \fBlocalhost\fP است.
.RE
.PP
zabbix_port (عدد صحیح)
.RS 4
شماره درگاه (port) بخش server trapper که روی سرور در حال اجراست را مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-p\fP است.
پیش‌فرض \fB10051\fP است.
.RE
.PP
zabbix_host (رشته)
.RS 4
نام میزبان عامل (agent) را همان‌گونه که در واسط کاربری Zabbix ثبت شده است مشخص می‌کند.
نشانی IP میزبان و نام DNS کار نخواهند کرد.
گزینه خط فرمان متناظر \fB\-X\fP است.
پیش‌فرض، میزبان مبدأ سنجه‌ها است.
.RE
.PP
zabbix_interval (رشته)
.RS 4
بازه زمانی ارسال سنجه‌ها به سرور Zabbix را مشخص می‌کند.
این مقدار می‌تواند طولانی‌تر از بازه گزارش‌گیری (\fIinterval\fP) باشد تا بار اضافی (overhead) هنگام ارتباط با سرور کاهش یابد (زیرا هر ارسال یک اتصال جدید ایجاد می‌کند).
از ساختار نحوی زمان شرح‌داده‌شده در
.BR PCPIntro (1)
پیروی می‌کند.
گزینه خط فرمان متناظر \fB\-E\fP است.
پیش‌فرض، بازه گزارش‌گیری (\fIinterval\fP) است.
ابزارهای Zabbix در هر نوبت حداکثر ۲۵۰ سنجه ارسال می‌کنند.
هنگام خواندن سنجه‌ها از آرشیوهای PCP نادیده گرفته می‌شود که در این حالت سنجه‌ها تقریباً در دسته‌های ۲۵۰تایی ارسال خواهند شد.
.RE
.PP
zabbix_prefix (رشته)
.RS 4
پیشوند سنجه‌های ارسالی به سرور Zabbix را مشخص می‌کند.
گزینه خط فرمان متناظر \fB\-x\fP است.
پیش‌فرض \fBpcp.\fP است.
.RE
.PP
zabbix_lld (بولی)
.RS 4
مشخص می‌کند که آیا کشف سطح پایین (low-level discovery) در Zabbix فعال باشد یا خیر.
گزینه خط فرمان متناظر \fB\-l\fP است.
پیش‌فرض \fBno\fP است.
.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
مشخص می‌کند که هنگام دریافت رویداد تغییر نام معیار در حین نمونه‌برداری، چه
.I action
(عملیاتی) انجام شود.
این رویدادها زمانی رخ می‌دهند که یک PMDA مدتی پس از راه‌اندازی، معیارهای جدیدی کشف کرده و به ابزارهای کلاینت در حال اجرا مانند
.BR pcp2zabbix
اطلاع دهد.
مقادیر معتبر برای
.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 .
برای شرح کامل نحو
.IR align
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-\-archive\-folio\fR=\fIfolio\fR
خواندن بایگانی‌های منبع معیار از PCP archive
.I folio
ایجادشده توسط ابزارهایی مانند
.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\fR
ختم می‌شوند، لحاظ خواهند شد.
پیش‌فرض، نخستین مورد یافت‌شده از موارد زیر است:
.IR ./pcp2zabbix.conf ،
.IR \f(CR$HOME\fP/.pcp2zabbix.conf ،
.IR \f(CR$HOME\fP/pcp/pcp2zabbix.conf
و
.IR \f(CR$PCP_SYSCONF_DIR\fP/pcp2zabbix.conf .
برای جزئیات، بخش بالا و
.BR pmrep.conf (5)
را ببینید.
.TP
\fB\-\-container\fR=\fIcontainer\fR
دریافت معیارهای کارایی از
.IR container
مشخص‌شده، به‌صورت محلی یا از راه دور (ببینید
.BR \-h ).
.TP
\fB\-C\fR, \fB\-\-check\fR
خروج پیش از گزارش هر مقداری، اما پس از تجزیه پیکربندی و معیارها و چاپ سرآیندهای احتمالی.
.TP
.B \-\-daemonize
تبدیل شدن به دیمن در هنگام راه‌اندازی.
.TP
\fB\-e\fR \fIderived\fR, \fB\-\-derived\fR=\fIderived\fR
معیارهای کارایی مشتق‌شده (
.IR 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 \fIinterval\fR, \fB\-\-zabbix\-interval\fR=\fIinterval\fR
فاصله زمانی (
.IR interval
) را برای ارسال معیارها به سرور مشخص می‌کند.
برای جزئیات بیشتر، به توضیحات \fBzabbix_interval\fP در بالا مراجعه کنید.
.TP
\fB\-g\fR \fIserver\fR, \fB\-\-zabbix\-server\fR=\fIserver\fR
.IR server
مقصد زبیکس (Zabbix).
.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
تنها نمونه‌های (
.IR instances
) مشخص‌شده از معیار بازیابی و گزارش شوند.
به‌طور پیش‌فرض، تمام نمونه‌های فعلی و آینده گزارش می‌شوند.
.RS
.PP
برای شرح کامل این گزینه به
.BR pmrep (1)
مراجعه کنید.
.RE
.TP
\fB\-I\fR, \fB\-\-ignore\-incompat\fR
نادیده گرفتن معیارهای ناسازگار.
به‌طور پیش‌فرض معیارهای ناسازگار (یعنی نوع آن‌ها پشتیبانی نمی‌شود یا نمی‌توان آن‌ها را طبق درخواست مقیاس‌بندی کرد) موجب می‌شوند که
.B pcp2zabbix
با یک پیام خطا خاتمه یابد.
با این گزینه، تمام معیارهای ناسازگار به‌صورت بی‌صدا از گزارش حذف می‌شوند.
این گزینه به‌ویژه هنگام درخواست گره‌های غیربرگ (non-leaf) از درخت PMNS برای گزارش‌گیری مفید است..TP
\fB\-l\fR, \fB\-\-zabbix\-lld\fR
افزودن معیارهای کشف سطح پایین (LLD).
این قابلیت امکان ارسال دامنه‌های نمونه (instance domains) معیارهای PCP را به Zabbix فراهم می‌کند،
تا آیتم‌ها/محرک‌ها/نمودارهای اولیه (prototype) به‌طور خودکار
توسط Zabbix ایجاد شوند.
به ازای هر معیار PCP که دارای دامنه نمونه است، کلید
.hy 0
\fBpcp.discovery[pcp.met.ric]\fR
.hy
به‌طور دوره‌ای ارسال می‌شود.
این نماد باید به یک قاعده کشف افزوده شود و ماکروی LLD
.hy 0
\fB{#PCP.MET.RIC}\fR
.hy
را تعریف خواهد کرد.
این ماکرو به نوبه خود می‌تواند برای تعریف آیتم‌ها/محرک‌ها/نمودارهای اولیه استفاده شود.
اگر از \fB\-x\fR برای بازنویسی پیشوند
\fBpcp.\fR
استفاده شده باشد، نام‌ها تطبیق داده می‌شوند.
.TP
\fB\-j\fR, \fB\-\-live\-filter\fR
انجام فیلترسازی زنده نمونه‌ها.
این قابلیت اجازه می‌دهد همه نمونه‌های نام‌گذاری‌شده ثبت شوند، حتی اگر فرایندها
در مقطعی مجدداً راه‌اندازی شوند (برخلاف حالت بدون فیلترسازی زنده).
انجام فیلترسازی زنده روی تعداد بسیار زیادی از نمونه‌ها مقداری سربار داخلی اضافه خواهد کرد،
بنابراین احتیاط کاربر توصیه می‌شود.
همچنین ببینید:
.BR \-n .
.TP
\fB\-J\fR \fIrank\fR, \fB\-\-rank\fR=\fIrank\fR
محدود کردن نتایج به بالاترین/پایین‌ترین نمونه‌های
.IR rank ed
(رتبه‌بندی‌شده) از معیارهای مجموعه‌مقدار (set-valued).
یک عدد صحیح مثبت، نمونه‌های دارای بالاترین مقدار را در گزارش لحاظ می‌کند.
یک عدد صحیح منفی، نمونه‌های دارای کمترین مقدار را در گزارش لحاظ می‌کند.
مقدار صفر هیچ رتبه‌بندی‌ای انجام نمی‌دهد.
رتبه‌بندی به معنای مرتب‌سازی نیست، ببینید:
.BR \-6 .
همچنین ببینید:
.BR \-8 .
.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, \fB\-\-local\-PMDA\fR
استفاده از یک بافت محلی برای جمع‌آوری معیارها از DSO PMDAها روی میزبان محلی
بدون PMCD.
همچنین ببینید:
.BR \-K .
.TP
\fB\-n\fR, \fB\-\-invert\-filter\fR
انجام رتبه‌بندی پیش از فیلترسازی زنده.
به‌طور پیش‌فرض، فیلترسازی زنده نمونه‌ها (در صورت درخواست، ببینید:
.BR \-j )
پیش از رتبه‌بندی نمونه‌ها (در صورت درخواست، ببینید:
.BR \-J )
انجام می‌شود.
با این گزینه، این منطق معکوس شده و رتبه‌بندی پیش از
فیلترسازی زنده رخ می‌دهد.
.TP
\fB\-N\fR \fIpredicate\fR, \fB\-\-predicate\fR=\fIpredicate\fR
مشخص کردن یک فهرست جداشده با کاما از معیارهای مرجعِ پالایه
.IR predicate .
به‌طور پیش‌فرض، رتبه‌بندی (ببینید:
.BR \-J )
برای هر معیار به‌صورت مجزا انجام می‌شود.
با گزاره‌ها (predicates)، رتبه‌بندی تنها برای معیارهای
گزارهٔ مشخص‌شده انجام می‌شود.
هنگام گزارش‌دهی، بقیه معیارهایی که دامنه نمونه مشترکی (
.IR "instance domain" \fR؛
ببینید:
.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\-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\-\-zabbix\-port\fR=\fIport\fR
.IR port
سرور Zabbix.
.TP
\fB\-P\fR \fIprecision\fR, \fB\-\-precision\fR=\fIprecision\fR
استفاده از
.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 pcp2zabbix
به‌طور پیوسته (در حالت بلادرنگ) یا تا انتهای مجموعه بایگانی‌های 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
را ببینید..TP
\fB\-T\fR \fIendtime\fR, \fB\-\-finish\fR=\fIendtime\fR
هنگام گزارش معیارهای بایگانی‌شده، گزارش به رکوردهایی محدود می‌شود که پیش از یا در
.I endtime
ثبت شده‌اند. برای شرح کامل نحوِ
.I endtime
به
.BR PCPIntro (1)
مراجعه کنید.
.RS
.PP
هنگامی که برای تعیین مدت‌زمان اجرا پیش از خروج \fBpcp2zabbix\fP استفاده می‌شود، چنانچه هیچ
.I samples
مشخص نشده باشد (به \fB\-s\fP مراجعه کنید)، تعداد نمونه‌های گزارش‌شده به
.I interval
بستگی دارد (به \fB\-t\fP مراجعه کنید). اگر
.I samples
مشخص شده باشد، آن‌گاه
.I interval
به‌گونه‌ای تنظیم خواهد شد که امکان گزارش
.I samples
در طول زمان اجرا فراهم شود. در صورتی که هر سه گزینهٔ
.BR \-T ،
.B \-s
و
.B \-t
داده شده باشند،
.I endtime
مدت‌زمان واقعی اجرای
.B pcp2zabbix
را تعیین می‌کند.
.RE
.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\-x\fR \fIprefix\fR, \fB\-\-zabbix\-prefix\fR=\fIprefix\fR
پیشوندِ (
.IR prefix )
معیارها برای مقادیر اندازه‌گیری‌شدهٔ ارسال‌شده به سرور.
.TP
\fB\-X\fR \fIhostname\fR, \fB\-\-zabbix\-host\fR=\fIhostname\fR
نام میزبانِ (
.IR hostname )
عامل (agent)، همان‌گونه که در frontend زبیکس ثبت شده است.
.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 ،
.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 pcp2zabbix.conf
فایل پیکربندی \fBpcp2zabbix\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 pcp2graphite (1),
.BR pcp2influxdb (1),
.BR pcp2json (1),
.BR pcp2spark (1),
.BR pcp2xlsx (1),
.BR pcp2xml (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 zbxpcp (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 zabbix_interval ignore_incompat precision_force
.\" +ok+ zabbix_prefix zabbix_server invert_filter CGHIjlLnrRvV
.\" +ok+ names_change limit_filter zabbix_host zabbix_port live_filter
.\" +ok+ total_bytes count_scale space_scale type_prefer zabbix_lld metricsets
.\" +ok+ time_scale omit_flat incompat influxdb frontend
.\" +ok+ Zabbix zbxpcp RIC LLD ric lld