'\"macro stdmacro
.\"
.\" Copyright (c) 2020 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 PMFIND_CHECK 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmfind_check \- مدیریت کشف سرویس‌های Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
.B $PCP_BINADM_DIR/pmfind_check
[\f3\-CNV?\f1]
[\f3\-l\f1 \f2logfile\f1]
.SH "توضیحات (DESCRIPTION)"
این اسکریپت شل برای ادغام سازوکارهای کشف سرویس جمع‌آوری‌کننده Performance Co-Pilot (ببینید
.BR PCPIntro (1))
با مدیریت سرویس‌های
.BR pmie (1)
و
.BR pmlogger (1)
به‌کار می‌رود، به‌گونه‌ای که بتوان چندین میزبان جمع‌آوری‌کننده را از یک میزبان متمرکز واحد پایش کرد.
توجه به این نکته حائز اهمیت است که سرویس
.B pmfind
به‌طور تنگاتنگی با سرویس‌های
.B pmie
و
.B pmlogger
یکپارچه شده است، و اگر قرار باشد سرویس‌ها برای هر سیستم جمع‌آوری‌کننده‌ای که
.B pmfind
کشف می‌کند راه‌اندازی شوند، این سرویس‌ها نیز باید فعال گردند.
.PP
.B pmfind_check
به‌گونه‌ای طراحی شده است که از طریق یک دیمن مدیریت سرویس مانند
.BR systemd (1)
در لینوکس فعال شود.
این اسکریپت از طریق یک تایمر سیستمی (توسط
.B systemd
یا توسط
.B cron
در سایر سیستم‌ها) اجرا می‌شود.
یک بار در هر بازه تایمر،
.B pmfind
برای کشف سیستم‌های جمع‌آوری‌کننده PCP تلاش می‌کند.
به‌ازای هر سیستم منحصربه‌فردِ یافت‌شده،
.B pmfind_check
مدخل‌های فایل کنترلی برای
.BR pmie_check
و
.BR pmlogger_check
ایجاد می‌کند، به‌طوری که این فرآیندهای پسین بتوانند یک سرویس
.B pmie
و
.B pmlogger
را برای هر سیستم جمع‌آوری‌کننده کشف‌شده مدیریت کنند.
.PP
هنگام اجرا از طریق
.B systemd
این فرآیندها بلافاصله راه‌اندازی خواهند شد، زیرا
.B systemd
فایل‌های کنترل سرویس را برای تغییرات نظارت می‌کند.
با
.B systemd
همچنین می‌توان با اصلاح پوشه
.IR $PCP_SYSCONF_DIR/pmfind
به هر شکل، یک کشف سرویس فوری را توسط
.B pmfind
و
.B pmfind_check
آغاز کرد.
.PP
هنگام اجرا از طریق
.B cron
فراخوانی بعدی (که آن هم بر پایه تایمر است) از سوی
.B pmie_check
یا
.B pmlogger_check
فرآیندهای مرتبط
.B pmie
و
.B pmlogger
را راه‌اندازی و مدیریت خواهد کرد.
.PP
مدخل‌های فایل کنترل ایجادشده توسط
.B pmfind_check
از قرارداد فایل‌های مجزا برای هر میزبان جمع‌آوری‌کننده پیروی می‌کنند.
نام‌گذاری این فایل‌ها با استفاده از شناسه منبع (منحصربه‌فردی) انجام می‌شود که
.B pmfind
محاسبه می‌کند.
این شناسه، یک هش محاسبه‌شده بر اساس برچسب‌های متنی (غیر اختیاری) در دسترس از هر میزبان جمع‌آوری‌کننده است، و همان شناسه منبعی است که توسط
.BR pminfo (1)
و
.BR pmseries (1)
گزارش شده و استفاده می‌گردد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود خط فرمان عبارتند از:
.TP 5
\fB\-C\fR, \fB\-\-containers\fR
این گزینه باعث می‌شود
.B pmfind_check
هر سیستم جمع‌آوری‌کننده کشف‌شده را برای کانتینرهای در حال اجرا نیز بررسی کند، که در این صورت کانتینرها نیز به‌صورت مجزا نظارت خواهند شد.
.TP
\fB\-l\fR \fIfile\fR, \fB\-\-logfile\fR=\fIfile\fR
برای اطمینان از اینکه هنگام اجرای این اسکریپت‌ها از طریق
.BR cron (8)
ایمیلی ناخواسته ارسال نشود، پیام‌های عیب‌یابی همیشه به فایل‌های لاگ فرستاده می‌شوند.
به‌طور پیش‌فرض، این فایل
.B $PCP_LOG_DIR/pmfind/pmfind_check.log
است، اما می‌توان آن را با استفاده از گزینه
.B \-l
تغییر داد.
اگر این
.I file
لاگ هنگام شروع اسکریپت از قبل موجود باشد، پیش از تولید پیام‌های عیب‌یابی در فایل لاگ جدید، نام آن با پسوند
.I .prev
تغییر داده خواهد شد (و هر فایل لاگی که پیش‌تر ذخیره شده بود رونویسی می‌شود).
.TP
\fB\-N\fR, \fB\-\-showme\fR
این گزینه حالت «نمایشی» را فعال می‌کند که در آن اقدامات برنامه‌ها نمایش داده می‌شوند اما اجرا نمی‌گردند، مشابه رفتار «make \-n».
استفاده از
.B \-N
همراه با
.B \-V
قابلیت‌های عیب‌یابی را برای اشکال‌زدایی به حداکثر می‌رساند.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
خروجی حاصل از اجرای اسکریپت‌ها در
.BR cron
را می‌توان با استفاده از گزینه
.B \-V
گسترش داد که امکان ردگیری دقیق فعالیت آن‌ها را فراهم می‌کند.
به‌طور پیش‌فرض، اسکریپت‌ها خروجی تولید نمی‌کنند مگر اینکه با شرایط خطا یا هشدار مواجه شوند.
استفاده از
.B \-N
همراه با
.B \-V
قابلیت‌های عیب‌یابی را برای اشکال‌زدایی به حداکثر می‌رساند.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "پیکربندی (CONFIGURATION)"
گزینه‌های خط فرمان ارسال‌شده به
.B pmie
و
.B pmlogger
را می‌توان از طریق فایل پیکربندی
.IR $PCP_SYSCONFIG_DIR/pmfind
شخصی‌سازی کرد.
.PP
برای جزئیات قالب فایل کنترل ایجادشده توسط
.BR pmfind_check ،
به صفحات راهنمای
.B pmie_check
و
.B pmlogger_check
مراجعه کنید.
.PP
به‌طور پیش‌فرض، فایل لاگ
.B pmie
برای هر سیستم جمع‌آوری‌کننده در
.BI $PCP_LOG_DIR/pmie/ source
و آرشیوهای
.B pmlogger
در زیرمسیر
.BI $PCP_ARCHIVE_DIR/ source\fR
ایجاد خواهند شد.
این رفتار با روشی که
.BR pmie (1)
و
.BR pmlogger (1)
لاگ‌های فعالیت و فایل‌های آرشیو خود را نگهداری می‌کنند سازگار است.
.PP
مدخل‌های معمول
.BR crontab (5)
برای اجرای دوره‌ای
.B pmfind_check
در
.BR $PCP_SYSCONF_DIR/pmfind/crontab
ارائه شده‌اند (مگر اینکه پیش‌تر به‌طور پیش‌فرض در
.IR /etc/cron.d
نصب شده باشند) و در زیر نشان داده شده‌اند.
.PP
.nf
.ft CR
# every minute, discover remote PCP services
*       *       *       *       *       $PCP_BINADM_DIR/pmfind_check
.ft 1
.fi
هنگام استفاده از
.BR systemd (1)
در لینوکس، نیازی به مدخل‌های
.B crontab
نیست، چرا که سازوکارهای تایمر و مسیر ارائه‌شده توسط
.B systemd
به‌جای آن استفاده می‌شوند.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_PMIECONTROL_PATH.d
فایل‌های کنترل موتور استنتاج PCP برای هر منبع سنجه کشف‌شده، معمولاً یکی برای هر میزبان یا کانتینر.
.br
.BR هشدار :
فایل‌های موجود در این مسیر نباید توسط کاربری غیر از ریشه (root) قابل نوشتن باشند.
.TP
.I $PCP_PMLOGGERCONTROL_PATH.d
فایل‌های کنترل ثبت‌کننده لاگ PCP برای هر منبع سنجه کشف‌شده، معمولاً یکی برای هر میزبان یا کانتینر.
.br
.BR هشدار :
فایل‌های موجود در این مسیر نباید توسط کاربری غیر از ریشه (root) قابل نوشتن باشند.
.TP
.I $PCP_SYSCONFIG_DIR/pmfind
آرگومان‌های پیش‌فرض خط فرمان برای
.B pmie
و
.B pmlogger
و سایر پارامترهای ارسال‌شده به
.BR pmfind .
.TP
.I $PCP_SYSCONF_DIR/pmfind/crontab
نمونه crontab برای اجرای خودکار اسکریپت توسط ریشه (root) \-
فقط در صورتی وجود دارد که پلتفرم از سازوکار
.I /etc/cron.d
پشتیبانی نکند.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به‌کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP شامل مقادیر محلی این متغیرها است.
از متغیر \fB$PCP_CONF\fP می‌توان برای مشخص کردن یک فایل پیکربندی جایگزین استفاده کرد، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1),
.BR pmfind (1),
.BR pmie (1),
.BR pmie_check (1),
.BR pminfo (1),
.BR pmlogger (1),
.BR pmlogger_check (1),
.BR pmseries (1),
.BR systemd (1),
.BR crontab (5)
و
.BR cron (8).
.\" control lines for scripts/man-spell
.\" +ok+ prev {from .prev suffix} \* {dopey ispell}