'\" t
.\"
.\" Copyright (c) 2016-2019 Red Hat.
.\" Copyright (c) 2000-2004 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.TH PMPROBE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmprobe\f1 \- کاوشگر سبک‌وزن برای معیارهای کارایی
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmprobe\f1
[\f3\-dfFiILvVz?\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-b\f1 \f2batchsize\f1]
[\f3\-\-container\f1=\f2name\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-\-derived\f1=\f2file\f1]
[\f3\-h\f1 \f2hostname\f1]
[\f3\-K\f1 \f2spec\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
[\f3\-O\f1 \f2time\f1]
[\f3\-Z\f1 \f2timezone\f1]
[\f2metricname\f1 ...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmprobe
در دسترس بودن معیارهای کارایی ارائه‌شده از طریق امکانات Performance Co-Pilot (PCP) را مشخص می‌کند.
.PP
معیارهای مورد نظر در آرگومان‌های
.I metricname
تعیین می‌شوند.
اگر
.I metricname
یک گره غیربرگ در فضای نام معیارهای کارایی (\c
.BR PMNS (5))
باشد، آن‌گاه
.B pmprobe
به‌صورت بازگشتی در PMNS به پایین پیمایش کرده و تمام گره‌های برگ را گزارش می‌دهد.
اگر هیچ آرگومان
.I metricname
داده نشود، از ریشهٔ فضای نام استفاده خواهد شد.
.PP
این بسط بازگشتی PMNS می‌تواند توسط گزینهٔ
.B \-F
(حرکت سریع‌تر) مهار شود؛ گزینه‌ای که در صورت معلوم بودن برگ بودن آرگومان‌های
.I metricname
از پیش، تعداد رفت‌وبرگشت‌ها به
.BR pmcd (1)
را کاهش می‌دهد.
.PP
قالب خروجی ساده و کم‌پیرایه بوده و برای استفاده در اسکریپت‌های پوششی (wrapper) جهت ایجاد فایل‌های پیکربندی برای سایر ابزارهای PCP در نظر گرفته شده است.
به‌طور پیش‌فرض، برای هر معیار یک خط خروجی وجود دارد که شامل نام معیار و در پی آن تعداد مقادیرِ در دسترس است.
شرایط خطا به‌صورت یک مقدار شمارش منفی کدگذاری می‌شوند (مطابق پروتکل‌های
.BR PMAPI (3)،
اما با استفاده از
.BR pmerr (1)
قابل رمزگشایی هستند) و به دنبال آن توضیحی متنی از خطا ارائه می‌شود.
.PP
مگر اینکه توسط گزینهٔ
.B \-h
به میزبان دیگری هدایت شود،
.B pmprobe
با دیمن جمع‌آوری معیارهای کارایی (PMCD) در میزبان محلی ارتباط برقرار می‌کند.
.PP
گزینهٔ
.B \-a
باعث می‌شود
.B pmprobe
به‌جای اتصال به PMCD، از مجموعه آرشیوهای مشخص‌شده استفاده کند.
.PP
گزینهٔ
.B \-L
باعث می‌شود
.B pmprobe
از یک بافتار محلی برای جمع‌آوری معیارها از PMDAها در میزبان محلی، بدون نیاز به PMCD، استفاده کند.
در این حالت تنها برخی از معیارها در دسترس هستند.
.PP
گزینه‌های
.BR \-a ،
.B \-h
و
.B \-L
مانعة‌الجمع هستند..SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR
مقادیر متریک کارایی از مجموعه‌ای از فایل‌های بایگانی Performance
Co-Pilot (PCP) که با آرگومان
.I archive
مشخص شده‌اند، بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌ها است که با کاما از هم جدا شده‌اند،
و هر کدام می‌تواند نام پایه یک بایگانی یا نام دایرکتوری شامل یک یا چند بایگانی باشد.
.TP
\fB\-b\fR, \fB\-\-batch\fR
این گزینه می‌تواند برای تعیین حداکثر تعداد متریک‌هایی استفاده شود که در یک درخواست برای گزینه \fB\-v\fR
و هر درخواست
.BR pmLookupName (3)
که
.B pmprobe
با فهرستی از نام‌های متریک برگ فراخوانی می‌کند، واکشی شوند.
مقدار پیش‌فرض برای
.I batchsize
برابر ۱۲۸ است.
این گزینه برای جلوگیری از محدودیت‌های اندازه درخواست PDU و همچنین توزیع واکشی‌ها در زمان مفید است، که در غیر این صورت اگر
.BR pmcd (1)
یا یک PMDA در پاسخگویی کند باشد، به‌ویژه در صورت بررسی تعداد زیادی متریک، ممکن است با انقضای زمان مواجه شود.
.TP
\fB\-\-container\fR=\fIcontainer\fR
یک
.I container
منفرد را برای پرس‌وجو مشخص می‌کند.
.TP
\fB\-d\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-\-derived\fR=\fIdmfile\fR
آرگومان
.I dmfile
فایلی شامل تعاریف متریک‌های مشتق‌شده را در قالبی که برای
.BR pmLoadDerivedConfig (3)
شرح داده شده است، مشخص می‌کند.
این گزینه روشی برای بارگذاری تعاریف متریک‌های مشتق‌شده فراهم می‌کند که جایگزینی برای استفاده عمومی‌تر از متغیر محیطی
.B PCP_DERIVED_CONFIG
همان‌طور که در
.BR PCPIntro (1)
توضیح داده شده است، می‌باشد.
استفاده از گزینه \fB\-\-derived\fR و متغیر محیطی
.B PCP_DERIVED_CONFIG
برای تعیین
.B همان
پیکربندی ایده بدی است، بنابراین یکی از این دو روش را انتخاب کنید.
.TP
\fB\-f\fR, \fB\-\-force\fR
هنگامی که به همراه
.B \-i
یا
.B \-I
استفاده شود، مجموعه نمونه‌های گزارش‌شده تمام آن‌هایی خواهد بود که در منبع داده‌های کارایی شناخته شده‌اند.
به‌طور پیش‌فرض، مجموعه نمونه‌های گزارش‌شده مواردی هستند که در حال حاضر مقادیری برای آن‌ها در دسترس است،
که ممکن است کوچک‌تر از مجموعه گزارش‌شده با
.BR \-f
باشد.
.TP
\fB\-F\fR, \fB\-\-faster\fR
فرض می‌کند که نام‌های متریک داده‌شده گره‌های برگ PMNS هستند.
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
اتصال به
.BR pmcd (1)
روی
.IR host ،
به جای localhost پیش‌فرض.
.TP
\fB\-i\fR, \fB\-\-internal\fR
شناسه‌های درونی را برای هر نمونه گزارش می‌کند.
مقادیر در مبنای دهدهی بوده و پیشوند ``?'' دارند.
به عنوان یک حالت خاص، رشته مستقیم
.B PM_IN_NULL
برای متریک‌های منفرد گزارش می‌شود.
.TP
\fB\-I\fR, \fB\-\-external\fR
شناسه‌های بیرونی را برای هر نمونه گزارش می‌کند.
رشته مستقیم
.B PM_IN_NULL
برای متریک‌های منفرد گزارش می‌شود.
.TP
\fB\-K\fR \fIspec\fR, \fB\-\-spec\-local\fR=\fIspec\fR
هنگام استفاده از گزینه \fB\-L/\fR برای واکشی متریک‌ها از یک بافت محلی،
این گزینه PMDAهای DSO را که باید قابل دسترس شوند، کنترل می‌کند.
آرگومان
.I spec
از نحو شرح داده شده در
.BR pmSpecLocalPMDA (3)
پیروی می‌کند.
می‌توان از بیش از یک گزینه \fB\-K\fR استفاده کرد.
.TP
\fB\-L\fR, \fB\-\-local\-PMDA\fR
از یک بافت محلی برای جمع‌آوری متریک‌ها از DSO PMDAها روی میزبان محلی بدون PMCD استفاده می‌کند.
همچنین ببینید:
.BR \-K .
.TP
\fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR
در حالت عادی
.B pmprobe
روی فضای نام توزیع‌شده متریک‌های کارایی (PMNS) عمل می‌کند،
با این حال، اگر گزینه
.B \-n
مشخص شود، یک فایل PMNS محلی جایگزین از فایل
.IR pmnsfile
بارگذاری می‌شود.
.TP
\fB\-O\fR \fItime\fR, \fB\-\-origin\fR=\fItime\fR
هنگامی که همراه با یک منبع بایگانی از متریک‌ها و گزینه‌های \fB\-f/\fR استفاده شود، آرگومان
.I time
مبدأ زمانی را مشخص می‌کند که متریک‌ها باید در آن زمان از مجموعه بایگانی‌ها واکشی شوند.
برای توضیحات کامل این گزینه و نحو آرگومان
.I time
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-v\fR, \fB\-\-values\fR
مقدار را برای هر نمونه، مطابق با قواعد قالب‌بندی
.BR pmPrintValue (3)
گزارش می‌کند.
هنگام واکشی از مجموعه‌ای از بایگانی‌ها، تنها نمونه‌هایی که در نخستین رکورد بایگانی برای یک متریک وجود دارند نمایش داده خواهند شد؛ همچنین گزینه
.B \-O
را ببینید.
گزینه
.B \-v
با هر یک از گزینه‌های
.B \-I
یا
.B \-i
مانعة‌الجمع است.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
این گزینه خلاصه‌ای فشرده از تعداد پیام‌های ارسال و دریافت‌شده در رابط PMAPI ارائه می‌دهد.
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
منطقه زمانی گزارش‌دهی را به منطقه زمانی محلی میزبانی که منبع متریک‌های کارایی است تغییر می‌دهد، همان‌طور که از طریق گزینه‌های
.B \-h
یا
.B \-a
مشخص شده است.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
به‌طور پیش‌فرض،
.B pmprobe
زمان روز را بر اساس منطقه زمانی محلی سیستمی که
.B pmprobe
روی آن اجرا می‌شود گزارش می‌کند.
گزینه
.B \-Z
منطقه زمانی را به
.I timezone
در قالب متغیر محیطی TZ همان‌طور که در
.BR environ (7)
توصیف شده، تغییر می‌دهد.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج..SH "مثال‌ها (EXAMPLES)"
.nf
.ft CR
$ pmprobe disk.dev
.ft CR
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
.sp
.ft CR
$ pmprobe \-I disk.dev.read disk.dev.write disk.all.total
.ft CR
disk.dev.read 2 "sda" "sdb"
disk.dev.write 2 "sda" "sdb"
disk.all.total 1 PM_IN_NULL
.sp
.ft CR
$ pmprobe \-v pmcd.numagents pmcd.version pmcd.control.timeout
.ft CR
pmcd.numagents 1 9
pmcd.version 1 "5.0.0"
pmcd.control.timeout 1 5
.sp
.ft CR
$ pmprobe \-v disk.dev.total disk.all.total
.ft CR
disk.dev.total \-1012 Unknown metric name
disk.all.total 1 4992466
.fi
.ft R
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_VAR_DIR/pmns/*
فایل‌های مشخصات پیش‌فرض PMNS
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتربندی
نام فایل‌ها و پوشه‌های مورد استفادهٔ PCP به کار می‌روند.
در هر نصب،
فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل
پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.PP
برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینهٔ
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی‌های اضافی را در
.I stderr
فعال می‌کند تا به بررسی و اولویت‌بندی مشکلات کمک کند، اگرچه اطلاعات گاهی مبهم هستند و
اساساً برای راهنمایی توسعه‌دهندگان در نظر گرفته شده‌اند تا کاربران نهایی.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی جداشده با کاما است؛ از
.BR pmdbg (1)
همراه با گزینهٔ
.B \-l
برای دریافت
فهرستی از گزینه‌های اشکال‌زدایی در دسترس و مفهوم آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی ویژهٔ
.B pmprobe
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	اطلاعات دسته‌ای هنگامی که \fB\-b\fP استفاده شود
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pminfo (1)،
.BR pmlogdump (1)،
.BR PMAPI (3)،
.BR pmErrStr (3)،
.BR pmGetOptions (3)،
.BR pmSpecLocalPMDA (3)،
.BR pcp.conf (5)،
.BR pcp.env (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ blkread blktotal blkwrite dmfile numagents sda sdb