نام (NAME)

pmdasystemd - عامل دامنه معیارهای کارایی systemd (PMDA)

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

$PCP_PMDAS_DIR/systemd/pmdasystemd [-f] [-D debug] [-d domain] [-l logfile] [-m memory] [-s interval] [-U username]

توضیحات (DESCRIPTION)

pmdasystemd یک عامل دامنه معیارهای کارایی (PMDA) برای پایش فایل لاگ systemd است. این ابزار را می‌توان مشابه با گزینهٔ -f در دستور journalctl(1) دانست و هر خط جدید لاگ را به یک رویداد کارایی تبدیل می‌کند که برای استفاده توسط ابزارهای کلاینت PMAPI(3) مانند pmevent(1) مناسب است.

عامل systemd هم معیارهای مبتنی بر رویداد (شامل رکوردهای رویداد زمان‌دار برای پیام‌های ثبت‌شده در لاگ‌های سیستم) و هم معیارهای متداول‌تر نمونه‌برداری مانند تعداد پیام‌ها و مقادیر اندازه توان‌عملیاتی را ارائه می‌دهد.

توضیح مختصری از گزینه‌های خط فرمان pmdasystemd در ادامه آمده است:

-d: بسیار حیاتی است که شماره domain (دامنه) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد. به این معنی که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای یک PMDA یکسان روی تمام میزبان‌ها استفاده شود.
-f: فیلتر کردن رکوردها بر اساس uid/gid را غیرفعال می‌کند. به‌طور پیش‌فرض، اعتبارنامه‌های کاربر و گروه برای فیلتر کردن رکوردهای لاگ ارائه‌شده به ابزار کلاینت استفاده می‌شوند تا از افشای اطلاعات به کاربران غیرمجاز جلوگیری شود. این گزینه این سازوکار را غیرفعال می‌کند، بنابراین فقط با احتیاط بسیار زیاد از آن استفاده کنید.
-l: محل فایل لاگ. به‌طور پیش‌فرض، هنگام راه‌اندازی pmdasystemd یک فایل لاگ به نام systemd.log در دایرکتوری جاری pmcd(1) نوشته می‌شود، یعنی $PCP_LOG_DIR/pmcd. اگر ایجاد فایل لاگ ممکن نباشد یا قابل نوشتن نباشد، خروجی به خطای استاندارد فرستاده می‌شود.
-m: حافظه فیزیکی مورد استفاده توسط PMDA برای بافر کردن رکوردهای رویداد را به maxsize بایت محدود می‌کند. هنگام رسیدن رویدادهای لاگ به PMDA، آن‌ها باید در بافر ذخیره شوند تا زمانی که ابزارهای کلاینت درخواست دریافت دسته بعدی رویدادها را پس از دسته قبلی ارسال کنند. حداکثر مقدار پیش‌فرض ۲ مگابایت است.
-s: بازه زمانی وارسی (polling interval) را برای شناسایی خطوط تازه ثبت‌شده لاگ تعیین می‌کند. عملکرد این گزینه مشابه گزینه هم‌نام در دستور tail(1) است.
-U: حساب کاربری که عامل تحت آن اجرا می‌شود. پیش‌فرض، حساب کاربری "adm" است.

نصب (INSTALLATION)

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

# cd $PCP_PMDAS_DIR/systemd
# ./Install

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

# cd $PCP_PMDAS_DIR/systemd
# ./Remove

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

فایل‌ها (FILES)

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

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

گزینه	توضیحات
appl0	فیلتر کردن رکوردهای ژورنال، کنترل دسترسی و تعاملات با pmcd (1)
appl2	ردیابی فراخوانی‌های select(2)

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

PCPIntro(1), pmcd(1), pmevent(1), journalctl(1), tail(1), PMAPI(3), pcp.conf(5) و pcp.env(5).