'\"macro stdmacro
.\"
.\" Copyright (c) 2019-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 PCPCOMPAT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3PCPCompat\f1,
\f3pcp-collectl\f1,
\f3pmmgr\f1,
\f3pmwebd\f1 \- سازگاری با نسخه‌های پیشین در ابزار Performance Co-Pilot (PCP)
.SH "مقدمه (INTRODUCTION)"
مجموعه Performance Co-Pilot (PCP) یک جعبه‌ابزار طراحی‌شده برای پایش و مدیریت کارایی در سطح سیستم است\&.
این خدمات توزیع‌شده و مقیاس‌پذیر هستند تا پیچیده‌ترین پیکربندی‌های سیستم و مسائل مربوط به کارایی را پوشش دهند\&.
.PP
به منظور دستیابی مؤثر به این اهداف، سازگاری پروتکل و سازگاری روی دیسک میان نسخه‌های مختلف PCP فراهم شده است\&.
به‌کارگیری ابزارهای کنونی PCP برای بازپرسی از هرگونه سرویس دوردست، نسخه قدیمی‌تر یا نسخه جدیدتر
.BR pmcd (1)
و همچنین بازپخش هرگونه آرشیو تاریخی PCP کاملاً امکان‌پذیر (و در واقع توصیه شده) است (مجموعه آزمون‌های PCP شامل آرشیوهایی است که بیش از ۲۰ سال پیش ایجاد شده‌اند!)\&.
.PP
توسعه‌دهندگان PCP گهگاه برخی ابزارهای PCP را منسوخ و حذف کرده و آن‌ها را با نگارش‌های جدیدی از ابزارها که قابلیت‌های قابل مقایسه‌ای ارائه می‌دهند جایگزین می‌کنند\&.
این صفحه ابزارهای جایگزین را برای ابزارهای قدیمی PCP شرح می‌دهد\&.
.SH "پایتون ۲ (PYTHON2)"
ابزار PCP رابط‌های
.BR python (1)
را برای API سنجه‌های کارایی
.RB ( PMAPI (3))،
API عامل‌های دامنه سنجه‌های کارایی
.RB ( PMDA (3))،
API مقادیر نگاشت‌شده در حافظه
.RB ( mmv_stats_register (3))
و API ایجاد آرشیو PCP
.RB ( LOGIMPORT (3))
ارائه می‌دهد\&.
.PP
با رسیدن
.B python
نسخه ۲ به پایان عمر خود در سال ۲۰۲۰، اکنون تمام پشتیبانی از این نسخه را (از نگارش ۷ به بعد PCP) حذف کرده‌ایم\&.
تمامی APIها و ابزارهای مبتنی بر
.BR python
در PCP از
.B python
نسخه ۳ پشتیبانی می‌کنند و چندین سال است که چنین وضعیتی دارند \- ارتقا به نسخه جدیدتر اکیداً توصیه می‌شود\&.
.SH "کیوت ۴ (QT4)"
ابزار PCP رابط‌های گرافیکی اختیاری ساخته‌شده بر پایه کتابخانه چندسکویی Qt را فراهم می‌کند، به‌ویژه
.BR pmchart (1)
و
.BR pmtime (1)\&.
.PP
با رسیدن Qt نسخه ۴ به پایان عمر خود در سال ۲۰۱۵، پشتیبانی از تمامی نسخه‌های پیش از Qt v5 را حذف کرده‌ایم\&.
علاوه بر این، برخی از قابلیت‌ها در نسخه‌های اولیه Qt v5 وجود ندارند که اکنون هنگام ساخت و استفاده از ابزارهای PCP Qt الزامی هستند\&.
در نتیجه، حداقل نسخه مورد نیاز Qt برای PCP نسخه ۶ و پس از آن، اکنون Qt 5.6 است\&.
.SH "NSS"
نسخه‌های PCP پیش از نسخه ۶ از ترکیبی از Mozilla NSS (سرویس‌های امنیت شبکه) و OpenSSL برای بخش رمزنگاری سوکت‌های امن استفاده می‌کردند\&.
از نسخه ۶ به بعد PCP، این ساختار ساده‌سازی شده و به استفاده انحصاری از OpenSSL برای تمامی نیازهای رمزنگاری در سراسر PCP تبدیل شده است\&.
این تغییر بر پیکربندی عملکردهای اختیاری در
.BR pmcd (1)
و ابزارهای کلاینت
.BR PMAPI (3)
که از سوکت‌های امن استفاده می‌کنند تأثیر می‌گذارد\&.
.PP
اثر کلی این تغییر این است که رمزنگاری به شیوه‌ای یکسان و با استفاده از همان گواهی‌ها، هم در قابلیت HTTPS در
.BR pmproxy (1)
و هم در قابلیت پروتکل رمزگذاری‌شده PCP میان
.BR pmcd ،
.B pmproxy
و ابزارهای کلاینت
.B PMAPI
پیکربندی می‌شود\&.
علاوه بر این، سرویس سرور کلید-مقدار (key-value) مورد استفاده توسط
.BR pmseries (1)
و
.B pmproxy
نیز منحصراً از OpenSSL و به شیوه‌ای مشابه PCP استفاده می‌کند که مدیریت این سرویس‌ها را به میزان چشمگیری ساده‌تر می‌سازد\&.
.SH "SAR2PCP, IOSTAT2PCP"
ابزارهای
.BR sar2pcp (1)
و
.BR iostat2pcp (1)
منسوخ شده‌اند و در یکی از نسخه‌های آینده PCP (نسخه ۷) بازنشسته خواهند شد\&.
این ابزارها با پشتیبانی بومی برای تولید آرشیوهای PCP در ابزارهای بسته
.I sysstat
جایگزین می‌شوند (که خود ابزار
.B sar
و همچنین ابزار
.B sadf
را ارائه می‌دهد که آرشیوهای PCP را از طریق گزینه
.B \-l
تولید می‌کند)\&.
.SH "PMLOGCONF-SETUP"
نسخه‌های پیشین PCP (پیش از نسخه ۵.۱.۱) یک اسکریپت شل ارائه می‌کردند که به صورت داخلی توسط
.BR pmlogconf (1)
استفاده می‌شد، واقع در دایرکتوری
.B PCP_BINADM_DIR
و با نام
.BR pmlogconf-setup \&.
این اسکریپت بازنشسته شده است\&.
قابلیت معادل در صورت نیازِ غیرمحتمل، همچنان از طریق گزینه \fB\-s\fR یا \fB\-\-setup\fR در
.BR pmlogconf (1)
در دسترس است\&.
.PP
قالب پرونده پیکربندی نسخه ۱
.B pmlogconf-setup
(برگرفته از IRIX) نیز در این انتشار بازنشسته شد، پس از گذشت بیش از ۱۰ سال از انتقال خودکار به قالب نسخه ۲ توسط
.BR pmlogconf \&.
.SH "PMMGR"
مدیر دیمن مستقل PCP به نام
.B pmmgr
از نسخه ۵.۲.۰ به بعد PCP بازنشسته شده است\&.
این برنامه به نفع سرویس ساده‌تر
.BR pmfind (1)
برای راه‌اندازی «مزارع»
.BR pmie (1)
و
.BR pmlogger (1)
از سیستم‌های جمع‌آوری‌کننده کشف‌شده PCP با
.BR pmfind_check (1)
به تدریج کنار گذاشته شد\&.
سازوکارهای جدید، به خصوص هنگام ادغام با
.BR systemd ،
به دیمن اضافی نیاز ندارند و بهتر با مدیریت سرویس‌های
.BR pmie
و
.BR pmlogger
که در جاهای دیگر PCP استفاده می‌شود یکپارچه شده‌اند\&.
.SH "PCP-COLLECTL"
ابزار
.B pcp-collectl
از نسخه ۵ به بعد PCP با
.BR pmrep (1)
جایگزین شده است\&.
.PP
معادل گزارش‌گیری زیرسیستم‌های
.B pcp-collectl
به صورت زیر حاصل می‌شود:
.TP
.B pmrep :collectl-sc
نمای زیرسیستم پردازنده\&.
.TP
.B pmrep :collectl-sm
نمای زیرسیستم حافظه\&.
.TP
.B pmrep :collectl-sd
نمای تجمیعی دیسک‌ها\&.
.TP
.B pmrep :collectl-sD
نمای تفکیک‌شده دستگاه‌های دیسک\&.
.TP
.B pmrep :collectl-dm-sD
نمای نگاشت‌کننده دستگاه (Device mapper)\&.
.TP
.B pmrep :collectl-sn
نمای زیرسیستم شبکه\&.
.SH "PCP-WEBAPPS"
برنامه‌های تحت وب مستقلی که در نسخه‌های قدیمی‌تر PCP بسته‌بندی شده بودند با
.BR grafana-server (1)
همراه با پلاگین
.B grafana-pcp
در نشانی
.BR https://github.com/performancecopilot/grafana-pcp
جایگزین شده‌اند\&.
.PP
این پلاگین پیاده‌سازی برنامه Vector و همچنین منابع داده برای اسکریپت‌های
.BR pmdabpftrace "(1) (اسکریپت‌های "\c
.BR bpftrace (8))
و
.BR pmseries (1)
(تحلیل سریع، مقیاس‌پذیر و توزیع‌شده سری‌های زمانی) را ارائه می‌دهد\&.
.SH "PMWEBD"
دیمن
.B pmwebd
از نسخه ۵ به بعد PCP با
.BR pmproxy (1)
جایگزین شده است\&.
.PP
به‌طور پیش‌فرض،
.B pmproxy
اکنون هنگام ساخته شدن پشتیبانی سری‌های زمانی، هم روی پورت اصلی خود (44322) و هم پورت API وب PCP (44323) گوش فرا می‌دهد\&.
.PP
ابزار
.B pmproxy
پیاده‌سازی سازگاری از رابط‌های زنده
.BR PMWEBAPI (3)
که به صورت سنتی توسط برنامه تحت وب Vector استفاده می‌شد را ارائه می‌دهد (بخش «PCP-WEBAPPS» را ببینید)\&.
این ابزار همچنین افزونه‌هایی را برای REST APIهای اصلی
.B pmwebd
(مانند سنجه‌های اشتقاقی، جستجوهای فضای نام و نمایه‌های دامنه نمونه)، پشتیبانی از پروتکل HTTPS، و کوئری‌گیری سریع و مقیاس‌پذیر سری‌های زمانی با استفاده از REST API ابزار
.BR pmseries (1)
همراه با سرور کلید-مقدار توزیع‌شده مانند
.BR https://valkey.io
ارائه می‌دهد\&.
.PP
شبیه‌سازی جزئی Graphite API که توسط
.B pmwebd
ارائه می‌شد بازپیاده‌سازی نشده است \- برنامه‌هایی که مایل به استفاده از خدمات مشابه هستند می‌توانند از REST APIهای مقیاس‌پذیر سری‌های زمانی شرح داده شده در
.BR PMWEBAPI (3)
استفاده کنند\&.
.SH "همچنین ببینید (SEE ALSO)"
.BR pcp (1),
.BR pmcd (1),
.BR iostat2pcp (1),
.BR sar2pcp (1),
.BR pmrep (1),
.BR pmfind (1),
.BR pmfind_check (1),
.BR pmlogconf (1),
.BR pmproxy (1),
.BR pmseries (1),
.BR pmdabpftrace (1),
.BR python (1),
.BR grafana-server (1),
.BR mmv_stats_register (3),
.BR LOGIMPORT (3),
.BR PMAPI (3),
.BR PMDA (3)
and
.BR PMWEBAPI (3).

.\" control lines for scripts/man-spell
.\" +ok+ COLLECTL IOSTAT IRIX NSS OpenSSL PCPCompat PMLOGCONF PMMGR
.\" +ok+ PMWEBD SAR WEBAPPS bpftrace dm github grafana
.\" +ok+ testsuite
.\" +ok+ mmv_stats_register pmmgr pmwebd
.\" +ok+ sD sc sd sm sn {from pmrep -args}