'\"macro stdmacro
.\"
.\" Copyright (C) 2024 Lauren Chilton <lchilton@redhat.com>
.\" Copyright (C) 2024 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 PCP2OPENMETRICS 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp2openmetrics\f1 \- صادرکننده معیارهای کارایی PCP به OpenMetrics
.SH "خلاصه دستور (SYNOPSIS)"
\fBpcp2openmetrics\fP
[\fB\-5CEGHIjLmnrRvVxXz?\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\-f\fP \fIformat\fP]
[\fB\-F\fP \fIoutfile\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 \fItimeout\fP]
[\fB\-O\fP \fIorigin\fP]
[\fB\-p\fP \fIpassword\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\-u\fP \fIurl\fP]
[\fB\-U\fP \fIusername\fP]
[\fB\-y\fP|\fB\-Y\fP \fItime-scale\fP]
[\fB\-Z\fP \fItimezone\fP]
\fImetricspec\fP
[...]
.SH "توضیحات (DESCRIPTION)"
.B pcp2openmetrics
یک ابزار سفارشی‌پذیر برای صدور معیارهای کارایی از PCP به قالب
Open Metrics \-
.I https://openmetrics.io
\- است.
هر معیار کارایی موجود، چه به‌صورت زنده یا بایگانی‌شده، سیستمی و/یا برنامه‌ای را می‌توان با استفاده از آرگومان‌های خط فرمان یا یک فایل پیکربندی برای صدور انتخاب کرد.
.PP
.B pcp2openmetrics
ارتباط بسیار نزدیکی با
.BR pmrep (1)
دارد.
برای مشاهده شرح
.I metricspec
پذیرفته‌شده در خط فرمان
.BR pcp2openmetrics ،
به
.BR pmrep (1)
مراجعه کنید.
برای شرح نحو ساختار فایل پیکربندی
.B pcp2openmetrics.conf
به
.BR pmrep.conf (5)
مراجعه کنید.
این صفحه گزینه‌های اختصاصی
.B pcp2openmetrics
و تفاوت‌های فایل پیکربندی آن با
.BR pmrep.conf (5)
را توضیح می‌دهد.
همچنین
.BR pmrep (1)
چندین مثال کاربردی را فهرست کرده است که اغلب آن‌ها برای
.B pcp2openmetrics
نیز قابل استفاده هستند.
.PP
تنها گزینه‌های خط فرمان فهرست‌شده در این صفحه پشتیبانی می‌شوند؛ سایر گزینه‌های موجود برای
.BR pmrep (1)
پشتیبانی نمی‌شوند.
.PP
گزینه‌های اعمال‌شده از طریق مقادیر محیطی (ببینید
.BR pmGetOptions (3))
بر مقادیر پیش‌فرض توکار متناظر (در صورت وجود) تقدم دارند.
گزینه‌های فایل پیکربندی بر متغیرهای محیطی متناظر (در صورت وجود) تقدم دارند.
گزینه‌های خط فرمان بر گزینه‌های متناظر در فایل پیکربندی (در صورت وجود) تقدم دارند..SH "فایل پیکربندی (CONFIGURATION FILE)"
.B pcp2openmetrics
از یک فایل پیکربندی با ساختار نحوی شرح داده شده در
.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 include_labels ,
.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 گزینه‌های اختصاصی pcp2openmetrics
everything (boolean)
.RS 4
نوشتن تمام اطلاعات شناخته‌شده درباره متریک‌ها، شامل شناسه‌های داخلی PCP.
با این حال، برچسب‌ها برای حفظ سازگاری با نسخه‌های پیشین حذف می‌شوند.
برای گنجاندن آن‌ها نیز \fBinclude_labels\fP را فعال کنید.
گزینه متناظر در خط فرمان \fB\-X\fP است.
پیش‌فرض \fBno\fP است.
.RE
.PP
exact_types (boolean)
.RS 4
نوشتن اعداد در قالب انواع داده عددی و نه به صورت رشته، که ممکن است
موجب از دست رفتن مقداری از دقت شود.
گزینه متناظر در خط فرمان \fB\-E\fP است.
پیش‌فرض \fBno\fP است.
.RE
.PP
url (string)
.RS 4
ارسال خروجی OPENMETRICS در قالب درخواست HTTP POST به \fBurl\fP داده‌شده.
گزینه متناظر در خط فرمان \fB\-u\fP است.
پیش‌فرض \fBNone\fP است.
.RE
.PP
http_pass (string)
.RS 4
استفاده از گذرواژه داده‌شده برای احراز هویت اولیه (Basic Authentication) هنگام ارسال یک HTTP POST.
گزینه متناظر در خط فرمان \fB\-p\fP است.
پیش‌فرض \fBNone\fP است.
.RE
.PP
http_user (string)
.RS 4
استفاده از نام کاربری داده‌شده برای احراز هویت اولیه (Basic Authentication) هنگام ارسال یک HTTP POST.
گزینه متناظر در خط فرمان \fB\-U\fP است.
پیش‌فرض \fBNone\fP است.
.RE
.PP
http_timeout (number)
.RS 4
حداکثر زمان (به ثانیه) هنگام ارسال یک HTTP POST.
گزینه متناظر در خط فرمان \fB\-o\fP است.
پیش‌فرض \fB2.5\fP ثانیه است.
.RE
.PP
no-comment (boolean)
.RS 4
حذف خط توضیح # PCP5. سرآیند برخی از داده‌های متریک
مانند type ،instance domain و semantics را حذف می‌کند.
گزینه متناظر در خط فرمان \fB\-x\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 pcp2openmetrics
اطلاع می‌دهد.
مقادیر معتبر برای
.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 ./pcp2openmetrics.conf ،
.IR \f(CR$HOME\fP/.pcp2openmetrics.conf ،
.IR \f(CR$HOME\fP/pcp/pcp2openmetrics.conf
و
.IR \f(CR$PCP_SYSCONF_DIR\fP/pcp2openmetrics.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
اجرا به صورت دیمن (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, \fB\-\-exact\-types\fR
نوشتن اعداد در قالب انواع داده عددی و نه به عنوان رشته، که ممکن است باعث از دست رفتن مقداری از دقت شود.
.TP
\fB\-f\fR \fIformat\fR, \fB\-\-timestamp\-format\fR=\fIformat\fR
استفاده از رشته
.I format
برای قالب‌بندی برچسب زمان.
این قالب با متد
.B datetime.strftime
پایتون استفاده خواهد شد که تا حد زیادی مشابه موارد شرح‌داده‌شده در
.BR strftime (3)
است.
پیش‌فرض
.BR "%Y-%m-%d %H:%M:%S"
است.
.TP
\fB\-F\fR \fIoutfile\fR, \fB\-\-output\-file\fR=\fIoutfile\fR
مشخص کردن فایل خروجی
.IR outfile .
.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\-i\fR \fIinstances\fR, \fB\-\-instances\fR=\fIinstances\fR
بازیابی و گزارش تنها آن دسته از نمونه‌های سنجه که در
.I instances
مشخص شده‌اند.
به طور پیش‌فرض تمام نمونه‌ها، چه موجود و چه در آینده، گزارش می‌شوند.
.RS
.PP
برای توضیحات کامل این گزینه به
.BR pmrep (1)
مراجعه کنید.
.RE.TP
\fB\-I\fR, \fB\-\-ignore\-incompat\fR
نادیده گرفتن سنجه‌های ناسازگار.
به‌طور پیش‌فرض، سنجه‌های ناسازگار (یعنی نوع آن‌ها پشتیبانی نمی‌شود یا طبق درخواست مقیاس‌پذیر نیستند) موجب می‌شوند که
.B pcp2openmetrics
با یک پیام خطا متوقف شود.
با این گزینه، تمام سنجه‌های ناسازگار بدون هیچ پیامی از گزارش‌دهی حذف می‌شوند.
این موضوع به‌ویژه هنگام درخواست گره‌های غیربرگ درخت PMNS برای گزارش‌دهی می‌تواند مفید باشد.
.TP
\fB\-j\fR, \fB\-\-live\-filter\fR
انجام فیلتر زندهٔ نمونه‌ها (instances).
این امکان را فراهم می‌کند تا همهٔ نمونه‌های نام‌گذاری‌شده ثبت شوند، حتی اگر فرایندها در نقطه‌ای مجدداً راه‌اندازی شوند (برخلاف حالت بدون فیلتر زنده).
انجام فیلتر زنده روی تعداد بسیار زیادی از نمونه‌ها سربار داخلی ایجاد می‌کند، بنابراین احتیاط کاربر توصیه می‌شود.
همچنین ببینید:
.BR \-n .
.TP
\fB\-J\fR \fIrank\fR, \fB\-\-rank\fR=\fIrank\fR
محدود کردن نتایج به بالاترین/پایین‌ترین نمونه‌های رتبه‌بندی‌شده بر اساس
.I rank
از سنجه‌های چندمقداری (set-valued).
یک عدد صحیح مثبت، نمونه‌هایی با بالاترین مقدار را در گزارش‌دهی می‌گنجاند.
یک عدد صحیح منفی، نمونه‌هایی با کمترین مقدار را در گزارش‌دهی می‌گنجاند.
مقدار صفر هیچ رتبه‌بندی‌ای انجام نمی‌دهد.
رتبه‌بندی به معنای مرتب‌سازی نیست، ببینید:
.BR \-6 .
همچنین ببینید:
.BR \-8 .
.TP
\fB\-K\fR \fIspec\fR, \fB\-\-spec\-local\fR=\fIspec\fR
هنگام واکشی سنجه‌ها از یک بافت محلی (ببینید:
.BR \-L )،
گزینهٔ
.B \-K
می‌تواند برای کنترل PMDAهای DSO که باید در دسترس قرار گیرند استفاده شود.
آرگومان
.I spec
از نحو شرح‌داده‌شده در
.BR pmSpecLocalPMDA (3)
پیروی می‌کند.
می‌توان بیش از یک گزینهٔ
.B \-K
را استفاده کرد.
.TP
\fB\-l\fR, \fB\-\-times\fR
حالت برچسب زمانی زنده. در صورت پیکربندی، مقادیر سنجه‌ها با برچسب زمانی متناظرشان همراه می‌شوند.
.TP
\fB\-L\fR, \fB\-\-local\-PMDA\fR
استفاده از یک بافت محلی برای جمع‌آوری سنجه‌ها از PMDAهای DSO روی میزبان محلی بدون PMCD.
همچنین ببینید:
.BR \-K .
.TP
\fB\-n\fR, \fB\-\-invert\-filter\fR
انجام رتبه‌بندی پیش از فیلتر زنده.
به‌طور پیش‌فرض، فیلتر زندهٔ نمونه‌ها (در صورت درخواست، ببینید:
.BR \-j )
پیش از رتبه‌بندی نمونه‌ها (در صورت درخواست، ببینید:
.BR \-J )
رخ می‌دهد.
با این گزینه، منطق معکوس شده و رتبه‌بندی پیش از فیلتر زنده انجام می‌گیرد.
.TP
\fB\-m\fR, \fB\-\-include\-labels\fR
گنجاندن برچسب‌های سنجه‌های PCP در خروجی.
.TP
\fB\-N\fR \fIpredicate\fR, \fB\-\-predicate\fR=\fIpredicate\fR
مشخص کردن فهرستی از سنجه‌های مرجع فیلتر
.I predicate
که با کاما از هم جدا شده‌اند.
به‌طور پیش‌فرض رتبه‌بندی (ببینید:
.BR \-J )
برای هر سنجه به‌طور جداگانه انجام می‌شود.
با گزاره‌ها (predicates)، رتبه‌بندی تنها برای سنجه‌های گزارهٔ مشخص‌شده انجام می‌گیرد.
هنگام گزارش‌دهی، بقیهٔ سنجه‌هایی که دارای همان
.I 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\-o\fR, \fB\-\-http-timeout\fR
زمان انتظار (به ثانیه) هنگام ارسال یک HTTP POST با گزینهٔ
.BR \-u .
مقدار پیش‌فرض \fB2.5\fP ثانیه است.
.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\-\-http-pass\fR
گذرواژه هنگام استفاده از احراز هویت اولیه HTTP (basic authentication) با گزینهٔ
.BR \-u .
.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
ارائه مقادیر خام سنجه در خروجی؛ شمارنده‌های تجمعی به نرخ (rate) تبدیل نمی‌شوند.
این گزینه مشخصات احتمالی اختصاصی برای هر سنجه را بازنویسی \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
برابر ۰ باشد یا
.B \-s
مشخص نشده باشد،
.B pcp2openmetrics
به صورت پیوسته (در حالت بلادرنگ) یا تا انتهای مجموعه بایگانی‌های 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
هنگامی که برای تعیین مدت‌زمان اجرا پیش از خروج \fBpcp2openmetrics\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 pcp2openmetrics
را تعیین می‌کند.
.RE
.TP
\fB\-u\fR, \fB\-\-url\fR
آدرس URL برای ارسال یک HTTP POST (به جای خروجی استاندارد پیش‌فرض).
.TP
\fB\-U\fR, \fB\-\-http-user\fR
نام کاربری هنگام استفاده از احراز هویت اولیه HTTP (basic authentication) با گزینه
.BR \-u .
.TP
\fB\-v\fR, \fB\-\-omit\-flat\fR
تنها گزارش معیارهای مجموعه‌مقدار (set-valued) دارای نمونه (مانند disk.dev.read) و
صرف‌نظر از معیارهای تک‌مقداری «تخت» (flat) بدون نمونه (مانند
kernel.all.sysfork).
به
.B \-i
و
.BR \-I
مراجعه کنید.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-x\fR, \fB\-\-no\-comment\fR
صرف‌نظر کردن از خط توضیح # PCP5
.TP
\fB\-X\fR, \fB\-\-with\-everything\fR
نوشتن همه اطلاعات شناخته‌شده درباره معیارها، از جمله شناسه‌های داخلی PCP.
با این حال برچسب‌ها (labels) برای سازگاری با نسخه‌های پیشین حذف می‌شوند؛
برای گنجاندن آن‌ها نیز از \fB\-m\fP استفاده کنید.
.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نمی‌کند\fR.
همچنین
.BR pmParseUnitsStr (3)
را ببینید.
.TP
\fB\-Y\fR \fIscale\fR, \fB\-\-time\-scale\-force\fR=\fIscale\fR
مشابه
.B \-y
است، اما این گزینه تنظیمات مختص هر معیار را بازنویسی \fIخواهد کرد\fR.
.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 "فایل‌ها (FILES)"
.TP 5
.I pcp2openmetrics.conf
فایل پیکربندی \fBpcp2openmetrics\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 pcp2spark (1),
.BR pcp2xlsx (1),
.BR pcp2xml (1),
.BR pcp2json (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)
و
.BR environ (7).

.\" control lines for scripts/man-spell
.\" +ok+ limit_filter_force count_scale_force space_scale_force
.\" +ok+ CEGHIjLmnrRvVxXz {from -5CEGHIjLmnrRvVxXz confuses ispell}
.\" +ok+ time_scale_force ignore_incompat precision_force
.\" +ok+ include_labels invert_filter names_change limit_filter
.\" +ok+ http_timeout live_filter total_bytes count_scale
.\" +ok+ space_scale exact_types type_prefer metricsets time_scale
.\" +ok+ omit_flat http_pass http_user datetime incompat influxdb
.\" +ok+ IDs EST