نام (NAME)

pmdatxmon، txrecord، genload - عامل دامنه معیارهای کارایی txmon (معروف به PMDA)

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

$PCP_PMDAS_DIR/txmon/pmdatxmon [-D debug] [-d domain] [-l logfile] [-U username] tx_type ...
$PCP_PMDAS_DIR/txmon/txrecord [-l]
$PCP_PMDAS_DIR/txmon/txrecord tx_type servtime [tx_type servtime ... ]
$PCP_PMDAS_DIR/txmon/genload

توضیحات (DESCRIPTION)

برنامه pmdatxmon یک عامل دامنه معیارهای کارایی (PMDA) نمونه است که تعداد اندکی از معیارهای کارایی را از یک پایشگر تراکنش شبیه‌سازی‌شده استخراج کرده و ارائه می‌دهد.

عامل txmon PMDA هم به‌صورت باینری و هم کد منبع عرضه می‌شود و با این هدف طراحی شده که کمکی برای توسعه‌دهندگان PMDA باشد؛ این PMDA نشان می‌دهد که داده‌های کارایی چگونه می‌توانند از یک برنامه کاربردی (در اینجا txrecord) از طریق یک قطعه حافظه اشتراکی به زیرساخت PCP صادر شوند. جهت آسودگی، pmdatxmon قطعه حافظه اشتراکی را ایجاد کرده (و هنگام خروج، آن را از بین می‌برد).

آرگومان‌های tx_type برچسب‌های یکتا و دلخواهی هستند که برای شناسایی انواع گوناگون تراکنش استفاده می‌شوند.

برنامه txrecord پردازش یک یا چند تراکنش شناسایی‌شده توسط tx_type و با زمان سرویس‌دهی مشاهده‌شدهٔ servtime را شبیه‌سازی می‌کند.

با گزینهٔ -l، برنامه txrecord خلاصهٔ کنونی فعالیت‌های تراکنش را از قطعه حافظه اشتراکی نمایش می‌دهد.

اسکریپت genload یک اسکریپت شل و awk(1) است که به عنوان رابطی برای txrecord عمل می‌کند تا باری ثابت از فعالیت‌های تراکنشی شبیه‌سازی‌شده ایجاد کند.

شرح کوتاهی از گزینه‌های خط فرمان pmdatxmon در ادامه آمده است:

-d: بسیار حیاتی است که شماره دامنه ( domain) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد؛ بدین معنا که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA در تمامی میزبان‌ها استفاده شود.
-l: محل فایل گزارش (log). به‌طور پیش‌فرض، هنگام شروع pmdatxmon، یک فایل گزارش به نام txmon.log در دایرکتوری جاری pmcd(1) یعنی $PCP_LOG_DIR/pmcd نوشته می‌شود. اگر ایجاد فایل گزارش ممکن نباشد یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد (stderr) نوشته می‌شود.
-U: حساب کاربری که عامل باید تحت آن اجرا شود. پیش‌فرض در نسخه‌های کنونی PCP حساب بدون امتیاز «pcp» است، اما در نسخه‌های قدیمی‌تر به‌طور پیش‌فرض از حساب مدیر سیستم («root») استفاده می‌شد.

نصب (INSTALLATION)

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

# cd $PCP_PMDAS_DIR/txmon
# ./Install

برچسب‌های tx_type از شما پرسیده خواهد شد.

اگر مایل به بازگرداندن و لغو نصب هستید، مراحل زیر را با دسترسی root انجام دهید:

# cd $PCP_PMDAS_DIR/txmon
# ./Remove

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

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH: گزینه‌های خط فرمان استفاده‌شده برای راه‌اندازی pmdatxmon
$PCP_PMDAS_DIR/txmon/help: فایل متن راهنمای پیش‌فرض برای معیارهای txmon
$PCP_PMDAS_DIR/txmon/Install: اسکریپت نصب برای عامل pmdatxmon
$PCP_PMDAS_DIR/txmon/Remove: اسکریپت حذف و بازگردانی برای عامل pmdatxmon
$PCP_LOG_DIR/pmcd/txmon.log: فایل گزارش پیش‌فرض برای پیام‌های خطا و دیگر اطلاعات از pmdatxmon

محیط PCP (PCP ENVIRONMENT)

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

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

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

گزینه‌های اشکال‌زدایی اختصاصی pmdatxmon به شرح زیر است:

گزینه	توضیحات
appl0	عملیات‌های حافظه اشتراکی

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

PCPIntro(1)، pmcd(1)، pmdasample(1)، pmdatrivial(1)، txmonvis(1) و PMDA(3).