'\"macro stdmacro
.\"
.\" Copyright (c) 2013-2016 Red Hat.
.\"
.\" 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 PMDIFF 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdiff\f1 \- مقایسه بایگانی‌ها و گزارش تفاوت‌های چشمگیر
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmdiff\f1
[\f3\-dzV?\f1]
[\f3\-B\f1 \f2starttime\f1]
[\f3\-E\f1 \f2endtime\f1]
[\f3\-p\f1 \f2precision\f1]
[\f3\-q\f1 \f2thres\f1]
[\f3\-S\f1 \f2starttime\f1]
[\f3-\-skip\-excluded\f1]
[\f3-\-skip\-missing\f1]
[\f3\-T\f1 \f2endtime\f1]
[\f3\-x\f1 \f2metric\f1]
[\f3\-X\f1 \f2file\f1]
[\f3\-Z\f1 \f2timezone\f1]
\f2archive1\f1
[\f2archive2\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdiff
مقادیر میانگین هر معیار را در یک یا دو مجموعه از بایگانی‌ها در یک بازه زمانی مشخص مقایسه می‌کند تا تغییراتی را که احتمالاً هنگام جستجوی افت کارایی حائز اهمیت هستند، بیابد.
.PP
مشخص‌کننده‌های بایگانی
.I archive1
و
.I archive2
می‌توانند فهرستی از نام‌ها باشند که با کاما از هم جدا شده‌اند؛ هر کدام از آن‌ها می‌تواند نام پایه یک بایگانی یا نام دایرکتوری شامل یک یا چند بایگانی باشد. هر بایگانی در مجموعه بایگانی‌های حاصل باید از قبل توسط
.BR pmlogger (1)
ایجاد شده باشد. از ابزار
.BR pmlogsummary (1)
برای به‌دست آوردن مقادیر میانگینِ مورد استفاده در مقایسه استفاده می‌شود.
.PP
این ابزار به دو شیوه قابل فراخوانی است: با یک مجموعه یا با دو مجموعه از بایگانی‌ها.
.PP
در حالت نخست، تنها خط فرمان منطقی نیازمند استفاده از هر چهار آرگومان بازه زمانی است. این بازه‌ها با قالبی مشابه با قالب بازه زمانی توصیف‌شده در
.BR PCPIntro (1)
مشخص می‌شوند؛ که عبارتند از
.BR \-S / \-\-start
و
.BR \-T / \-\-finish
برای زمان شروع و پایان نخستین بازه زمانی مورد نظر در مجموعه بایگانی، و
.BR \-B / \-\-before
و
.BR \-E / \-\-end
برای زمان شروع و پایان دومین بازه زمانی مورد نظر.
.PP
در حالت دوم، همراه با دو مجموعه از بایگانی‌ها، گزینه‌های
.BR \-B / \-\-before
و
.BR \-E / \-\-end
ممکن است غیرضروری باشند. به عنوان مثال، در شرایطی که یک بازه زمانی یکسان از دو روز متوالی (معمولاً دو مجموعه بایگانی مجزا)، یا یک بازه زمانی در همان روز از هفته‌های مختلف مقایسه می‌شود، این گزینه‌ها کاربردی ندارند.
.PP
در هر دو حالت،
.B pmdiff
یک خلاصه مرتب‌شده از معیارهایی در بازه مشخص‌شده تولید می‌کند که مقادیر آن‌ها بیشترین انحراف را از یک آستانه کمینه داشته‌اند. میزان انحراف از طریق تقسیم مقدار میانگین هر معیار در هر دو گزارش و سپس محاسبه این که آیا نسبت به‌دست‌آمده خارج از بازه نرمال قرار می‌گیرد یا خیر محاسبه می‌شود.
این نسبت را می‌توان با استفاده از گزینه
.BR \-q / \-\-threshold
تنظیم کرد و مقدار پیش‌فرض آن ۲ است (یعنی گزارش تمام معیارهایی که مقادیر میانگین آن‌ها در دو بازه زمانی بیش از دو برابر شده یا به کمتر از نصف کاهش یافته است).
.PP
اگر مقدار مبنا صفر و مقدار مقایسه‌شده غیرصفر باشد، نسبت به صورت «|+|» (بی‌نهایت بزرگ) گزارش می‌شود.
اگر مقدار مقایسه‌شده صفر و مقدار مبنا غیرصفر باشد، نسبت به صورت «|-|» (بی‌نهایت کوچک) گزارش می‌شود.
.PP
معیارهای گزارش‌شده بر اساس نسبت، به صورت صعودی مرتب می‌شوند.
.PP
اگر هر یک از معیارها در یک بازه موجود بوده ولی در بازه دیگر وجود نداشته باشند، یک پیام تشخیصی شامل فهرستی از هر معیار ناموجود و مجموعه بایگانی که آن معیار در آن وجود نداشته نمایش داده خواهد شد.
.PP
معیارهایی با معناشناسی شمارنده (counter) پیش از ارزیابی به نرخ (rate) تبدیل می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود در خط فرمان عبارتند از:
.TP 5
\fB\-d\fR, \fB\-\-keep\fR
حالت اشکال‌زدایی، نگه‌داشتن فایل‌های میانی.
.TP
\fB\-B\fR \fItime\fR, \fB\-\-begin\fR=\fItime\fR
زمان شروع (\fItime\fP) برای دومین بازه زمانی.
.TP
\fB\-E\fR \fItime\fR, \fB\-\-end\fR=\fItime\fR
زمان پایان (\fItime\fP) برای دومین بازه زمانی.
.TP
\fB\-p\fR \fIprecision\fR, \fB\-\-precision\fR=\fIprecision\fR
چاپ تمام اعداد ممیز شناور با تعداد ارقام
.I precision
بعد از ممیز اعشار.
.TP
\fB\-q\fR \fIthreshold\fR, \fB\-\-threshold\fR=\fIthreshold\fR
تغییر آستانه (\fIthreshold\fP) برای معیارهای مورد توجه؛ برای جزئیات بیشتر به بخش‌های بالا مراجعه کنید.
.TP
\fB\-S\fR \fItime\fR, \fB\-\-start\fR=\fItime\fR
زمان شروع (\fItime\fP) نخستین بازه زمانی.
.TP
\fB\-T\fR \fItime\fR, \fB\-\-finish\fR=\fItime\fR
زمان پایان (\fItime\fP) نخستین بازه زمانی.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-x\fR \fImetric\fR
مقایسه هر \fImetric\fP در هر مجموعه بایگانی در بازه‌های زمانی مشخص‌شده با یک الگوی ارائه‌شده برای
.BR egrep (1)،
و مستثنی کردن موارد منطبق از خروجی گزارش.
.TP
\fB\-X\fR \fIfile\fR
امکان مشخص کردن یک
.IR file
را فراهم می‌کند که حاوی الگوهای
.BR egrep (1)
است؛ این الگوها بر روی نام معیارها اعمال می‌شوند تا در صورت تمایل برخی از آن‌ها از گزارش حذف شوند.
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
استفاده از منطقه زمانی محلی برگرفته از مجموعه بایگانی ارائه‌شده.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
تغییر منطقه زمانی در برچسب‌های بایگانی به
.I timezone
در قالب متغیر محیطی
.B TZ
همان‌طور که در
.BR environ (7)
توضیح داده شده است.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.TP
.B \-\-skip\-excluded
حذف فهرست نام‌های معیارهای مستثنی‌شده از خروجی.
.TP
.B \-\-skip\-missing
به‌طور پیش‌فرض،
.B pmdiff
نام هر معیاری را که در یک مجموعه بایگانی هست ولی در دیگری نیست گزارش می‌دهد. این گزینه جلوی این گزارش را می‌گیرد.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_LOG_DIR/pmlogger/<hostname>
دایرکتوری پیش‌فرض برای بایگانی‌های PCP شامل مقادیر معیارهای کارایی جمع‌آوری‌شده از میزبان
.IR hostname .
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های استفاده‌شده توسط PCP به کار می‌روند. در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است. از متغیر \fB$PCP_CONF\fP می‌توان برای تعیین یک فایل پیکربندی جایگزین استفاده کرد، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmlogger (1)،
.BR pmlogsummary (1)،
.BR egrep (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).