نام (NAME)

pcp, pcp-summary - اجرای یک دستور یا خلاصه‌سازی وضعیت نصب

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

pcp [pcp options...] pcp-command [command options...]
pcp [-LPV?] [-a archive] [-D debug] [-h host] [-O origin] [-n pmnsfile]

توضیحات (DESCRIPTION)

دستور pcp در یکی از دو حالت استفاده می‌شود. به‌طور پیش‌فرض، خلاصه‌ای از وضعیت نصب Performance Co-Pilot (PCP) را روی میزبان محلی ارائه می‌دهد. این حالت همچنین می‌تواند برای خلاصه‌سازی وضعیت نصب از یک host راه دور، یا یک نصب تاریخی از مجموعه‌ای از archive‌های PCP به کار رود. این حالت در صورت عدم درخواست هر دستور دیگری، به‌طور غیرمستقیم دستور pcp-summary را فراخوانی می‌کند.

در حالت دیگر، می‌توان یک command (دستور) را به pcp ارسال کرد تا اجرا شود؛ این اجرا نیز ممکن است در زمینه یک host راه دور یا مجموعه‌ای از archive‌های تاریخی صورت گیرد.

حالت دستور (COMMAND MODE)

هنگامی که pcp همراه با دستوری برای اجرا فراخوانی شود، به دنبال command نام‌برده‌شده در $PCP_BINADM_DIR و همچنین $HOME/.pcp/bin می‌گردد (این‌ها معمولاً اسکریپت هستند و با پیشوند «-pcp» نصب می‌شوند). این حالت عملیاتی اجازه می‌دهد تا ابزارهای کارایی سیستم با استفاده از خدمات PMAPI(3) پیاده‌سازی شوند، در حالی که تمام گزینه‌های معمول خط فرمان آن‌ها حفظ می‌شود. بدین ترتیب، این گزینه‌ها (به‌طور غیرمستقیم) با مجموعه گزینه‌های استاندارد PCP که در PCPIntro(1) شرح داده شده، ارتقا می‌یابند.

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

برای نمونه، ابزار pcp-free(1) را می‌توان برای داده‌های ثبت‌شده از میزبان munch به صورت زیر فراخوانی کرد:

$ pcp -a $PCP_LOG_DIR/pmlogger/munch/20140317 -O 11:35:50am free -m
             total       used       free     shared    buffers     cached
Mem:         23960      14554       9406          0        176       2137
-/+ buffers/cache:      12240      11720
Swap         12047          0      12047

فهرست کاملی از ابزارهای موجود و نصب‌شده همراه با پیام راهنمای نحوه استفاده از pcp(1) ارائه شده است، اما چند نمونه از آن‌ها عبارتند از: pcp-free(1)، pcp-uptime(1) و pcp-numastat(1).

حالت خلاصه (SUMMARY MODE)

گزارش خلاصه شامل موارد زیر است: نسخه سیستم‌عامل، خلاصه‌ای از موجودی سخت‌افزار، منطقه زمانی محلی، نسخه نرم‌افزار PCP، وضعیت فرایند pmcd(1) و عامل‌های دامنه معیارهای کارایی (PMDA) مرتبط، و همچنین اطلاعاتی درباره هر بایگان محلی PCP (pmlogger(1))، بایگان‌های راه دور PCP (pmproxy(1)) و موتورهای استنتاج PCP (pmie(1)) که در حال اجرا هستند.

تمامی مقادیر نمایش‌داده‌شده، مقادیر metric (معیار) کارایی هستند و اطلاعات بیشتر برای هر یک را می‌توان با استفاده از دستور زیر به دست آورد:

$ pminfo -dtT metric

مجموعه کامل metric‌ها که برای تولید خروجی pcp مورد نیاز است، در $PCP_VAR_DIR/config/pmlogconf/tools/pcp-summary قرار دارد.

گزینه‌های حالت خلاصه (SUMMARY MODE OPTIONS)

بدون هیچ آرگومانی، pcp وضعیت میزبان محلی را گزارش می‌کند؛ با این حال، گزینه‌های زیر پذیرفته می‌شوند:

-a archive, --archive=archive: گزارش پیکربندی PCP همان‌گونه که در مجموعه آرشیوهای PCP، یعنی archive، شرح داده شده است؛ که یک فهرست جداشده با کاما از نام‌ها است و هر یک از آن‌ها می‌تواند نام پایه یک آرشیو یا نام دایرکتوری شامل یک یا چند آرشیو باشد.
-h host, --host=host: گزارش پیکربندی PCP روی host به‌جای میزبان محلی.
-L, --local-PMDA: استفاده از یک زمینه محلی برای جمع‌آوری معیارها از PMDAهای DSO روی میزبان محلی بدون نیاز به PMCD.
-n pmnsfile, --namespace=pmnsfile: بارگذاری یک فضای نام جایگزین برای معیارهای کارایی (PMNS(5)) از فایل pmnsfile.
-O origin, --origin=origin: هنگام گزارش معیارهای آرشیوشده، شروع گزارش‌گیری از origin درون پنجره زمانی.
-P, --pmie: نمایش اطلاعات کارایی pmie(1) - شمارش قواعدی که به «درست» (true)، «نادرست» (false) یا «نامعین» (indeterminate) ارزیابی شده‌اند، به همراه نرخ مورد انتظار برای محاسبه قواعد، به ازای هر فرایند pmie در حال اجرا روی میزبان پیش‌فرض. برای جزئیات کامل در مورد این مقادیر، به متن راهنمای هر یک از معیارها مراجعه کنید.
-V, --version: نمایش شماره نسخه و خروج.
-?, --help: نمایش پیام راهنما و خروج.

خطاها (DIAGNOSTICS)

pcp در صورتی که pmcd روی میزبان هدف در دسترس نباشد یا مجموعه آرشیوها قابل باز شدن نباشد با وضعیت خروج 1 و برای هر خطای دیگر با 2 به کار خود پایان می‌دهد.

فایل‌ها (FILES)

$HOME/.pcp/bin: مکان مختص هر کاربر برای اسکریپت‌های command.
$PCP_BINADM_DIR: مکان سیستمی برای اسکریپت‌های command نصب‌شده.
$PCP_VAR_DIR/config/pmlogconf/tools/pcp-summary: فایل پیکربندی pmlogconf(1) برای جمع‌آوری تمام معیارهای مورد نیاز توسط pcp.

محیط PCP (PCP ENVIRONMENT)

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

برای متغیرهای محیطی که بر ابزارهای PCP اثر می‌گذارند، pmGetOptions(3) را ببینید.

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

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

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

PCPIntro(1), pcp-free(1), pcp-numastat(1), pcp-python(1), pcp-uptime(1), pcp-verify(1), pmcd(1), pmie(1), pmlogconf(1), pmlogger(1), pmproxy(1), pcp.conf(5), pcp.env(5) و PMNS(5).