'\"macro stdmacro .\" .\" Copyright (C) 2015-2021 Marko Myllynen .\" 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 PCP2XLSX 1 "PCP" "Performance Co-Pilot" .SH "نام (NAME)" \f3pcp2xlsx\f1 \- صادرکننده معیارهای عملکرد از PCP به XLSX .SH "خلاصه دستور (SYNOPSIS)" \fBpcp2xlsx\fP [\fB\-5CGHILmrRvVz?\fP] [\fB\-4\fP \fIaction\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] [\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\-K\fP \fIspec\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 pcp2xlsx یک ابزار قابل‌سفارشی‌سازی برای صدور معیارهای عملکرد از PCP به XLSX است. هر معیار عملکرد موجود، چه زنده و چه بایگانی‌شده، سیستمی و/یا برنامه‌ای، می‌تواند با استفاده از آرگومان‌های خط فرمان یا یک فایل پیکربندی برای صدور انتخاب شود. .PP .B pcp2xlsx از خویشاوندان نزدیک .BR pmrep (1) است. برای شرح .I metricspec پذیرفته‌شده در خط فرمان .B pcp2xlsx به .BR pmrep (1) مراجعه کنید. برای شرح ساختار نحوی فایل پیکربندی .B pcp2xlsx.conf به .BR pmrep.conf (5) مراجعه نمایید. این صفحه گزینه‌های اختصاصی .B pcp2xlsx و تفاوت‌های فایل پیکربندی آن با .BR pmrep.conf (5) را شرح می‌دهد. .BR pmrep (1) همچنین مثال‌هایی از نحوهٔ استفاده را فهرست می‌کند که بیشتر آن‌ها برای .B pcp2xlsx نیز قابل اعمال هستند. .PP تنها گزینه‌های خط فرمان فهرست‌شده در این صفحه پشتیبانی می‌شوند؛ سایر گزینه‌های موجود برای .BR pmrep (1) پشتیبانی نمی‌شوند. .PP گزینه‌های تعیین‌شده از طریق متغیرهای محیطی (به .BR pmGetOptions (3) مراجعه کنید) بر مقادیر پیش‌فرض توکار متناظر (در صورت وجود) اولویت دارند و جایگزین آن‌ها می‌شوند. گزینه‌های فایل پیکربندی بر متغیرهای محیطی متناظر (در صورت وجود) اولویت دارند. گزینه‌های خط فرمان نیز بر گزینه‌های متناظر در فایل پیکربندی (در صورت وجود) اولویت دارند. .SH "فایل پیکربندی (CONFIGURATION FILE)" .B pcp2xlsx از یک فایل پیکربندی با ساختار نحوی شرح‌داده‌شده در .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 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 گزینه‌های اختصاصی pcp2xlsx هیچ. .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 pcp2xlsx اطلاع می‌دهد. مقادیر مجاز برای .I action عبارتند از \fBupdate\fP (تازه‌سازی متریک‌های در حال نمونه‌برداری)، \fBignore\fP (کاری انجام نده \- رفتار پیش‌فرض) و \fBabort\fP (خروج از برنامه در صورت وقوع چنین رویدادی). .TP \fB\-5\fR, \fB\-\-ignore\-unknown\fR نادیده گرفتن بی‌سروصدای هر نام متریکی که قابل تفکیک نیست. برای شروع به کار ابزار باید حداقل یک متریک پیدا شود. .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 ./pcp2xlsx.conf ، .IR \f(CR$HOME\fP/.pcp2xlsx.conf ، .IR \f(CR$HOME\fP/pcp/pcp2xlsx.conf و .IR \f(CR$PCP_SYSCONF_DIR\fP/pcp2xlsx.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\-G\fR, \fB\-\-no\-globals\fR متریک‌های سراسری (global) را در گزارش لحاظ نکن (ببینید .BR pmrep.conf (5)). .TP \fB\-f\fR \fIformat\fR, \fB\-\-timestamp\-format\fR=\fIformat\fR استفاده از رشته .I format برای قالب‌بندی برچسب زمان (timestamp). این قالب با متد .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 تنها بازیابی و گزارش نمونه‌های .IR instances مشخص‌شده از میان نمونه‌های متریک موجود در حال حاضر. به‌طور پیش‌فرض تمام نمونه‌های فعلی گزارش می‌شوند. .RS .PP برای شرح کامل این گزینه به .BR pmrep (1) مراجعه کنید. .RE .TP \fB\-I\fR, \fB\-\-ignore\-incompat\fR نادیده گرفتن متریک‌های ناسازگار. به‌طور پیش‌فرض، متریک‌های ناسازگار (یعنی نوع آن‌ها پشتیبانی نمی‌شود یا طبق درخواست قابل مقیاس‌بندی نیستند) باعث می‌شوند .B pcp2xlsx با یک پیام خطا متوقف شود. با این گزینه، تمام متریک‌های ناسازگار بی‌سروصدا از گزارش‌گیری حذف می‌شوند. این امر به‌ویژه هنگام درخواست گره‌های غیربرگ (non-leaf) از درخت PMNS برای گزارش مفید است. .TP \fB\-K\fR \fIspec\fR, \fB\-\-spec\-local\fR=\fIspec\fR هنگام واکشی متریک‌ها از یک بافت (context) محلی (ببینید .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\-m\fR, \fB\-\-include\-labels\fR گنجاندن برچسب‌های متریک PCP در خروجی..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 برابر با 0 باشد یا .B \-s مشخص نشده باشد، .B pcp2xlsx به‌طور پیوسته (در حالت زمان‌واقعی) یا تا انتهای مجموعه‌ی آرشیوهای 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 هنگام گزارش معیارهای آرشیو شده، گزارش به رکوردهایی محدود خواهد شد که در زمان .IR endtime یا پیش از آن ثبت شده باشند. برای توضیحات کامل درباره نحو .IR endtime به .BR PCPIntro (1) مراجعه کنید. .RS .PP هنگامی که از این گزینه برای تعیین مدت زمان اجرا پیش از خروج \fBpcp2xlsx\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 pcp2xlsx را تعیین می‌کند. .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\-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 pcp2xlsx.conf فایل پیکربندی \fBpcp2xlsx\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) مراجعه کنید. .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 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+ count_scale_force space_scale_force time_scale_force ignore_incompat .\" +ok+ precision_force include_labels names_change .\" +ok+ CGHILmrRvVz {from -5CGHILmrRvVz that confuses ispell} .\" +ok+ count_scale space_scale type_prefer metricsets time_scale .\" +ok+ omit_flat datetime incompat influxdb XLSX .\" +ok+ EST