'\" t
.\"
.\" Copyright (c) 2012 Red Hat.
.\" Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" 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 PMDATRACE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdatrace\f1 \- عامل دامنه معیارهای عملکرد تراکنش در سطح برنامه
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/trace/pmdatrace\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-A\f1 \f2access\f1]
[\f3\-I\f1 \f2port\f1]
[\f3\-M\f1 \f2username\f1]
[\f3\-N\f1 \f2buckets\f1]
[\f3\-T\f1 \f2period\f1]
[\f3\-U\f1 \f2units\f1]
.SH "توضیحات (DESCRIPTION)"
برنامه
.B pmdatrace
یک «عامل دامنه معیارهای عملکرد» (PMDA) است که معیارهای عملکرد تراکنش را از فرایندهای برنامه‌ای که از کتابخانه
.I pcp_trace
(شرح‌داده‌شده در
.BR pmdatrace (3))
استفاده می‌کنند، صادر می‌کند.
.PP
شرح کوتاهی از گزینه‌های خط فرمان
.B pmdatrace
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) معیارهای عملکرد مشخص‌شده در اینجا یکتا و سازگار باشد.
بدین معنا که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.
.TP 5
.B \-l
محل فایل گزارش (log). به‌طور پیش‌فرض، یک فایل گزارش با نام
.I trace.log
در دایرکتوری جاری
.BR pmcd (1)
در هنگام شروع
.B pmdatrace
(یعنی
.BR $PCP_LOG_DIR/pmcd )
نوشته می‌شود. اگر فایل گزارش ایجاد نشود یا قابل نوشتن نباشد، خروجی در خطای استاندارد نوشته خواهد شد.
.TP 5
.B \-A
کنترل دسترسی مبتنی بر میزبان برای
.BR pmdatrace .
مقدار
.I access
باید یک مشخصه مجاز یا منع با استفاده از allow:hostspec:maxconns یا disallow:hostspec باشد، که در آن `allow' و `disallow' کلمات کلیدی هستند، `hostspec' مشخصه میزبانی است که از قالب استفاده‌شده توسط هر دوی
.BR pmcd (1)
و
.BR pmlogger (1)
پیروی می‌کند، و `maxconns' حداکثر تعداد اتصالات مجاز از یک `hostspec' مشخص است.
استفاده از صفر برای حداکثر اتصالات، نشان‌دهنده تعداد نامحدود اتصالات برای `hostspec' مربوطه است.
.TP 5
.B \-I
ارتباط با کلاینت‌های
.I pcp_trace
از طریق
.IR port
اینترنتی مشخص‌شده. این مقدار را می‌توان با تنظیم متغیر محیطی
.B $PCP_TRACE_PORT
روی یک شماره پورت معتبر نیز تعیین کرد (استفاده از گزینه
.B \-I
این متغیر را نادیده می‌گیرد).
شماره پورت پیش‌فرض 4323 است.
.TP 5
.B \-T
مقدار \f2period\f1 دوره تجمیع مورد استفاده برای محاسبه میانگین‌ها و مقادیر فرین (اکسترمم) اخیر را تعریف می‌کند.
این مقدار به عنوان یک بازه زمانی با استفاده از نحو شرح‌داده‌شده در
.BR PCPIntro (1)
برای آرگومان مشترک
.B \-t
در PCP مشخص می‌شود، مانند \c
.B "30 seconds"
یا
.BR "1 min" .
پیش‌فرض 60 ثانیه است.
.TP 5
.B \-M
حساب کاربری که عامل تحت آن اجرا می‌شود.
در نسخه‌های فعلی PCP، پیش‌فرض حساب کاربری بدون امتیاز "pcp" است، اما در نسخه‌های قدیمی‌تر از حساب کاربری مدیر سیستم ("root") به‌طور پیش‌فرض استفاده می‌شد.
.TP 5
.B \-N
از نظر داخلی، دوره تجمیع \f2period\f1 به بخش‌های \f2bucket\f1 تقسیم می‌شود و میانگین متحرک هر
\f2period\f1/\f2bucket\f1
ثانیه یک‌بار بازتولید و محاسبه می‌شود.
برای مثال، مقادیر پیش‌فرض متناظر با \-T 60 و \-N 12 هستند، به این معنی که میانگین هر پنج ثانیه برای دوره‌ای شامل ۶۰ ثانیه گذشته بازتولید می‌شود.
.TP 5
.B \-U
این گزینه اجازه می‌دهد بُعد (dimension) و مقیاس (scale) مرتبط با معیار مقدار مشاهده پیکربندی شوند.
مقدار \f2units\f1 یک رشته جداشده با کاما از شش مقدار صحیح است که به‌ترتیب عبارتند از: بُعد فضا، بُعد زمان، بُعد شمارش، مقیاس فضا، مقیاس زمان، و مقیاس شمارش.
بُعد و مقیاس پیش‌فرض ``none'' است که معادل ارائه ``0,0,0,0,0,0'' به عنوان آرگومان به \-U می‌باشد.
واحدهای مرتبط با یک معیار به‌سادگی با استفاده از گزینه \-d (شرح معیار) در
.BR pminfo (1)
قابل مشاهده هستند.
اسکریپت Install که در ادامه توضیح داده شده است، این گزینه را به‌طور کاملاً واضح طی می‌کند؛ بنابراین توصیه می‌شود برای ساخت مشخصه \f2units\f1 از اسکریپت Install استفاده شود.
.PP
در اصل، معیارهای صادرشده آماره‌هایی در مورد زمان تکمیل هر تراکنش، و میانگین تعداد تراکنش‌های تکمیل‌شده و نقاط نظارت گذرانده‌شده در یک بازه زمانی \f2period\f1 مشخص ارائه می‌دهند.
.SH "نصب (INSTALLATION)"
برای اینکه یک میزبان بتواند نام‌ها، متن راهنما و مقادیر را برای معیارهای عملکرد Trace صادر کند، دستورهای زیر را به عنوان root اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/trace
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را به عنوان root اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/trace
# ./Remove
.in
.fi
.ft 1
.PP
برنامه
.B pmdatrace
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود.
اسکریپت‌های Install و Remove در زمان نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdatrace
.TP 10
.B $PCP_PMDAS_DIR/trace/help
فایل متن راهنمای پیش‌فرض برای معیارهای trace
.TP 10
.B $PCP_DEMOS_DIR/trace/*
برنامه‌های نمونه که از کتابخانه
.I pcp_trace
استفاده می‌کنند
.TP 10
.B $PCP_PMDAS_DIR/trace/Install
اسکریپت نصب برای عامل
.B pmdatrace
.TP 10
.B $PCP_PMDAS_DIR/trace/Remove
اسکریپت لغو نصب برای
.B pmdatrace
.TP 10
.B $PCP_LOG_DIR/pmcd/trace.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdatrace
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر بار نصب، فایل
.B /etc/pcp.conf
شامل مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
توضیح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی‌های اضافی را روی
.I stderr
فعال می‌کند تا به بررسی مشکلات کمک کند، اگرچه اطلاعات گاهی مبهم است و در وهله اول برای ارائه راهنمایی به توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی.
مقدار
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مختص به
.B pmdatrace
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
.ad l
تجزیه احراز هویت، تغییرات کلاینت، IPC،
تازه‌سازی داده‌های معیار و فراداده
T}
_
appl1	T{
.ad l
داده‌های خام برای معیارهای نرخ
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmtrace (1)،
.BR PMAPI (3)
و
.BR pmdatrace (3).

.\" control lines for scripts/man-spell
.\" +ok+ hostspec maxconns pcp_trace