PMREPCONF(1) General Commands Manual PMREPCONF(1)

pmrepconf - ساخت یا ویرایش فایل پیکربندی pmrep

pmrepconf [-crvV?] [-D debug] [-d groupsdir] [-g grouptag] [-o option] [-h host] configfile

pmrepconf می‌تواند برای ساخت و تغییر یک فایل پیکربندی عمومی برای pmrep(1) و ابزارهای مرتبط در قالب pmrep.conf(5) به کار رود.

اگر configfile وجود نداشته باشد، pmrepconf یک فایل پیکربندی عمومی به همراه مجموعه‌ای از معیارهای شناسایی‌شده در بخش [metrics] ایجاد خواهد کرد.

پس از ایجاد، configfile می‌تواند با گزینهٔ -c همراه با pmrep(1) و ابزارهای مرتبط مانند pcp2elasticsearch(2) و pcp2spark(2) استفاده شود.

اگر configfile وجود داشته باشد، pmrepconf از کاربر درخواست ورودی می‌کند تا گروه‌هایی از معیارهای کارایی مرتبط را فعال یا غیرفعال سازد.

انتخاب گروه نیازمند یک پاسخ سادهٔ y (بله) یا n (خیر) به اعلان Log this group? است.

پاسخ‌های دیگر در این مرحله می‌توانند برای انتخاب توابع کنترلی بیشتر به شرح زیر استفاده شوند:

گزارش نام معیارهای موجود در گروه جاری.
پایان دادن به انتخاب گروه (خروج) و اعمال نکردن تغییرات بیشتر روی این گروه یا هر یک از گروه‌های بعدی.
/pattern
تغییری در این گروه ایجاد نکن، اما به دنبال گروهی بگرد که شامل pattern در توضیحات گروه یا نام معیارهای مرتبط با آن باشد.

هنگام اجرا از فرآیندهای راه‌اندازی خودکار، گزینهٔ -c برای نشان دادن این که pmrepconf در حالت ایجاد خودکار قرار دارد و هیچ گفتگوی تعاملی صورت نمی‌گیرد استفاده می‌شود. فایل خروجی configfile دارای یک پیام توضیحی اضافی و برچسب زمانی است که این موضوع را نشان می‌دهد، تا بتوان آن را شناسایی کرد و بعداً با استفادهٔ مجدد از -c به‌روزرسانی نمود. این گزینه برای استفادهٔ تعاملی از ابزار مناسب نیست.

خروجی با جزئیات بیشتر را می‌توان با گزینهٔ -v فعال کرد.

هنگامی که یک configfile اولیه ایجاد می‌شود، مشخصات پیش‌فرض از مجموعه‌ای از فایل‌های گروه در زیر groupsdir مشخص‌شده با گزینهٔ -d دریافت می‌شوند (مقدار پیش‌فرض groupsdir برابر با $PCP_VAR_DIR/config/pmlogconf است که در اکثر موارد درست است، بنابراین گزینهٔ -d در عمل به ندرت استفاده می‌شود).

ساختار دایرکتوری و قالب فایل‌های زیر groupsdir با ابزار pmlogconf (1) مشترک است و با جزئیات کامل در آن صفحهٔ راهنما توضیح داده شده است. هنگامی که توسط pmrepconf استفاده می‌شود، تمام تنظیمات بازه زمانی نادیده گرفته می‌شوند.

گزینه‌های موجود خط فرمان عبارتند از:

فعال‌سازی حالت غیرتعاملی و ایجاد خودکار.
مسیر دایرکتوری groupsdir را مشخص می‌کند.
وضعیت ثبت گزارش برای گروه خاصی با نام grouptag را پرس‌وجو می‌کند.
منبع معیارهای کارایی، pmcd(1) روی host است، به جای پیش‌فرض localhost.
گزینه‌ای را برای اضافه شدن به بخش [option] از فایل تولیدشدهٔ pmrep.conf(5) مشخص می‌کند. این گزینه خط فرمان می‌تواند چندین بار مشخص شود تا چندین خط در بخش [option] اضافه گردد.
بررسی مجدد تمام گروه‌ها برای گنجاندن در configfile.
فعال‌سازی حالت باجزئیات (verbose).
نمایش شماره نسخه و خروج.
-?, --help
نمایش پیام راهنما و خروج.

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

pmrepconf به دلایل کارایی، مقدار هرگونه متغیر محیطی $PCP_DERIVED_CONFIG را با یک رشتهٔ خالی بازنویسی (override) می‌کند.

pmrepconf هنگام کاوش و ایجاد فایل‌های پیکربندی جدید pmrep متغیر محیطی $PMCD_WAIT_TIMEOUT را رعایت می‌کند. در صورت عدم تنظیم این متغیر در محیط، از مقدار پیش‌فرض زمان انتظار ۱۰ ثانیه برای این کار استفاده می‌کند.

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

pcp2elasticsearch(1), pcp2spark(1), pmcd(1), pmlogconf(1), pmrep(1), pcp.conf(5), pcp.env(5) و pmrep.conf(5)

PCP Performance Co-Pilot