'\"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 PCP2XML 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pcp2xml \- صادرکننده معیارهای کارایی PCP به فرمت XML
.SH "خلاصه دستور (SYNOPSIS)"
\fBpcp2xml\fP
[\fB\-5CGHIjLmnrRvVxXz?\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 \fIorigin\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\-y\fP|\fB\-Y\fP \fItime-scale\fP]
[\fB\-Z\fP \fItimezone\fP]
\fImetricspec\fP
[...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp2xml
ابزاری قابل سفارشی‌سازی برای صادر کردن معیارهای کارایی از PCP به
XML
است.
هر معیار کارایی موجود، زنده یا بایگانی‌شده، سیستمی یا برنامه‌ای،
می‌تواند برای صدور با استفاده از آرگومان‌های خط فرمان یا یک فایل پیکربندی انتخاب شود.
.PP
دستور
.B pcp2xml
ارتباط نزدیکی با
.BR pmrep (1)
دارد.
برای شرح
.I metricspec
پذیرفته‌شده در خط فرمان
.BR pcp2xml ،
به
.BR pmrep (1)
مراجعه کنید.
برای شرح نحو فایل پیکربندی
.B pcp2xml.conf
صفحه راهنمای
.BR pmrep.conf (5)
را ببینید.
این صفحه راهنما، گزینه‌های اختصاصی
.B pcp2xml
و تفاوت‌های فایل پیکربندی آن با
.BR pmrep.conf (5)
را توصیف می‌کند.
همچنین
.BR pmrep (1)
نمونه‌های متعددی از کاربرد را فهرست می‌کند که بیشتر آن‌ها برای
.B pcp2xml
نیز قابل استفاده هستند.
.PP
تنها گزینه‌های خط فرمان فهرست‌شده در این صفحه پشتیبانی می‌شوند؛
سایر گزینه‌های موجود برای
.BR pmrep (1)
پشتیبانی نمی‌شوند.
.PP
گزینه‌های اعمال‌شده از طریق مقادیر محیطی (نگاه کنید به
.BR pmGetOptions (3))
بر مقادیر پیش‌فرض داخلی متناظر (در صورت وجود) تقدم دارند.
گزینه‌های فایل پیکربندی بر متغیرهای محیطی متناظر (در صورت وجود) مقدم هستند.
گزینه‌های خط فرمان نیز بر گزینه‌های فایل پیکربندی متناظر (در صورت وجود) اولویت دارند.
.SH "فایل پیکربندی (CONFIGURATION FILE)"
دستور
.B pcp2xml
از یک فایل پیکربندی با نحو توصیف‌شده در
.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 "گزینه‌های اختصاصی pcp2xml"
extended (بولی)
.RS 4
نوشتن اطلاعات گسترش‌یافته درباره معیارها.
گزینه خط فرمان متناظر
\fB\-x\fP
است.
پیش‌فرض
\fBno\fP
است.
.RE
.PP
everything (بولی)
.RS 4
نوشتن تمام اطلاعات شناخته‌شده درباره معیارها، از جمله شناسه‌های داخلی PCP.
با این حال برچسب‌ها برای سازگاری با گذشته حذف شده‌اند.
برای گنجاندن آن‌ها نیز گزینه
\fBinclude_labels\fP
را فعال کنید.
گزینه خط فرمان متناظر
\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
مشخص می‌کند که هنگام دریافت رویداد تغییر نام معیارها در حین نمونه‌برداری، چه عملیاتی
.RI ( action )
انجام شود.
این رویدادها زمانی رخ می‌دهند که یک PMDA مدتی پس از راه‌اندازی، معیارهای جدیدی را کشف کرده و به ابزارهای کلاینت در حال اجرا مانند
.BR pcp2xml
اطلاع می‌دهد.
مقادیر معتبر برای
.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
.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 ./pcp2xml.conf ،
.IR \f(CR$HOME\fP/.pcp2xml.conf ،
.IR \f(CR$HOME\fP/pcp/pcp2xml.conf
و
.IR \f(CR$PCP_SYSCONF_DIR\fP/pcp2xml.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
مشخص کردن معیارهای کارایی مشتق‌شده
.RI ( derived ).
اگر
.I derived
با یک اسلش (``/'') یا با یک نقطه (``.'') شروع شود، به عنوان یک فایل پیکربندی معیارهای مشتق‌شده PCP تفسیر خواهد شد؛ در غیر این صورت به عنوان عبارات معیارهای مشتق‌شده جداشده با کاما یا نقطه‌ویرگول تفسیر می‌شود.
برای شرح کامل معیارهای مشتق‌شده و فایل‌های پیکربندی معیارهای مشتق‌شده PCP به
.BR pmLoadDerivedConfig (3)
و
.BR pmRegisterDerived (3)
مراجعه کنید.
همچنین، استفاده از نحو پیکربندی
.BR pmrep.conf (5)
اجازه می‌دهد معیارهای مشتق‌شده را به عنوان بخشی از مجموعه‌معیارها (metricsets) تعریف کنید.
.RS
.PP
در صورت بروز مشکل در معیارهای مشتق‌شده، صفحات راهنمای یادشده را به دقت مرور کنید و مطمئن شوید که تمام معیارهای مورد نیاز در دسترس هستند، به ویژه هنگام استفاده از بایگانی‌ها.
از
.B \-Dderive
برای مشاهده اطلاعات اشکال‌زدایی بیشتر درباره تجزیه معیارهای مشتق‌شده استفاده کنید.
.RE
.TP
\fB\-G\fR, \fB\-\-no\-globals\fR
عدم گنجاندن معیارهای سراسری در گزارش (نگاه کنید به
.BR pmrep.conf (5)).
.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\-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
بازیابی و گزارش تنها نمونه‌های
.RI ( instances )
مشخص‌شده از معیار.
به طور پیش‌فرض تمام نمونه‌ها، چه فعلی و چه آینده، گزارش می‌شوند.
.RS
.PP
برای شرح کامل این گزینه به
.BR pmrep (1)
مراجعه کنید.
.RE
.TP
\fB\-I\fR, \fB\-\-ignore\-incompat\fR
نادیده گرفتن معیارهای ناسازگار.
به طور پیش‌فرض معیارهای ناسازگار (یعنی نوع آن‌ها پشتیبانی نمی‌شود یا مقیاس آن‌ها طبق درخواست تغییر نمی‌کند) باعث توقف
.B pcp2xml
با یک پیام خطا می‌شوند.
با این گزینه، تمام معیارهای ناسازگار بی سر و صدا از گزارش حذف می‌شوند.
این ویژگی ممکن است به ویژه هنگام درخواست گره‌های غیربرگ درخت PMNS برای گزارش‌دهی مفید باشد.
.TP
\fB\-j\fR, \fB\-\-live\-filter\fR
انجام فیلترسازی زنده نمونه‌ها.
این قابلیت امکان ضبط تمام نمونه‌های نام‌گذاری‌شده را فراهم می‌کند حتی اگر فرآیندها در مقطعی مجدداً راه‌اندازی شوند (برخلاف حالت بدون فیلتر زنده).
انجام فیلترسازی زنده روی تعداد بسیار زیادی از نمونه‌ها سربار داخلی اضافه خواهد کرد، بنابراین احتیاط کاربر توصیه می‌شود.
همچنین نگاه کنید به
.BR \-n .
.TP
\fB\-J\fR \fIrank\fR, \fB\-\-rank\fR=\fIrank\fR
محدود کردن نتایج به بالاترین/پایین‌ترین نمونه‌های رتبه‌بندی‌شده
.RI ( rank ed)
از معیارهای چندمقداری.
یک عدد صحیح مثبت، نمونه‌هایی با بالاترین مقدار را در گزارش لحاظ می‌کند.
یک عدد صحیح منفی، نمونه‌هایی با پایین‌ترین مقدار را در گزارش لحاظ می‌کند.
مقدار صفر هیچ رتبه‌بندی انجام نمی‌دهد.
رتبه‌بندی به معنای مرتب‌سازی نیست، نگاه کنید به
.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\-\-local\-PMDA\fR
استفاده از یک بافت محلی برای جمع‌آوری معیارها از PMDAهای DSO روی میزبان محلی بدون PMCD.
همچنین نگاه کنید به
.BR \-K .
.TP
\fB\-m\fR, \fB\-\-include\-labels\fR
گنجاندن برچسب‌های معیار PCP در خروجی.
.TP
\fB\-n\fR, \fB\-\-invert\-filter\fR
انجام رتبه‌بندی پیش از فیلترسازی زنده.
به طور پیش‌فرض فیلترسازی زنده نمونه‌ها (در صورت درخواست، نگاه کنید به
.BR \-j )
پیش از رتبه‌بندی نمونه‌ها (در صورت درخواست، نگاه کنید به
.BR \-J )
انجام می‌شود.
با این گزینه منطق وارونه شده و رتبه‌بندی پیش از فیلترسازی زنده رخ می‌دهد.
.TP
\fB\-N\fR \fIpredicate\fR, \fB\-\-predicate\fR=\fIpredicate\fR
مشخص کردن یک فهرست جداشده با کاما از معیارهای مرجع فیلتر گزاره‌ای
.RI ( predicate ).
به طور پیش‌فرض رتبه‌بندی (نگاه کنید به
.BR \-J )
برای هر معیار به طور جداگانه صورت می‌گیرد.
با گزاره‌ها، رتبه‌بندی تنها برای معیارهای گزاره‌ای مشخص‌شده انجام می‌شود.
هنگام گزارش‌دهی، بقیه معیارهایی که دامنه نمونه یکسانی دارند
.RI ( "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 \fIorigin\fR, \fB\-\-origin\fR=\fIorigin\fR
هنگام گزارش معیارهای بایگانی‌شده، شروع گزارش در مبدأ
.I origin
درون پنجره زمانی (نگاه کنید به
.B \-S
و
.BR \-T ).
برای شرح کامل نحو
.IR origin ،
به
.BR PCPIntro (1)
مراجعه کنید.
.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
برابر ۰ باشد یا
.B \-s
مشخص نشده باشد،
.B pcp2xml
به طور مداوم (در حالت بلادرنگ) یا تا انتهای مجموعه بایگانی‌های PCP (در حالت بایگانی) نمونه‌برداری و گزارش خواهد کرد.
همچنین نگاه کنید به
.BR \-T .
.TP
\fB\-S\fR \fIstarttime\fR, \fB\-\-start\fR=\fIstarttime\fR
هنگام گزارش معیارهای بایگانی‌شده، گزارش محدود به رکوردهایی خواهد بود که در زمان
.I 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
یا در همان زمان ثبت شده‌اند.
برای شرح کامل نحو
.IR endtime ،
به
.BR PCPIntro (1)
مراجعه کنید.
.RS
.PP
هنگامی که برای تعیین مدت زمان اجرا پیش از خروج \fBpcp2xml\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 pcp2xml
را تعیین می‌کند.
.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, \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 pcp2xml.conf
فایل پیکربندی \fBpcp2xml\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 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+ time_scale_force CGHIjLmnrRvVxXz ignore_incompat precision_force
.\" +ok+ include_labels invert_filter names_change limit_filter
.\" +ok+ live_filter total_bytes count_scale space_scale type_prefer
.\" +ok+ metricsets time_scale omit_flat datetime incompat
.\" +ok+ influxdb IDs EST