نام (NAME)

pmdaoverhead - عامل دامنه معیارهای کارایی (PMDA) برای ارائه معیارهای مصرف منابع گروه‌هایی از فرآیندها

خلاصه دستور (SYNOPSIS)

$PCP_PMDAS_DIR/overhead/pmdaoverhead [-C] [-c config] [-D debug] [-d domain] [-l logfile] [-R interval]

توضیحات (DESCRIPTION)

دستور pmdaoverhead یک عامل دامنه معیارهای کارایی (PMDA) قابل‌پیکربندی برای ارائه و استخراج میزان مصرف منابع برای گروه‌هایی از فرآیندهای مرتبط است.

گزینه‌های خط فرمان pmdaoverhead عبارتند از:

-C: تجزیه فایل(های) پیکربندی و خروج پس از گزارش هرگونه خطا.
-c: فایل(های) پیکربندی؛ config می‌تواند یک فایل یا یک دایرکتوری باشد؛ در حالت دوم، فرض می‌شود تمام فایل‌های درون config فایل‌های پیکربندی برای pmdaoverhead هستند و همگی پردازش خواهند شد.

هر فایل پیکربندی با استفاده از نحو شرح‌داده‌شده در بخش «CONFIGURATION» در زیر، یک یا چند «گروه» از فرآیندهای مورد نظر را تعریف می‌کند.

به‌طور پیش‌فرض، تمام فایل‌های پیکربندی درون دایرکتوری $PCP_SYSCONF_DIR/overhead/conf.d/ استفاده می‌شوند.

-d: بسیار حیاتی است که شماره دامنه ( domain) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد. بدین معنا که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.
-l: محل فایل گزارش (log). به‌طور پیش‌فرض، فایلی به نام overhead.log هنگام راه‌اندازی pmdaoverhead در دایرکتوری جاری pmcd(1) نوشته می‌شود، یعنی $PCP_LOG_DIR/pmcd. اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خطای استاندارد (standard error) نوشته می‌شود.
-R: این PMDA از یک رشته (thread) جداگانه برای پویش دوره‌ای تمام فرآیندها استفاده می‌کند تا مشخص کند کدام فرآیندها در هر گروه «مورد نظر» تلقی می‌شوند، و مصرف منابع را برای آن فرآیندها استخراج کند. آرگومان interval (بر حسب ثانیه) مشخص می‌کند که این پویش و محاسبه منابع هر چند وقت یک‌بار انجام شود؛ مقدار پیش‌فرض ۶۰ (ثانیه) است..SH "پیکربندی (CONFIGURATION)" هر فایل پیکربندی یک یا چند «گروه» (group) از فرآیندها را تعریف می‌کند. قالب فایل ساده است و از قواعد زیر پیروی می‌کند:
1.: خطوطی که با هش «#» آغاز می‌شوند به عنوان کامنت در نظر گرفته می‌شوند. به طور کلی‌تر، به جز بند pattern: که در زیر شرح داده شده است، تمام متن بین یک هش و انتهای خط به عنوان کامنت در نظر گرفته می‌شود.
2.: فاصله‌های خالی (فاصله‌ها، تب‌ها یا خطوط جدید) برای جدا کردن اجزای واژگانی لازم هستند. در غیر این صورت، فاصله‌ها و تب‌ها نادیده گرفته می‌شوند. به جز پایان دادن به کامنت‌ها و regex در یک بند pattern:، خطوط جدید نیز نادیده گرفته می‌شوند.
3.: هر گروه با یک بند group معرفی می‌شود که ساختار زیر را دارد:
group name { parameters }
که در آن name یک نام یکتا برای گروه در میان تمام گروه‌های موجود در فایل‌های پیکربندی pmdaoverhead است. از آن‌جا که name در فضای نام معیارهای عملکرد (PMNS) قرار می‌گیرد، باید از قوانین مربوط به اجزای نام معیار همان‌طور که در PMNS(5) شرح داده شده است پیروی کند؛ یعنی با یک نویسه الفبایی آغاز شود و به دنبال آن صفر یا چند نویسه متشکل از حروف الفبا، اعداد و نویسه زیرخط «_» بیاید.
4.: مولفه parameters باید شامل یک بند id: و یک بند pattern: باشد.
5.: یک بند id: ساختار زیر را دارد:
id: ident
که در آن ident یک شماره شناسه یکتا برای گروه در میان تمام گروه‌های فایل‌های پیکربندی pmdaoverhead است. مقادیر معتبر برای ident در بازه 0 تا 4094 (شامل هر دو) هستند.
6.: یک بند pattern: ساختار زیر را دارد:
pattern: regex
که در آن regex یک ساختار عبارت باقاعده گسترش‌یافته به سبک egrep(1) است. مقدار regex از نخستین نویسه غیرفاصله پس از pattern: آغاز شده و تا خط جدید بعدی امتداد می‌یابد.

فرآیندهایی که به عنوان اعضای گروه در نظر گرفته می‌شوند مواردی هستند که نام دستور آن‌ها، همان‌طور که توسط
$ pminfo -f proc.psinfo.cmd
گزارش می‌شود، با regex تطبیق داشته باشد، به‌علاوه تمام نوادگان آن فرآیندها. بنابراین برای مثال، مقدار regex به صورت ^pmcd$ با pmcd(1) و تمام فرآیندهای PMDA اجرا شده توسط pmcd(1) و هر یک از فرزندان آن‌ها و غیره مطابقت خواهد داشت. اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی overhead دسترسی داشته باشید، دستورات زیر را به عنوان ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/overhead
# ./Install

اگر می‌خواهید نصب را لغو کنید، دستورات زیر را به عنوان ریشه انجام دهید:

# cd $PCP_PMDAS_DIR/overhead
# ./Remove

برنامهٔ pmdaoverhead توسط pmcd راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا گردد. اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود، به pmcd اطلاع می‌دهند.

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH: گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی pmdaoverhead
$PCP_PMDAS_DIR/overhead/Install: اسکریپت نصب برای عامل pmdaoverhead
$PCP_PMDAS_DIR/overhead/Remove: اسکریپت حذف نصب برای عامل pmdaoverhead
$PCP_LOG_DIR/pmcd/overhead.log: فایل گزارش (log) پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از سوی pmdaoverhead
$PCP_SYSCONF_DIR/overhead/conf.d: دایرکتوری حاوی فایل‌های پیکربندی برای معیارهای overhead

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینهٔ -D یا --debug خروجی عیب‌یابی‌های تکمیلی را در stderr فعال می‌کند تا به بررسی مشکلات کمک کند، هرچند این اطلاعات گاهی مبهم بوده و در وهلهٔ اول به جای کاربران نهایی، برای راهنمایی توسعه‌دهندگان طراحی شده‌اند. debug فهرستی از گزینه‌های اشکال‌زدایی جداشده با کاما است؛ از pmdbg(1) همراه با گزینهٔ -l برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.

گزینه‌های اشکال‌زدایی مختص به pmdaoverhead عبارتند از:

گزینه	توضیحات
appl0	تجزیهٔ configfile
appl1	برچسب‌های زمانی شروع-پایان ()refresh
appl2	انتخاب /proc در ()refresh
"همچنین ببینید (SEE ALSO)"
PCPIntro (1)،
pmcd (1)،
pmdaproc (1)،
pcp.conf (5)،
pcp.env (5)
و
PMNS (5).