نام (NAME)

pmdaroot - عامل دامنه معیارهای کارایی و دستیار ممتاز برای PMCD

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

$PCP_PMDAS_DIR/root/pmdaroot [-D debug] [-d domain] [-l logfile] [-s sockname]

توضیحات (DESCRIPTION)

دستور pmdaroot یک عامل دامنه معیارهای کارایی (PMDA) ویژه است که همکاری نزدیکی با pmcd(1) و دیگر PMDAها دارد تا خدمات ممتاز محدودی را به این فرآیندهای فاقد دسترسی ارشد ارائه دهد.

در این نقش، برای شناسایی کانتینرهای سیستم‌عامل در حال اجرا روی میزبان محلی به کار می‌رود. همچنین این ابزار دسترسی به داده‌های کارایی را از درون آن کانتینرها برای سایر PMDAهای در حال اجرا روی میزبان فیزیکی، با استفاده از pmdaRootConnect(3) و رابط‌های فضای‌نام (namespace) مرتبط امکان‌پذیر می‌سازد.

مانند سایر PMDAها، این عامل نیز معیارهای کارایی را از دامنه‌ای که کنترل می‌کند صادر می‌نماید. در حال حاضر، این مورد محدود به اطلاعات کانتینرهای موجود در سیستم محلی است؛ اکنون کانتینرهای Docker و LXC قابل شناسایی هستند.

اگر یک نام والد غیرپیش‌فرض cgroup برای Docker استفاده می‌شود، این مقدار را می‌توان با افزودن متغیر $PCP_SYSTEMD_CGROUP در /etc/pcp.conf به pmdaroot اعلام کرد.

-d

بسیار حیاتی است که شماره domain (دامنه) معیارهای کارایی که در اینجا مشخص می‌شود، یکتا و سازگار باشد. یعنی domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA در تمام میزبان‌ها استفاده شود.

-l

مسیر فایل لاگ. به‌طور پیش‌فرض، هنگامی که pmdaroot راه‌اندازی می‌شود، یک فایل لاگ با نام root.log در دایرکتوری جاری pmcd(1) یعنی $PCP_LOG_DIR/pmcd نوشته می‌شود. اگر فایل لاگ نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خطای استاندارد (stderr) نوشته خواهد شد.

-s

مسیر سوکت دامنه unix(7) برای ارتباط با کلاینت‌هایی که درخواست عملیات با دسترسی ممتاز دارند. به‌طور پیش‌فرض، از یک فایل سوکت با نام $PCP_TMP_DIR/pmcd/root.socket استفاده می‌شود.

نصب (INSTALLATION)

دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی هسته به‌طور پیش‌فرض در دسترس است - برخلاف بیشتر عامل‌های دیگر، هیچ اقدامی برای فعال‌سازی آن‌ها لازم نیست و نباید حذف شوند.

فایل‌ها (FILES)

$PCP_PMDAS_DIR/root/help

فایل متنی راهنمای پیش‌فرض برای معیارهای صادرشده توسط PMDA ریشه.

$PCP_LOG_DIR/pmcd/root.log

فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از PMDA ریشه.

$PCP_VAR_DIR/pmcd/root.socket

فایل سوکت پیش‌فرض برای ارتباط با کلاینت‌های PMDA ریشه.

محیط PCP (PCP ENVIRONMENT)

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

گزینه‌های عیب‌یابی (DEBUGGING OPTIONS)

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

گزینه‌های عیب‌یابی ویژه pmdaroot به شرح زیر هستند:

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

PCPIntro(1)، pmcd(1)، PMDA(3)، pmdaRootConnect(3)، pcp.conf(5) و unix(7).