نام (NAME)

pmdalogger - عامل دامنه معیارهای کارایی (PMDA) برای فایل‌های ثبت وقایع

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

$PCP_PMDAS_DIR/logger/pmdalogger [-D debug] [-d domain] [-l logfile] [-m memory] [-s interval] [-U username] [configfile]

توضیحات (DESCRIPTION)

دستور pmdalogger یک عامل دامنه معیارهای کارایی (PMDA) با قابلیت پیکربندی برای پایش فایل‌های ثبت وقایع (log) است. این ابزار مشابه با گزینهٔ -f در دستور tail(1) عمل می‌کند و هر سطر جدید در لاگ را به یک رویداد کارایی تبدیل می‌نماید. این ابزار نخستین PMDA بود که استفادهٔ گسترده‌ای از معیارهای رویدادی کرد؛ معیارهایی که می‌توانند توسط ابزارهای کلاینت مانند pmevent(1) دریافت و مصرف شوند.

عامل logger PMDA هم معیارهای سبک رویدادی بازتاب‌دهندهٔ رکوردهای رویداد زمان‌دار برای متون ثبت‌شده در یک فایل (یا مجموعه‌ای از فایل‌ها یا خروجی یک فرایند) را صادر می‌کند، و هم معیارهای متداول‌تر سبک نمونه‌برداری مانند تعداد رویدادها و مقادیر حجم توان عملیاتی را ارائه می‌دهد.

این PMDA از طریق یک configfile پیکربندی می‌شود که برای هر منبع رویداد (فایل یا فرایند) شامل یک سطر است. این فایل توسط اسکریپت Install که در بخش بعدی تحت عنوان «نصب (INSTALLATION)» این PMDA شرح داده شده، برپا می‌شود.

شرح مختصری از گزینه‌های خط فرمان pmdalogger در ادامه آمده است:

-d: بسیار حیاتی است که شمارهٔ دامنه ( domain ) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد. بدین معنا که domain باید برای هر PMDA روی یک میزبان مشخص متفاوت باشد، و همان شمارهٔ domain باید برای همین PMDA در تمام میزبان‌ها به کار رود.
-l: مکان فایل لاگ. به‌طور پیش‌فرض، هنگامی که pmdalogger شروع به کار می‌کند، فایل لاگی به نام logger.log در دایرکتوری جاری pmcd(1) نوشته می‌شود، یعنی $PCP_LOG_DIR/pmcd. اگر ایجاد فایل لاگ ممکن نباشد یا قابل نوشتن نباشد، خروجی به‌جای آن به خطای استاندارد (stderr) ارسال می‌شود.
-m: میزان حافظهٔ فیزیکی مصرفی توسط PMDA برای بافر کردن رکوردهای رویداد را به maxsize بایت محدود می‌کند. با ورود رویدادهای لاگ به PMDA، آن‌ها باید تا زمانی که ابزارهای کلاینت مجزا دستهٔ بعدی رویدادها را پس از دستهٔ قبلی درخواست کنند، در بافر نگهداری شوند. مقدار بیشینهٔ پیش‌فرض ۲ مگابایت است.
-s: بازهٔ زمانی بررسی دوره‌ای (polling interval) را برای شناسایی سطرهای تازه‌رسیدهٔ لاگ تعیین می‌کند. این گزینه مشابه با همان گزینه در دستور tail(1) است.
-U: حساب کاربری که عامل تحت آن اجرا می‌شود. پیش‌فرض در نسخه‌های فعلی PCP حساب کاربری بدون امتیاز "pcp" است، اما در نسخه‌های قدیمی‌تر به‌طور پیش‌فرض از حساب کاربری ریشه ("root") استفاده می‌شد.

نصب (INSTALLATION)

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

# cd $PCP_PMDAS_DIR/logger
# ./Install

این یک فرایند نصب تعاملی است که مسیر هر فایل لاگ مورد نظر برای پایش (یا دستور برای اجرا)، یک نام نمونهٔ معیار برای شناسایی آن، و لزوم محدودسازی دسترسی را جویا می‌شود (برای جزئیات بیشتر به گزینهٔ -x در pmevent(1) مراجعه کنید).

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

# cd $PCP_PMDAS_DIR/logger
# ./Remove

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

فایل‌ها (FILES)

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

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

گزینه	توضیحات
appl0	پردازش configfile و برپاسازی PMNS
appl1	بارگذاری داده‌های رویداد از فایل‌های لاگ
appl2	تعامل با pmcd(1).

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

PCPIntro(1)، pmevent(1)، pmcd(1)، tail(1)، pcp.conf(5) و pcp.env(5).