نام (NAME)

pmdasummary - عامل دامنه معیارهای کارایی خلاصه (PMDA)

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

$PCP_PMDAS_DIR/summary/pmdasummary [-D debug] [-d domain] [-h helpfile] [-l logfile] [-U username] pmie-command-line

توضیحات (DESCRIPTION)

pmdasummary یک عامل دامنه معیارهای کارایی (PMDA) است که مقادیر معیارهای کارایی را از مقادیر ارائه‌شده توسط سایر PMDAها استخراج می‌کند. pmdasummary از دو فرایند تشکیل شده است:

فرایند pmie

موتور استنتاج مقادیر کارایی، pmie(1) برای نمونه‌برداری دوره‌ای از مقادیر معیارهای پایه و محاسبه مقادیر مشتق‌شده استفاده می‌شود. این فرایند با آرگومان‌های داده‌شده در pmie-command-line توسط فرایند اصلی (که در ادامه شرح داده شده است) اجرا می‌شود.

فرایند اصلی

فرایند اصلی، مقادیر محاسبه‌شده توسط pmie(1) را خوانده و بافر می‌کند و آن‌ها را در دسترس دیمن جمع‌آوری معیارهای کارایی، pmcd(1) قرار می‌دهد.

توضیح مختصری از گزینه‌های خط فرمان pmdasummary در ادامه آمده است:

-d

بسیار حیاتی است که شماره دامنه ( domain ) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد. به این معنا که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.

-h

این گزینه یک فایل متنی راهنمای جایگزین به نام helpfile را برای توصیف معیارهایی که pmdasummary ارائه می‌دهد مشخص می‌کند.

-l

محل فایل گزارش (لاگ). به‌طور پیش‌فرض، هنگامی که pmdasummary آغاز به کار می‌کند، یک فایل گزارش به نام summary.log در دایرکتوری جاریِ pmcd(1) یعنی $PCP_LOG_DIR/pmcd نوشته می‌شود. اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.

-U

حساب کاربری که عامل تحت آن اجرا می‌شود. پیش‌فرض در نسخه‌های کنونی PCP حساب بدون امتیاز "pcp" است، اما در نسخه‌های قدیمی‌تر، حساب مدیر سیستم ("root") به‌طور پیش‌فرض استفاده می‌شد.

نصب (INSTALLATION)

اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی خلاصه دسترسی داشته باشید، مراحل زیر را به عنوان کاربر ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/summary
# ./Install

اگر می‌خواهید نصب را لغو کنید، مراحل زیر را به عنوان کاربر ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/summary
# ./Remove

pmdasummary توسط pmcd(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود. اسکریپت‌های Install و Remove به pmcd(1) هنگام نصب یا حذف عامل اطلاع‌رسانی می‌کنند.

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH

گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی pmdasummary

$PCP_PMDAS_DIR/summary/expr.pmie

عبارت‌های پیش‌فرض pmie(1) که معیارهای خلاصه را تعریف می‌کنند

$PCP_PMDAS_DIR/summary/help

متن راهنمای پیش‌فرض برای معیارهای خلاصه

$PCP_PMDAS_DIR/summary/Install

اسکریپت نصب برای عامل pmdasummary

$PCP_PMDAS_DIR/summary/Remove

اسکریپت لغو نصب برای عامل pmdasummary

$PCP_LOG_DIR/pmcd/summary.log

فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از pmdasummary

محیط PCP (PCP ENVIRONMENT)

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

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

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

همچنین ببینید (SEE ALSO)

PCPIntro(1)، pmcd(1) و pmie(1).