'\"macro stdmacro .\" .\" Copyright (C) 2015-2021 Marko Myllynen .\" Copyright (C) 2016-2018,2022 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 PCP2ELASTICSEARCH 1 "PCP" "Performance Co-Pilot" .SH "نام (NAME)" \f3pcp2elasticsearch\f1 \- صادرکننده معیارهای کارایی از PCP به Elasticsearch .SH "خلاصه دستور (SYNOPSIS)" \fBpcp2elasticsearch\fP [\fB\-5CGHIjLmnrRvV?\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\-g\fP \fIURL\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 \fItype\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 \fIindex\fP] [\fB\-X\fP \fIhostid\fP] [\fB\-y\fP|\fB\-Y\fP \fItime-scale\fP] \fImetricspec\fP [...] .SH "توضیحات (DESCRIPTION)" دستور .B pcp2elasticsearch ابزاری قابل‌سفارشی‌سازی برای صدور معیارهای کارایی از PCP به Elasticsearch است. هر معیار کارایی موجود، اعم از زنده یا بایگانی‌شده، سیستمی و/یا برنامه‌ای، می‌تواند با استفاده از آرگومان‌های خط فرمان یا یک فایل پیکربندی برای صدور انتخاب شود. .PP .B pcp2elasticsearch ارتباط بسیار نزدیکی با .BR pmrep (1) دارد. برای مشاهده توضیحات .I metricspec پذیرفته‌شده در خط فرمان .BR pcp2elasticsearch ، به .BR pmrep (1) مراجعه کنید. برای شرح ساختار نحوی فایل پیکربندی .B pcp2elasticsearch.conf به .BR pmrep.conf (5) مراجعه کنید. این صفحه گزینه‌های اختصاصی .B pcp2elasticsearch و تفاوت‌های فایل پیکربندی آن با .BR pmrep.conf (5) را شرح می‌دهد. همچنین .BR pmrep (1) چندین مثال کاربردی را فهرست می‌کند که اکثر آن‌ها در .B pcp2elasticsearch نیز قابل استفاده هستند. .PP تنها گزینه‌های خط فرمانی که در این صفحه فهرست شده‌اند پشتیبانی می‌شوند؛ سایر گزینه‌های موجود در .BR pmrep (1) پشتیبانی نمی‌شوند. .PP گزینه‌های تعیین‌شده از طریق متغیرهای محیطی (نگاه کنید به .BR pmGetOptions (3)) بر مقادیر پیش‌فرض داخلی متناظر (در صورت وجود) اولویت دارند. گزینه‌های فایل پیکربندی بر متغیرهای محیطی متناظر (در صورت وجود) مقدم هستند. گزینه‌های خط فرمان نیز بر گزینه‌های فایل پیکربندی متناظر (در صورت وجود) اولویت دارند..SH "فایل پیکربندی (CONFIGURATION FILE)" دستور .B pcp2elasticsearch از یک فایل پیکربندی با ساختار نحوی شرح داده‌شده در .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 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 "گزینه‌های اختصاصی pcp2elasticsearch" es_server (رشته) .RS 4 نشانی اینترنتی (URL) سنجه‌های سرور Elasticsearch مقصد را مشخص می‌کند. گزینهٔ خط فرمان متناظر \fB\-g\fP است. پیش‌فرض \fBhttp://localhost:9200\fP است. .RE .PP es_auth (رشته) .RS 4 نام کاربری مورد استفاده برای درخواست‌های Elasticsearch را مشخص می‌کند. پیش‌فرض none است. .RE .PP es_password (رشته) .RS 4 گذرواژهٔ مورد استفاده برای درخواست‌های Elasticsearch را مشخص می‌کند. پیش‌فرض none است. .RE .PP es_index (رشته) .RS 4 شاخص (index) مورد استفاده در Elasticsearch را برای نام‌های سنجه مشخص می‌کند. گزینهٔ خط فرمان متناظر \fB\-x\fP است. پیش‌فرض \fBpcp\fP است. .RE .PP es_hostid (رشته) .RS 4 شناسهٔ میزبان (host-id) مورد استفاده در Elasticsearch را برای اندازه‌گیری‌ها مشخص می‌کند. گزینهٔ خط فرمان متناظر \fB\-X\fP است. پیش‌فرض، میزبان منبع سنجه‌ها است. .RE .PP es_search_type (رشته) .RS 4 نوع جستجوی (search type) مورد استفاده در Elasticsearch را برای اندازه‌گیری‌ها مشخص می‌کند. گزینهٔ خط فرمان متناظر \fB\-p\fP است. پیش‌فرض \fBpcp\-metric\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 pcp2elasticsearch اطلاع می‌دهد. مقادیر معتبر برای .I action عبارتند از \fBupdate\fP (تازه‌سازی سنجه‌های در حال نمونه‌برداری)، \fBignore\fP (کاری انجام نده \- رفتار پیش‌فرض) و \fBabort\fP (خروج از برنامه در صورت وقوع چنین رویدادی). .TP \fB\-5\fR, \fB\-\-ignore\-unknown\fR نادیده گرفتن بدون هشدار هر نام سنجه‌ای که قابل حل (resolve) نباشد. برای شروع به کار ابزار، حداقل باید یک سنجه یافت شود. .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 ./pcp2elasticsearch.conf ، .IR \f(CR$HOME\fP/.pcp2elasticsearch.conf ، .IR \f(CR$HOME\fP/pcp/pcp2elasticsearch.conf و .IR \f(CR$PCP_SYSCONF_DIR\fP/pcp2elasticsearch.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 اجرا به‌صورت دیمن (daemon) در زمان راه‌اندازی. .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 \fIURL\fR, \fB\-\-es\-host\fR=\fIURL\fR .IR URL سنجهٔ سرور Elasticsearch مقصد. .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 pcp2elasticsearch با یک پیام خطا متوقف شود. با این گزینه، تمام سنجه‌های ناسازگار بدون هشدار از گزارش‌دهی حذف می‌شوند. این امر ممکن است به‌ویژه هنگام درخواست گره‌های غیربرگ درخت PMNS برای گزارش‌دهی مفید باشد. .TP \fB\-j\fR, \fB\-\-live\-filter\fR انجام پالایش زندهٔ نمونه‌ها (live filtering). این ویژگی اجازه می‌دهد همهٔ نمونه‌های نام‌گذاری‌شده ثبت شوند، حتی اگر فرایندها در نقطه‌ای مجدداً راه‌اندازی شوند (برخلاف حالت بدون پالایش زنده). انجام پالایش زنده بر روی تعداد بسیار زیادی از نمونه‌ها سربار داخلی ایجاد می‌کند، بنابراین احتیاط کاربر توصیه می‌شود. همچنین ببینید: .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 برای کنترل آن دسته از PMDAهای DSO که باید در دسترس قرار گیرند، استفاده کرد. آرگومان .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\-n\fR, \fB\-\-invert\-filter\fR انجام رتبه‌بندی پیش از پالایش زنده. به‌طور پیش‌فرض، پالایش زندهٔ نمونه‌ها (در صورت درخواست، ببینید: .BR \-j ) پیش از رتبه‌بندی نمونه‌ها (در صورت درخواست، ببینید: .BR \-J ) انجام می‌شود. با این گزینه، این منطق معکوس شده و رتبه‌بندی پیش از پالایش زنده انجام می‌شود. .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 \fIorigin\fR, \fB\-\-origin\fR=\fIorigin\fR هنگام گزارش سنجه‌های بایگانی‌شده، شروع گزارش‌دهی در .I origin درون بازهٔ زمانی باشد (ببینید: .B \-S و .BR \-T ). برای توضیحات کامل نحو .IR origin ، به .BR PCPIntro (1) مراجعه کنید. .TP \fB\-p\fR \fItype\fR, \fB\-\-es\-search\-type\fR=\fItype\fR .I type جستجوی Elasticsearch برای اندازه‌گیری‌ها. .TP \fB\-P\fR \fIprecision\fR, \fB\-\-precision\fR=\fIprecision\fR استفاده از .I precision برای مقادیر خروجی عددی غیرصحیح (اعشاری). پیش‌فرض، استفاده از ۳ رقم اعشار است (در صورت امکان). این گزینه مشخصات احتمالی به ازای هر سنجه را لغو \fIنخواهد کرد\fR..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 pcp2elasticsearch به‌صورت پیوسته (در حالت بلادرنگ) یا تا انتهای مجموعه بایگانی‌های 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 هنگامی که برای تعیین مدت‌زمان اجرا پیش از خروج \fBpcp2elasticsearch\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 pcp2elasticsearch را تعیین می‌کند. .RE .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 \fIindex\fR, \fB\-\-es\-index\fR=\fIindex\fR .I index در Elasticsearch برای نام‌های معیارها. .TP \fB\-X\fR \fIhostid\fR, \fB\-\-es\-hostid\fR=\fIhostid\fR .I hostid در Elasticsearch برای اندازه‌گیری‌ها. .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\-?\fR, \fB\-\-help\fR نمایش پیام راهنما و خروج..SH "قالب خروجی (OUTPUT FORMAT)" ابتدا، .B pcp2elasticsearch این تعریف نوع را به Elasticsearch ارسال می‌کند: .IP { "mappings": { "properties": { "@timestamp": { "type": "long" }, "host-id": { "type": "text" } } } } .PP سند واقعی داده‌های سنجه‌ها مشابه این مثال است: .IP { "@host-id": "bozo", "@timestamp": 1507637520, "mem": { "util": { "used": 4525820, "free": 3344000 } }, "disk": { "partitions": { "@instances": [ { "read": 1121, "@id": "sda1" }, { "read": 77306, "@id": "sda2" }, { "read": 131, "@id": "sda3" } ] } } } .SH "فایل‌ها (FILES)" .TP 5 .I pcp2elasticsearch.conf فایل پیکربندی \fBpcp2elasticsearch\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 pcp2graphite (1)، .BR pcp2influxdb (1)، .BR pcp2json (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). .\" control lines for scripts/man-spell .\" +ok+ limit_filter_force count_scale_force space_scale_force .\" +ok+ time_scale_force ignore_incompat precision_force include_labels .\" +ok+ es_search_type invert_filter CGHIjLmnrRvV names_change .\" +ok+ limit_filter live_filter total_bytes count_scale space_scale .\" +ok+ es_password type_prefer metricsets time_scale omit_flat .\" +ok+ es_hostid es_server incompat influxdb es_index es_auth .\" +ok+ sda