نام (NAME)

pminfo - نمایش اطلاعات مربوط به معیارهای کارایی

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

pminfo [-defFIlLmMstTvVxz1?] [-a archive] [-b batchsize] [-c dmfile] [--container name] [-D debug] [-h hostname] [-K spec] [-[n|N] pmnsfile] [-O time] [-r dmname=expr] [-Z timezone] [metricname | pmid | indom]...

توضیحات (DESCRIPTION)

دستور pminfo انواع مختلفی از اطلاعات را درباره معیارهای کارایی که از طریق امکانات Performance Co-Pilot (PCP) در دسترس هستند، نمایش می‌دهد.

معیارهای مورد نظر در آرگومان‌های metricname مشخص می‌شوند. اگر metricname یک گره غیربرگ در PMNS باشد، pminfo به صورت بازگشتی در PMNS پیمایش کرده و تمام گره‌های برگ را گزارش می‌دهد. اگر هیچ آرگومان metricname ارائه نشود، از ریشه PMNS استفاده می‌شود.

اگر آرگومان metricname در قالب نمادگذاری عددی نقطه‌دار باشد، یا به عنوان یک pmid سه-نقطه‌ای (شناسه معیار - شماره‌های دامنه، خوشه و قلم) یا یک indom دو-نقطه‌ای (شناسه دامنه نمونه - دامنه، شماره سریال) تفسیر می‌شود. در حالت pmid، یک جستجوی معکوس PMID-به-نام انجام می‌شود و در حالت indom، دامنه نمونه به صورت مستقیم گزارش می‌شود. از این حالت اخیر می‌توان برای گزارش خلاصه‌های متن راهنمای دامنه نمونه به شکل «یک‌خطی» یا قالب کامل استفاده کرد.

مگر اینکه توسط گزینه -h به یک میزبان دیگر هدایت شود، به‌طور پیش‌فرض pminfo با دیمن جمع‌آورنده معیارهای کارایی (PMCD) در میزبان محلی ارتباط برقرار می‌کند. اتصال به یک PMCD تنها زمانی لازم است که pminfo به اطلاعات توزیع‌شده PMNS، و/یا فراداده‌های توصیف‌کننده معیارها، و/یا مقادیر معیار، و/یا متن راهنما نیاز داشته باشد.

گزینه -a باعث می‌شود pminfo به جای اتصال به یک PMCD، از مجموعه آرشیوهای مشخص‌شده استفاده کند.

گزینه -L باعث می‌شود pminfo از یک بافت محلی برای جمع‌آوری معیارها از PMDAها روی میزبان محلی بدون نیاز به PMCD استفاده کند. تنها برخی از معیارها در این حالت در دسترس هستند.

گزینه‌های -a، -h و -L با یکدیگر مانعة‌الجمع هستند.

گزینه‌ها (OPTIONS)

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

-a archive, --archive=archive: مقادیر معیارهای کارایی از مجموعه فایل‌های آرشیو Performance Co-Pilot (PCP) مشخص‌شده توسط آرگومان archive بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌ها است که با کاما از هم جدا شده‌اند و هر کدام می‌تواند نام پایه یک آرشیو یا نام پوشه‌ای حاوی یک یا چند آرشیو باشد.
-b, --batch: این گزینه می‌تواند برای تعیین حداکثر تعداد معیارهای قابل دریافت در یک درخواست منفرد برای گزینه‌های -f و -v استفاده شود. مقدار پیش‌فرض برای batchsize برابر ۱۲۸ است.
-c dmfile, --derived=dmfile: آرگومان dmfile فایلی را مشخص می‌کند که شامل تعاریف معیارهای مشتق‌شده در قالبی است که برای pmLoadDerivedConfig(3) توضیح داده شده است. گزینه -c روشی را برای بارگذاری تعاریف سراسری معیارهای مشتق‌شده فراهم می‌کند که جایگزینی برای استفاده عمومی‌تر از متغیر محیطی PCP_DERIVED_CONFIG (همان‌طور که در PCPIntro(1) شرح داده شده) محسوب می‌شود. استفاده هم‌زمان از گزینه -c و متغیر محیطی PCP_DERIVED_CONFIG برای مشخص کردن پیکربندی یکسان ایده مناسبی نیست، بنابراین یکی از این دو روش را انتخاب کنید. همچنین گزینه -r در زیر را ببینید.
--container=container: مشخص کردن یک container خاص برای پرس‌وجو.
-d, --desc: توضیحات معیارها شامل جزئیات مربوط به PMID، نوع داده، معناشناسی داده، واحدها، مقیاس و دامنه نمونه مرتبط.
-1, --desc-oneline: مشابه -d است، با این تفاوت که توضیحات معیار به صورت یک خط به ازای هر معیار و با فیلدهایی که با تب (\t) جدا شده‌اند (بدون متن نام فیلد) قالب‌بندی می‌شوند. این قالب برای اسکریپت‌هایی مناسب است که از خروجی pminfo استفاده می‌کنند.
-e, --metadata-errors: مشابه -v است، اما معیارهایی را که هیچ مقداری برنمی‌گردانند گزارش نمی‌کند؛ بنابراین هر معیاری که گزارش شود دارای خطاهای پایدار یا فراداده‌های ناسازگار است.
-f, --fetch: دریافت و چاپ مقادیر برای تمام نمونه‌ها. هنگام دریافت اطلاعات از مجموعه‌ای از آرشیوها، تنها آن نمونه‌هایی که در نخستین رکورد آرشیو برای یک معیار وجود دارند نمایش داده می‌شوند؛ همچنین گزینه -O را ببینید، در غیر این صورت از pmlogdump(1) استفاده کنید که ممکن است ابزار مناسب‌تری برای بررسی آرشیوها باشد.
-F, --fetchall: مشابه -f است، اما تلاش بیشتری برای دریافت نمونه‌ها در معیارهایی که دامنه‌های نمونه غیرقابل شمارش دارند (مانند معیارهای موجود در زیردرخت «proc» از PMNS پیش‌فرض در برخی سیستم‌ها) انجام می‌دهد.
-h host, --host=host: دریافت معیارهای کارایی از pmcd(1) روی host، به جای localhost پیش‌فرض.
-I, --fullindom: چاپ InDom در حالت پرحرف (verbose).
-K spec, --spec-local=spec: هنگام استفاده از گزینه -L برای دریافت معیارها از یک بافت محلی، این گزینه DSO PMDAهایی را که باید در دسترس قرار گیرند کنترل می‌کند. آرگومان spec از نحوی که در pmSpecLocalPMDA(3) شرح داده شده، پیروی می‌کند. می‌توان از بیش از یک گزینه -K استفاده کرد.
-l, --labels: چاپ مجموعه‌های برچسب مرتبط با معیارها و نمونه‌ها. برچسب‌ها فراداده‌های اختیاری معیار هستند که جزئیات آن‌ها در pmLookupLabels(3) توضیح داده شده است.
-L, --local-PMDA: استفاده از یک بافت محلی برای جمع‌آوری معیارها از DSO PMDAها روی میزبان محلی بدون نیاز به PMCD. همچنین ببینید: -K.
-m, --pmid: چاپ PMID در حالت مختصر (terse).
-M, --fullpmid: چاپ PMID در حالت پرحرف (verbose)..TP -n pmnsfile, --namespace=pmnsfile به‌طور معمول pminfo روی فضای نام معیارهای کارایی (PMNS) توزیع‌شده عمل می‌کند، اما اگر گزینهٔ -n مشخص شود، یک PMNS محلی جایگزین از فایل pmnsfile بارگذاری می‌شود.
-N pmnsfile, --uniqnames=pmnsfile: گزینهٔ -N عملکردی مشابه با -n دارد، به جز در نحوهٔ مدیریت نام‌های تکراری برای یک شناسه معیار کارایی (PMID) یکسان در pmnsfile - نام‌های تکراری با -n مجاز هستند، اما با -N مجاز نمی‌باشند.
-O time, --origin=time: هنگامی که در ترکیب با یک منبع آرشیو از معیارها و گزینه‌های -f/ استفاده شود، آرگومان time یک مبدأ زمانی را مشخص می‌کند که در آن معیارها باید از مجموعهٔ آرشیوها واکشی شوند. برای توضیحات کامل دربارهٔ این گزینه و ساختار نحوی آرگومان time، به PCPIntro(1) مراجعه کنید.
-r dmname=expr, --register=dmname=expr: ثبت یک معیار اشتقاقی به‌ازای زمینه با استفاده از pmAddDerivedMetric(3). dmname نام معیار اشتقاقی جدید است و expr عبارت مربوط به معیار اشتقاقی است که از ساختار نحوی شرح داده شده در pmRegisterDerived(3) پیروی می‌کند. استفاده از چندین گزینهٔ -r مجاز است. همچنین گزینهٔ -c در بالا را ببینید.
-s, --series: شناسه‌های سری زمانی مرتبط با معیارها، نمونه‌ها و منابع را چاپ می‌کند. این شناسه‌های یکتا بر اساس برچسب‌های ذاتی (غیر اختیاری) و سایر فراداده‌های معیار مرتبط با هر زمینهٔ PMAPI (منابع)، معیارها و نمونه‌ها محاسبه می‌شوند. اتصالات آرشیو، زمینهٔ محلی یا pmcd(1) برای یک میزبان یکسان همگی شناسهٔ منبع یکسانی را تولید می‌کنند. همچنین pmLookupLabels(3) و گزینهٔ -l را ببینید.
-t, --oneline: چاپ خلاصهٔ راهنمای «یک‌خطی»، در صورت موجود بودن.
-T, --helptext: چاپ متن راهنما، در صورت موجود بودن.
-v, --verify: حالت راستی‌آزمایی که در آن شرح‌ها و مقادیر بازیابی می‌شوند، اما فقط شرایط خطا گزارش می‌گردد. این گزینه در سکوت هرگونه خروجی از گزینه‌های -f/--fetch، -l/--labels، -I/--fullindom، -M/--fullpmid، -m/--pmid، -t/--oneline و -T/--helptext را غیرفعال می‌کند.
-V, --version: نمایش شمارهٔ نسخه و خروج.
-x, --events: مانند گزینهٔ -f/--fetch، اما با این قابلیت اضافی که اگر مقداری پردازش شود که از نوع PM_TYPE_EVENT یا PM_TYPE_HIGHRES_EVENT باشد، رکوردهای رویداد بازگشایی شده و جزئیات هر رکورد رویداد گزارش خواهد شد.
-z, --hostzone: تغییر منطقهٔ زمانی گزارش به منطقهٔ زمانی محلی میزبانی که منبع معیارهای کارایی است، همان‌طور که از طریق گزینه‌های -h یا -a شناسایی شده است.
-Z timezone, --timezone=timezone: به‌طور پیش‌فرض، pminfo زمان روز را مطابق با منطقهٔ زمانی محلی سامانه‌ای که pminfo روی آن اجرا می‌شود گزارش می‌دهد. گزینهٔ -Z منطقهٔ زمانی را به timezone در قالب متغیر محیطی TZ همان‌گونه که در environ(7) شرح داده شده تغییر می‌دهد.
-?, --help: نمایش پیام نحوهٔ استفاده و خروج.

فایل‌ها (FILES)

$PCP_VAR_DIR/pmns/*: فایل‌های مشخصات محلی پیش‌فرض PMNS

محیط پی‌سی‌پی (PCP ENVIRONMENT)

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

برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به pmGetOptions(3) مراجعه کنید..SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)" گزینهٔ -D یا --debug ارائهٔ اطلاعات تشخیصی اضافی را روی stderr فعال می‌کند تا به عیب‌یابی و ریشه‌یابی مشکلات کمک کند، اگرچه این اطلاعات گاهی مبهم بوده و در درجهٔ اول برای راهنمایی توسعه‌دهندگان طراحی شده است تا کاربران نهایی. debug فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از pmdbg(1) به همراه گزینهٔ -l برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و مفهوم آن‌ها استفاده کنید.

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

گزینه	توضیحات
appl4	گزارش کوچک‌سازی دسته در صورتی که batchsize از حداکثر اندازهٔ PDU تجاوز کند
appl5	تخلیهٔ آمار PDU در پایان، اگر context یک میزبان باشد

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

PCPIntro(1), pmcd(1), pmchart(1), pmlogdump(1), pmprobe(1), pmrep(1), pmval(1), PMAPI(3), pmAddDerivedMetric(3), pmGetOptions(3), pmLoadDerivedConfig(3), pmLookupLabels(3), pmRegisterDerived(3), pmSpecLocalPMDA(3), PMNS(5), pcp.conf(5) و pcp.env(5).