'\"macro stdmacro
.\"
.\" Copyright (C) 2015-2021 Marko Myllynen <myllynen@redhat.com>
.\" Copyright (C) 2016-2018,2023 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 PCP2JSON 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pcp2json \- صادرکننده معیارهای کارایی از PCP به JSON
.SH "خلاصه دستور (SYNOPSIS)"
\fBpcp2json\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 pcp2json
یک ابزار قابل‌سفارشی‌سازی برای برون‌بری معیارهای کارایی از PCP به
JSON
است.
هر معیار کارایی موجود، اعم از زنده یا بایگانی‌شده، سیستمی و/یا
برنامه‌ای، می‌تواند با استفاده از آرگومان‌های خط فرمان یا یک فایل پیکربندی برای برون‌بری انتخاب شود.
.PP
دستور
.B pcp2json
یکی از خویشاوندان نزدیک
.BR pmrep (1)
است. برای شرح
.I metricspec
پذیرفته‌شده در خط فرمان
.BR pcp2json ،
به
.BR pmrep (1)
مراجعه کنید. برای شرح نحو فایل پیکربندی
.B pcp2json.conf
به
.BR pmrep.conf (5)
مراجعه کنید. این صفحه گزینه‌های اختصاصی
.B pcp2json
و تفاوت‌های فایل پیکربندی آن با
.BR pmrep.conf (5)
را شرح می‌دهد.
.BR pmrep (1)
همچنین چندین مثال کاربردی را فهرست می‌کند که بیشتر آن‌ها برای
.B pcp2json
نیز قابل استفاده هستند.
.PP
تنها گزینه‌های خط فرمان فهرست‌شده در این صفحه پشتیبانی می‌شوند؛
سایر گزینه‌های موجود برای
.BR pmrep (1)
پشتیبانی نمی‌شوند.
.PP
گزینه‌های تعیین‌شده از طریق مقادیر متغیرهای محیطی (ببینید
.BR pmGetOptions (3))
بر مقادیر پیش‌فرض توکار متناظر (در صورت وجود) اولویت دارند.
گزینه‌های فایل پیکربندی بر متغیرهای محیطی متناظر (در صورت وجود) اولویت دارند.
گزینه‌های خط فرمان بر گزینه‌های متناظر در فایل پیکربندی (در صورت وجود) اولویت دارند..SH "فایل پیکربندی (CONFIGURATION FILE)"
.B pcp2json
از یک فایل پیکربندی با ساختاری که در
.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 گزینه‌های اختصاصی pcp2json
extended (بولی)
.RS 4
اطلاعات گسترده‌ای را درباره معیارها (metrics) می‌نویسد.
گزینه خط فرمان متناظر \fB\-x\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
everything (بولی)
.RS 4
هر آنچه درباره معیارها شناخته شده است، از جمله شناسه‌های داخلی PCP را می‌نویسد.
با این حال، برچسب‌ها برای سازگاری با نسخه‌های پیشین حذف می‌شوند.
برای گنجاندن آن‌ها نیز \fBinclude_labels\fP را فعال کنید.
گزینه خط فرمان متناظر \fB\-X\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
exact_types (بولی)
.RS 4
اعداد را به جای رشته، به عنوان نوع داده عددی می‌نویسد که ممکن است باعث از دست رفتن مقداری از دقت شود.
گزینه خط فرمان متناظر \fB\-E\fP است.
مقدار پیش‌فرض \fBno\fP است.
.RE
.PP
url (رشته)
.RS 4
خروجی JSON را در قالب یک درخواست HTTP POST به \fBurl\fP مشخص‌شده ارسال می‌کند.
گزینه خط فرمان متناظر \fB\-u\fP است.
مقدار پیش‌فرض \fBNone\fP است.
.RE
.PP
http_pass (رشته)
.RS 4
گذرواژه ارائه‌شده را برای احراز هویت پایه‌ای (Basic Authentication) هنگام ارسال یک HTTP POST به کار می‌برد.
گزینه خط فرمان متناظر \fB\-p\fP است.
مقدار پیش‌فرض \fBNone\fP است.
.RE
.PP
http_user (رشته)
.RS 4
نام کاربری ارائه‌شده را برای احراز هویت پایه‌ای (Basic Authentication) هنگام ارسال یک HTTP POST به کار می‌برد.
گزینه خط فرمان متناظر \fB\-U\fP است.
مقدار پیش‌فرض \fBNone\fP است.
.RE
.PP
http_timeout (عدد)
.RS 4
حداکثر زمان (به ثانیه) هنگام ارسال یک HTTP POST.
گزینه خط فرمان متناظر \fB\-o\fP است.
مقدار پیش‌فرض \fB2.5\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 pcp2json
اطلاع دهد.
مقادیر معتبر برای
.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
خواندن بایگانی‌های منبع معیار از
.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\fR
ختم می‌شوند گنجانده خواهند شد.
پیش‌فرض، اولین موردی است که از بین موارد زیر یافت شود:
.IR ./pcp2json.conf ،
.IR \f(CR$HOME\fP/.pcp2json.conf ،
.IR \f(CR$HOME\fP/pcp/pcp2json.conf ،
و
.IR \f(CR$PCP_SYSCONF_DIR\fP/pcp2json.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
معیارهای کارایی مشتق‌شده
.I 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
شامل نکردن معیارهای سراسری (global) در گزارش‌دهی (ببینید
.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
تنها بازیابی و گزارش نمونه‌های (instances) مشخص‌شده از معیار
.IR instances .
به‌طور پیش‌فرض، تمام نمونه‌ها اعم از فعلی و آینده گزارش می‌شوند.
.RS
.PP
برای شرح کامل این گزینه، به
.BR pmrep (1)
مراجعه کنید.
.RE.TP
\fB\-I\fR, \fB\-\-ignore\-incompat\fR
چشم‌پوشی از معیارهای ناسازگار.
به‌طور پیش‌فرض، معیارهای ناسازگار (یعنی نوع آن‌ها پشتیبانی نمی‌شود یا طبق درخواست مقیاس‌پذیر نیستند)
باعث می‌شوند که
.B pcp2json
با یک پیام خطا پایان یابد.
با این گزینه، تمام معیارهای ناسازگار بدون هشدار از گزارش حذف می‌شوند.
این مورد به‌ویژه هنگام درخواست گره‌های غیربرگ درخت PMNS برای گزارش‌گیری سودمند است.
.TP
\fB\-j\fR, \fB\-\-live\-filter\fR
انجام فیلترسازی زندهٔ نمونه‌ها.
این قابلیت امکان ضبط تمام نمونه‌های نام‌گذاری‌شده را فراهم می‌کند، حتی اگر فرآیندها در مقطعی مجدداً راه‌اندازی شوند (برخلاف حالتِ بدون فیلترسازی زنده).
انجام فیلترسازی زنده روی تعداد بسیار زیادی از نمونه‌ها بار پردازشی داخلی ایجاد می‌کند، بنابراین به کاربر توصیه می‌شود احتیاط کند.
همچنین ببینید
.BR \-n .
.TP
\fB\-J\fR \fIrank\fR, \fB\-\-rank\fR=\fIrank\fR
محدود کردن نتایج به بالاترین/پایین‌ترین نمونه‌های دارای
.I rank
از معیارهای چندمقداره.
یک عدد صحیح مثبت، نمونه‌های دارای بالاترین مقدار را در گزارش لحاظ می‌کند.
یک عدد صحیح منفی، نمونه‌های دارای پایین‌ترین مقدار را در گزارش لحاظ می‌کند.
مقدار صفر هیچ رتبه‌بندی‌ای انجام نمی‌دهد.
رتبه‌بندی دلالت بر مرتب‌سازی ندارد، ببینید
.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\-m\fR, \fB\-\-include\-labels\fR
گنجاندن برچسب‌های معیار PCP در خروجی.
.TP
\fB\-N\fR \fIpredicate\fR, \fB\-\-predicate\fR=\fIpredicate\fR
مشخص کردن فهرستی از معیارهای مرجع پالایهٔ
.IR predicate
که با کاما جدا شده‌اند.
به‌طور پیش‌فرض رتبه‌بندی (ببینید
.BR \-J )
برای هر معیار به‌صورت جداگانه انجام می‌شود.
با وجود مسندها (predicates)، رتبه‌بندی تنها برای معیارهای مسند مشخص‌شده انجام می‌گیرد.
هنگام گزارش‌گیری، باقی معیارهایی که دارای
.I دامنهٔ نمونه
مشترک (ببینید
.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 ).
برای شرح کامل ساختار نحوی
.I origin
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-p\fR, \fB\-\-http-pass\fR
گذرواژه هنگام استفاده از احراز هویت اولیهٔ HTTP با گزینهٔ
.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 pcp2json
به‌صورت پیوسته (در حالت بی‌درنگ) یا تا انتهای مجموعهٔ بایگانی‌های PCP (در حالت بایگانی) نمونه‌برداری و گزارش خواهد کرد.
همچنین ببینید
.BR \-T .
.TP
\fB\-S\fR \fIstarttime\fR, \fB\-\-start\fR=\fIstarttime\fR
هنگام گزارش‌گیری از معیارهای بایگانی‌شده، گزارش محدود به رکوردهایی خواهد بود که در زمان
.I starttime
یا پس از آن ثبت شده باشند.
برای شرح کامل ساختار نحوی
.I 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
هنگامی که برای تعیین مدت‌زمان اجرا پیش از خروج \fBpcp2json\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 pcp2json
را تعیین می‌کند.
.RE
.TP
\fB\-u\fR, \fB\-\-url\fR
آدرس URL برای ارسال یک HTTP POST (به جای خروجی استاندارد پیش‌فرض).
.TP
\fB\-U\fR, \fB\-\-http-user\fR
نام کاربری هنگام استفاده از احراز هویت پایه HTTP با گزینهٔ
.BR \-u .
.TP
\fB\-v\fR, \fB\-\-omit\-flat\fR
تنها معیارهای مجموعه‌مقدار (set-valued) دارای نمونه (مانند disk.dev.read) را گزارش کرده و از معیارهای تک‌مقدار «مسطح» بدون نمونه (مانند kernel.all.sysfork) صرف‌نظر می‌کند.
گزینه‌های
.B \-i
و
.BR \-I
را ببینید.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شمارهٔ نسخه و خروج.
.TP
\fB\-x\fR, \fB\-\-with\-extended\fR
نوشتن اطلاعات گسترده.
.TP
\fB\-X\fR, \fB\-\-with\-everything\fR
نوشتن همهٔ اطلاعات شناخته‌شده دربارهٔ معیارها، از جمله شناسه‌های داخلی PCP.
با این حال، برچسب‌ها به دلیل سازگاری با نسخه‌های پیشین حذف می‌شوند؛
برای گنجاندن آن‌ها نیز از \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نخواهد کرد\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 "فایل‌ها (FILES)"
.TP 5
.I pcp2json.conf
فایل پیکربندی \fBpcp2json\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 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 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 space_scale
.\" +ok+ exact_types type_prefer metricsets time_scale omit_flat
.\" +ok+ http_pass http_user datetime incompat influxdb
.\" +ok+ IDs EST