'\" t
.\"
.\" Copyright (c) 2014 Red Hat.
.\"
.\" 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 PMDALOGGER 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdalogger \- عامل دامنه معیارهای کارایی (PMDA) برای فایل‌های ثبت وقایع
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/logger/pmdalogger\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-m\f1 \f2memory\f1]
[\f3\-s\f1 \f2interval\f1]
[\f3\-U\f1 \f2username\f1]
[\f2configfile\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdalogger
یک عامل دامنه معیارهای کارایی (PMDA) با قابلیت پیکربندی برای پایش فایل‌های ثبت وقایع (log) است.
این ابزار مشابه با گزینهٔ
.B \-f
در دستور
.BR tail (1)
عمل می‌کند و هر سطر جدید در لاگ را به یک رویداد کارایی تبدیل می‌نماید.
این ابزار نخستین PMDA بود که استفادهٔ گسترده‌ای از معیارهای رویدادی کرد؛ معیارهایی که می‌توانند توسط ابزارهای کلاینت مانند
.BR pmevent (1)
دریافت و مصرف شوند.
.PP
عامل
.B logger
PMDA هم معیارهای سبک رویدادی بازتاب‌دهندهٔ رکوردهای رویداد زمان‌دار برای متون ثبت‌شده در یک فایل (یا مجموعه‌ای از فایل‌ها یا خروجی یک فرایند) را صادر می‌کند، و هم معیارهای متداول‌تر سبک نمونه‌برداری مانند تعداد رویدادها و مقادیر حجم توان عملیاتی را ارائه می‌دهد.
.PP
این PMDA از طریق یک
.I configfile
پیکربندی می‌شود که برای هر منبع رویداد (فایل یا فرایند) شامل یک سطر است.
این فایل توسط اسکریپت Install که در بخش بعدی تحت عنوان «نصب (INSTALLATION)» این PMDA شرح داده شده، برپا می‌شود.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdalogger
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شمارهٔ دامنه (
.IR domain
) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد.
بدین معنا که
.I domain
باید برای هر PMDA روی یک میزبان مشخص متفاوت باشد، و همان شمارهٔ
.I domain
باید برای همین PMDA در تمام میزبان‌ها به کار رود.
.TP
.B \-l
مکان فایل لاگ. به‌طور پیش‌فرض، هنگامی که
.B pmdalogger
شروع به کار می‌کند، فایل لاگی به نام
.I logger.log
در دایرکتوری جاری
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر ایجاد فایل لاگ ممکن نباشد یا قابل نوشتن نباشد، خروجی به‌جای آن به خطای استاندارد (stderr) ارسال می‌شود.
.TP
.B \-m
میزان حافظهٔ فیزیکی مصرفی توسط PMDA برای بافر کردن رکوردهای رویداد را به
.I maxsize
بایت محدود می‌کند.
با ورود رویدادهای لاگ به PMDA، آن‌ها باید تا زمانی که ابزارهای کلاینت مجزا دستهٔ بعدی رویدادها را پس از دستهٔ قبلی درخواست کنند، در بافر نگهداری شوند.
مقدار بیشینهٔ پیش‌فرض ۲ مگابایت است.
.TP
.B \-s
بازهٔ زمانی بررسی دوره‌ای (polling interval) را برای شناسایی سطرهای تازه‌رسیدهٔ لاگ تعیین می‌کند.
این گزینه مشابه با همان گزینه در دستور
.BR tail (1)
است.
.TP
.B \-U
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض در نسخه‌های فعلی PCP حساب کاربری بدون امتیاز "pcp" است، اما در نسخه‌های قدیمی‌تر به‌طور پیش‌فرض از حساب کاربری ریشه ("root") استفاده می‌شد.
.SH "نصب (INSTALLATION)"
اگر خواهان دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی logger هستید، دستورات زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/logger
# ./Install
.in
.fi
.ft 1
.PP
این یک فرایند نصب تعاملی است که مسیر هر فایل لاگ مورد نظر برای پایش (یا دستور برای اجرا)، یک نام نمونهٔ معیار برای شناسایی آن، و لزوم محدودسازی دسترسی را جویا می‌شود (برای جزئیات بیشتر به گزینهٔ
.B \-x
در
.BR pmevent (1)
مراجعه کنید).
.PP
اگر می‌خواهید نصب را لغو (حذف) کنید، دستورات زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/logger
# ./Remove
.in
.fi
.ft 1
.PP
ابزار
.B pmdalogger
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا گردد.
اسکریپت‌های Install و Remove پس از نصب یا حذف عامل، این موضوع را به
.BR pmcd (1)
اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdalogger
.TP 10
.B $PCP_PMDAS_DIR/logger/logger.conf
فایل پیکربندی پیش‌فرض برای معیارهای logger
.TP 10
.B $PCP_PMDAS_DIR/logger/help
فایل متنی راهنمای پیش‌فرض برای معیارهای logger
.TP 10
.B $PCP_PMDAS_DIR/logger/Install
اسکریپت نصب برای عامل
.B pmdalogger
.TP 10
.B $PCP_PMDAS_DIR/logger/Remove
اسکریپت لغو نصب برای عامل
.B pmdalogger
.TP 10
.B $PCP_LOG_DIR/pmcd/logger.log
فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdalogger
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای مقداردهی و پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده در PCP به کار می‌روند.
در هر نصب، فایل
.I /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 pmdalogger
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	پردازش \fIconfigfile\fP و برپاسازی PMNS
_
appl1	بارگذاری داده‌های رویداد از فایل‌های لاگ
_
appl2	تعامل با \fBpmcd\fP(1).
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmevent (1)،
.BR pmcd (1)،
.BR tail (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ maxsize