PMDATRACE(1) General Commands Manual PMDATRACE(1)

pmdatrace - عامل دامنه معیارهای عملکرد تراکنش در سطح برنامه

$PCP_PMDAS_DIR/trace/pmdatrace [-D debug] [-d domain] [-l logfile] [-A access] [-I port] [-M username] [-N buckets] [-T period] [-U units]

برنامه pmdatrace یک «عامل دامنه معیارهای عملکرد» (PMDA) است که معیارهای عملکرد تراکنش را از فرایندهای برنامه‌ای که از کتابخانه pcp_trace (شرح‌داده‌شده در pmdatrace(3)) استفاده می‌کنند، صادر می‌کند.

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

بسیار حیاتی است که شماره domain (دامنه) معیارهای عملکرد مشخص‌شده در اینجا یکتا و سازگار باشد. بدین معنا که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.
محل فایل گزارش (log). به‌طور پیش‌فرض، یک فایل گزارش با نام trace.log در دایرکتوری جاری pmcd(1) در هنگام شروع pmdatrace (یعنی $PCP_LOG_DIR/pmcd) نوشته می‌شود. اگر فایل گزارش ایجاد نشود یا قابل نوشتن نباشد، خروجی در خطای استاندارد نوشته خواهد شد.
کنترل دسترسی مبتنی بر میزبان برای pmdatrace. مقدار access باید یک مشخصه مجاز یا منع با استفاده از allow:hostspec:maxconns یا disallow:hostspec باشد، که در آن `allow' و `disallow' کلمات کلیدی هستند، `hostspec' مشخصه میزبانی است که از قالب استفاده‌شده توسط هر دوی pmcd(1) و pmlogger(1) پیروی می‌کند، و `maxconns' حداکثر تعداد اتصالات مجاز از یک `hostspec' مشخص است. استفاده از صفر برای حداکثر اتصالات، نشان‌دهنده تعداد نامحدود اتصالات برای `hostspec' مربوطه است.
ارتباط با کلاینت‌های pcp_trace از طریق port اینترنتی مشخص‌شده. این مقدار را می‌توان با تنظیم متغیر محیطی $PCP_TRACE_PORT روی یک شماره پورت معتبر نیز تعیین کرد (استفاده از گزینه -I این متغیر را نادیده می‌گیرد). شماره پورت پیش‌فرض 4323 است.
مقدار period دوره تجمیع مورد استفاده برای محاسبه میانگین‌ها و مقادیر فرین (اکسترمم) اخیر را تعریف می‌کند. این مقدار به عنوان یک بازه زمانی با استفاده از نحو شرح‌داده‌شده در PCPIntro(1) برای آرگومان مشترک -t در PCP مشخص می‌شود، مانند 30 seconds یا 1 min. پیش‌فرض 60 ثانیه است.
حساب کاربری که عامل تحت آن اجرا می‌شود. در نسخه‌های فعلی PCP، پیش‌فرض حساب کاربری بدون امتیاز "pcp" است، اما در نسخه‌های قدیمی‌تر از حساب کاربری مدیر سیستم ("root") به‌طور پیش‌فرض استفاده می‌شد.
از نظر داخلی، دوره تجمیع period به بخش‌های bucket تقسیم می‌شود و میانگین متحرک هر period/bucket ثانیه یک‌بار بازتولید و محاسبه می‌شود. برای مثال، مقادیر پیش‌فرض متناظر با -T 60 و -N 12 هستند، به این معنی که میانگین هر پنج ثانیه برای دوره‌ای شامل ۶۰ ثانیه گذشته بازتولید می‌شود.
این گزینه اجازه می‌دهد بُعد (dimension) و مقیاس (scale) مرتبط با معیار مقدار مشاهده پیکربندی شوند. مقدار units یک رشته جداشده با کاما از شش مقدار صحیح است که به‌ترتیب عبارتند از: بُعد فضا، بُعد زمان، بُعد شمارش، مقیاس فضا، مقیاس زمان، و مقیاس شمارش. بُعد و مقیاس پیش‌فرض ``none'' است که معادل ارائه ``0,0,0,0,0,0'' به عنوان آرگومان به -U می‌باشد. واحدهای مرتبط با یک معیار به‌سادگی با استفاده از گزینه -d (شرح معیار) در pminfo(1) قابل مشاهده هستند. اسکریپت Install که در ادامه توضیح داده شده است، این گزینه را به‌طور کاملاً واضح طی می‌کند؛ بنابراین توصیه می‌شود برای ساخت مشخصه units از اسکریپت Install استفاده شود.

در اصل، معیارهای صادرشده آماره‌هایی در مورد زمان تکمیل هر تراکنش، و میانگین تعداد تراکنش‌های تکمیل‌شده و نقاط نظارت گذرانده‌شده در یک بازه زمانی period مشخص ارائه می‌دهند.

برای اینکه یک میزبان بتواند نام‌ها، متن راهنما و مقادیر را برای معیارهای عملکرد Trace صادر کند، دستورهای زیر را به عنوان root اجرا کنید:

# cd $PCP_PMDAS_DIR/trace
# ./Install

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

# cd $PCP_PMDAS_DIR/trace
# ./Remove

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

$PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی pmdatrace
$PCP_PMDAS_DIR/trace/help
فایل متن راهنمای پیش‌فرض برای معیارهای trace
$PCP_DEMOS_DIR/trace/*
برنامه‌های نمونه که از کتابخانه pcp_trace استفاده می‌کنند
$PCP_PMDAS_DIR/trace/Install
اسکریپت نصب برای عامل pmdatrace
$PCP_PMDAS_DIR/trace/Remove
اسکریپت لغو نصب برای pmdatrace
$PCP_LOG_DIR/pmcd/trace.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از pmdatrace

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

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

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

گزینه توضیحات
appl0 تجزیه احراز هویت، تغییرات کلاینت، IPC، تازه‌سازی داده‌های معیار و فراداده
appl1 داده‌های خام برای معیارهای نرخ

PCPIntro(1)، pmcd(1)، pmtrace(1)، PMAPI(3) و pmdatrace(3).

PCP Performance Co-Pilot