PMINFO(1)                   General Commands Manual                  PMINFO(1)

نام (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).

Performance Co-Pilot                  PCP                            PMINFO(1)