'\"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 PCP2OPENTELEMETRY 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp2opentelemetry\f1 \- صادرکننده pcp به opentelemetry
.SH "خلاصه دستور (SYNOPSIS)"
\fBpcp2opentelemetry\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 pcp2opentelemetry
یک ابزار سفارشی‌پذیر برای صادر کردن معیارهای کارایی از PCP به قالب OpenTelemetry \-
.I https://opentelemetry.io
\- است.
هر معیار کارایی موجود، چه زنده و چه بایگانی‌شده، سیستمی و/یا برنامه‌ای را می‌توان با استفاده از آرگومان‌های خط فرمان یا یک فایل پیکربندی برای صادر کردن انتخاب کرد.
.PP
ابزار
.B pcp2opentelemetry
خویشاوندی نزدیکی با
.BR pmrep (1)
دارد. برای مشاهده شرح
.I metricspec
پذیرفته‌شده در خط فرمان
.BR pcp2opentelemetry ،
به
.BR pmrep (1)
مراجعه کنید. برای شرح ساختار فایل پیکربندی
.B pcp2opentelemetry.conf
به
.BR pmrep.conf (5)
مراجعه کنید. این صفحه گزینه‌های اختصاصی
.B pcp2opentelemetry
و تفاوت‌های فایل پیکربندی آن با
.BR pmrep.conf (5)
را شرح می‌دهد.
.BR pmrep (1)
همچنین مثال‌های متعددی از کاربرد را فهرست می‌کند که بیشتر آن‌ها برای
.B pcp2opentelemetry
نیز قابل استفاده هستند.
.PP
تنها گزینه‌های خط فرمان فهرست‌شده در این صفحه پشتیبانی می‌شوند؛
سایر گزینه‌های موجود برای
.BR pmrep (1)
پشتیبانی نمی‌شوند.
.PP
گزینه‌های مشخص‌شده از طریق مقادیر متغیرهای محیطی (ببینید:
.BR pmGetOptions (3))
بر مقادیر پیش‌فرض توکار متناظر (در صورت وجود) مقدم هستند.
گزینه‌های فایل پیکربندی بر متغیرهای محیطی متناظر (در صورت وجود) تقدم دارند.
گزینه‌های خط فرمان نیز بر گزینه‌های متناظر فایل پیکربندی (در صورت وجود) مقدم خواهند بود.
.SH "فایل پیکربندی (CONFIGURATION FILE)"
.B pcp2opentelemetry
از یک فایل پیکربندی با ساختار شرح داده‌شده در
.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 گزینه‌های اختصاصی pcp2opentelemetry
url (string)
.RS 4
ارسال خروجی OpenTelemetry به صورت یک 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
.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 pcp2opentelemetry
اطلاع‌رسانی کند.
مقادیر معتبر برای
.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 ./pcp2opentelemetry.conf ،
.IR \f(CR$HOME\fP/.pcp2opentelemetry.conf ،
.IR \f(CR$HOME\fP/pcp/pcp2opentelemetry.conf
و
.IR \f(CR$PCP_SYSCONF_DIR\fP/pcp2opentelemetry.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) فراهم می‌کند.
.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\-H\fR, \fB\-\-no\-header\fR
عدم چاپ هیچ‌گونه سرایند.
.TP
\fB\-i\fR \fIinstances\fR, \fB\-\-instances\fR=\fIinstances\fR
تنها نمونه‌های (\fIinstances\fR) مشخص‌شدهٔ متریک را بازیابی و گزارش می‌کند.
به‌طور پیش‌فرض تمام نمونه‌ها، چه فعلی و چه آینده، گزارش می‌شوند.
.RS
.PP
برای شرح کامل این گزینه به
.BR pmrep (1)
مراجعه کنید.
.RE.TP
\fB\-I\fR, \fB\-\-ignore\-incompat\fR
نادیده گرفتن معیارهای ناسازگار.
به‌طور پیش‌فرض معیارهای ناسازگار (یعنی نوع آن‌ها پشتیبانی نمی‌شود یا نمی‌توان آن‌ها را مطابق درخواست مقیاس‌بندی کرد) باعث می‌شوند که
.B pcp2opentelemetry
با یک پیام خطا خاتمه یابد.
با این گزینه، تمام معیارهای ناسازگار بدون هشدار از گزارش‌گیری حذف می‌شوند.
این موضوع به‌ویژه هنگام درخواست گره‌های غیربرگ درخت PMNS برای گزارش‌گیری می‌تواند مفید باشد.
.TP
\fB\-j\fR, \fB\-\-live\-filter\fR
انجام فیلترسازی زندهٔ نمونه‌ها.
این کار امکان دریافت تمام نمونه‌های نام‌گذاری‌شده را حتی در صورت راه‌اندازی مجدد فرایندها در طول زمان فراهم می‌کند (برخلاف حالت بدون فیلترسازی زنده).
انجام فیلترسازی زنده روی تعداد بسیار زیادی از نمونه‌ها، بار اضافی داخلی ایجاد می‌کند؛ بنابراین کمی احتیاط از سوی کاربر توصیه می‌شود.
همچنین ببینید
.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
می‌تواند برای کنترل 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
مشخص کردن فهرستی از معیارهای مرجع فیلتر گزاره‌ای
.RI ( predicate )
که با کاما جدا شده‌اند.
به‌طور پیش‌فرض، رتبه‌بندی (ببینید
.BR \-J )
برای هر معیار به‌صورت مجزا انجام می‌شود.
با گزاره‌ها، رتبه‌بندی تنها برای معیارهای گزاره‌ایِ مشخص‌شده انجام می‌گیرد.
هنگام گزارش‌گیری، باقی معیارهایی که با گزاره دامنهٔ نمونهٔ مشترک دارند (ببینید
.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 با گزینهٔ
.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
ارائهٔ مقادیر خام معیارها در خروجی؛ شمارنده‌های تجمعی به نرخ تبدیل نمی‌شوند.
این گزینه مشخصات احتمالی مختص هر معیار را لغو \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 pcp2opentelemetry
به‌صورت پیوسته نمونه‌برداری و گزارش می‌دهد (در حالت بی‌درنگ) یا تا انتهای مجموعه بایگانی‌های 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
تنظیم بازهٔ زمانی گزارش‌گیری
.RI ( 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
هنگامی که برای تعیین مدت‌زمان اجرا پیش از خروج \fBpcp2opentelemetry\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 pcp2opentelemetry
را تعیین می‌کند.
.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
گزارش تنها معیارهای مجموعه‌مقداری دارای نمونه‌ها (مانند 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 pcp2opentelemetry.conf
فایل پیکربندی \fBpcp2opentelemetry\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 "گزینه‌های اشکال‌زدایی (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 pcp2openmetrics (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