نام (NAME)

pmprobe - کاوشگر سبک‌وزن برای معیارهای کارایی

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

pmprobe [-dfFiILvVz?] [-a archive] [-b batchsize] [--container=name] [-D debug] [--derived=file] [-h hostname] [-K spec] [-n pmnsfile] [-O time] [-Z timezone] [metricname ...]

توضیحات (DESCRIPTION)

دستور pmprobe در دسترس بودن معیارهای کارایی ارائه‌شده از طریق امکانات Performance Co-Pilot (PCP) را مشخص می‌کند.

معیارهای مورد نظر در آرگومان‌های metricname تعیین می‌شوند. اگر metricname یک گره غیربرگ در فضای نام معیارهای کارایی (PMNS(5)) باشد، آن‌گاه pmprobe به‌صورت بازگشتی در PMNS به پایین پیمایش کرده و تمام گره‌های برگ را گزارش می‌دهد. اگر هیچ آرگومان metricname داده نشود، از ریشهٔ فضای نام استفاده خواهد شد.

این بسط بازگشتی PMNS می‌تواند توسط گزینهٔ -F (حرکت سریع‌تر) مهار شود؛ گزینه‌ای که در صورت معلوم بودن برگ بودن آرگومان‌های metricname از پیش، تعداد رفت‌وبرگشت‌ها به pmcd(1) را کاهش می‌دهد.

قالب خروجی ساده و کم‌پیرایه بوده و برای استفاده در اسکریپت‌های پوششی (wrapper) جهت ایجاد فایل‌های پیکربندی برای سایر ابزارهای PCP در نظر گرفته شده است. به‌طور پیش‌فرض، برای هر معیار یک خط خروجی وجود دارد که شامل نام معیار و در پی آن تعداد مقادیرِ در دسترس است. شرایط خطا به‌صورت یک مقدار شمارش منفی کدگذاری می‌شوند (مطابق پروتکل‌های PMAPI(3)، اما با استفاده از pmerr(1) قابل رمزگشایی هستند) و به دنبال آن توضیحی متنی از خطا ارائه می‌شود.

مگر اینکه توسط گزینهٔ -h به میزبان دیگری هدایت شود، pmprobe با دیمن جمع‌آوری معیارهای کارایی (PMCD) در میزبان محلی ارتباط برقرار می‌کند.

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

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

گزینه‌های -a، -h و -L مانعة‌الجمع هستند..SH "گزینه‌ها (OPTIONS)" گزینه‌های خط فرمان موجود عبارتند از:

-a archive, --archive=archive

مقادیر متریک کارایی از مجموعه‌ای از فایل‌های بایگانی Performance Co-Pilot (PCP) که با آرگومان archive مشخص شده‌اند، بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌ها است که با کاما از هم جدا شده‌اند، و هر کدام می‌تواند نام پایه یک بایگانی یا نام دایرکتوری شامل یک یا چند بایگانی باشد.

-b, --batch

این گزینه می‌تواند برای تعیین حداکثر تعداد متریک‌هایی استفاده شود که در یک درخواست برای گزینه -v و هر درخواست pmLookupName(3) که pmprobe با فهرستی از نام‌های متریک برگ فراخوانی می‌کند، واکشی شوند. مقدار پیش‌فرض برای batchsize برابر ۱۲۸ است. این گزینه برای جلوگیری از محدودیت‌های اندازه درخواست PDU و همچنین توزیع واکشی‌ها در زمان مفید است، که در غیر این صورت اگر pmcd(1) یا یک PMDA در پاسخگویی کند باشد، به‌ویژه در صورت بررسی تعداد زیادی متریک، ممکن است با انقضای زمان مواجه شود.

--container=container

یک container منفرد را برای پرس‌وجو مشخص می‌کند.

-d, --version

نمایش شماره نسخه و خروج.

--derived=dmfile

آرگومان dmfile فایلی شامل تعاریف متریک‌های مشتق‌شده را در قالبی که برای pmLoadDerivedConfig(3) شرح داده شده است، مشخص می‌کند. این گزینه روشی برای بارگذاری تعاریف متریک‌های مشتق‌شده فراهم می‌کند که جایگزینی برای استفاده عمومی‌تر از متغیر محیطی PCP_DERIVED_CONFIG همان‌طور که در PCPIntro(1) توضیح داده شده است، می‌باشد. استفاده از گزینه --derived و متغیر محیطی PCP_DERIVED_CONFIG برای تعیین همان پیکربندی ایده بدی است، بنابراین یکی از این دو روش را انتخاب کنید.

-f, --force

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

-F, --faster

فرض می‌کند که نام‌های متریک داده‌شده گره‌های برگ PMNS هستند.

-h host, --host=host

اتصال به pmcd(1) روی host، به جای localhost پیش‌فرض.

-i, --internal

شناسه‌های درونی را برای هر نمونه گزارش می‌کند. مقادیر در مبنای دهدهی بوده و پیشوند ``?'' دارند. به عنوان یک حالت خاص، رشته مستقیم PM_IN_NULL برای متریک‌های منفرد گزارش می‌شود.

-I, --external

شناسه‌های بیرونی را برای هر نمونه گزارش می‌کند. رشته مستقیم PM_IN_NULL برای متریک‌های منفرد گزارش می‌شود.

-K spec, --spec-local=spec

هنگام استفاده از گزینه -L/ برای واکشی متریک‌ها از یک بافت محلی، این گزینه PMDAهای DSO را که باید قابل دسترس شوند، کنترل می‌کند. آرگومان spec از نحو شرح داده شده در pmSpecLocalPMDA(3) پیروی می‌کند. می‌توان از بیش از یک گزینه -K استفاده کرد.

-L, --local-PMDA

از یک بافت محلی برای جمع‌آوری متریک‌ها از DSO PMDAها روی میزبان محلی بدون PMCD استفاده می‌کند. همچنین ببینید: -K.

-n pmnsfile, --namespace=pmnsfile

در حالت عادی pmprobe روی فضای نام توزیع‌شده متریک‌های کارایی (PMNS) عمل می‌کند، با این حال، اگر گزینه -n مشخص شود، یک فایل PMNS محلی جایگزین از فایل pmnsfile بارگذاری می‌شود.

-O time, --origin=time

هنگامی که همراه با یک منبع بایگانی از متریک‌ها و گزینه‌های -f/ استفاده شود، آرگومان time مبدأ زمانی را مشخص می‌کند که متریک‌ها باید در آن زمان از مجموعه بایگانی‌ها واکشی شوند. برای توضیحات کامل این گزینه و نحو آرگومان time به PCPIntro(1) مراجعه کنید.

-v, --values

مقدار را برای هر نمونه، مطابق با قواعد قالب‌بندی pmPrintValue(3) گزارش می‌کند. هنگام واکشی از مجموعه‌ای از بایگانی‌ها، تنها نمونه‌هایی که در نخستین رکورد بایگانی برای یک متریک وجود دارند نمایش داده خواهند شد؛ همچنین گزینه -O را ببینید. گزینه -v با هر یک از گزینه‌های -I یا -i مانعة‌الجمع است.

-V, --verbose

این گزینه خلاصه‌ای فشرده از تعداد پیام‌های ارسال و دریافت‌شده در رابط PMAPI ارائه می‌دهد.

-z, --hostzone

منطقه زمانی گزارش‌دهی را به منطقه زمانی محلی میزبانی که منبع متریک‌های کارایی است تغییر می‌دهد، همان‌طور که از طریق گزینه‌های -h یا -a مشخص شده است.

-Z timezone, --timezone=timezone

به‌طور پیش‌فرض، pmprobe زمان روز را بر اساس منطقه زمانی محلی سیستمی که pmprobe روی آن اجرا می‌شود گزارش می‌کند. گزینه -Z منطقه زمانی را به timezone در قالب متغیر محیطی TZ همان‌طور که در environ(7) توصیف شده، تغییر می‌دهد.

-?, --help

نمایش پیام راهنمای استفاده و خروج..SH "مثال‌ها (EXAMPLES)"

$ pmprobe disk.dev
disk.dev.read 2
disk.dev.write 2
disk.dev.total 2
disk.dev.blkread 2
disk.dev.blkwrite 2
disk.dev.blktotal 2
disk.dev.active 2
disk.dev.response 2

$ pmprobe -I disk.dev.read disk.dev.write disk.all.total
disk.dev.read 2 "sda" "sdb"
disk.dev.write 2 "sda" "sdb"
disk.all.total 1 PM_IN_NULL

$ pmprobe -v pmcd.numagents pmcd.version pmcd.control.timeout
pmcd.numagents 1 9
pmcd.version 1 "5.0.0"
pmcd.control.timeout 1 5

$ pmprobe -v disk.dev.total disk.all.total
disk.dev.total -1012 Unknown metric name
disk.all.total 1 4992466

فایل‌ها (FILES)

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

محیط 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 برای دریافت فهرستی از گزینه‌های اشکال‌زدایی در دسترس و مفهوم آن‌ها استفاده کنید.

گزینه‌های اشکال‌زدایی ویژهٔ pmprobe به شرح زیر هستند:

گزینه	توضیحات
appl0	اطلاعات دسته‌ای هنگامی که -b استفاده شود

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

PCPIntro(1)، pmcd(1)، pminfo(1)، pmlogdump(1)، PMAPI(3)، pmErrStr(3)، pmGetOptions(3)، pmSpecLocalPMDA(3)، pcp.conf(5)، pcp.env(5) و PMNS(5).