نام (NAME)

pmdiff - مقایسه بایگانی‌ها و گزارش تفاوت‌های چشمگیر

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

pmdiff [-dzV?] [-B starttime] [-E endtime] [-p precision] [-q thres] [-S starttime] [--skip-excluded] [--skip-missing] [-T endtime] [-x metric] [-X file] [-Z timezone] archive1 [archive2]

توضیحات (DESCRIPTION)

دستور pmdiff مقادیر میانگین هر معیار را در یک یا دو مجموعه از بایگانی‌ها در یک بازه زمانی مشخص مقایسه می‌کند تا تغییراتی را که احتمالاً هنگام جستجوی افت کارایی حائز اهمیت هستند، بیابد.

مشخص‌کننده‌های بایگانی archive1 و archive2 می‌توانند فهرستی از نام‌ها باشند که با کاما از هم جدا شده‌اند؛ هر کدام از آن‌ها می‌تواند نام پایه یک بایگانی یا نام دایرکتوری شامل یک یا چند بایگانی باشد. هر بایگانی در مجموعه بایگانی‌های حاصل باید از قبل توسط pmlogger(1) ایجاد شده باشد. از ابزار pmlogsummary(1) برای به‌دست آوردن مقادیر میانگینِ مورد استفاده در مقایسه استفاده می‌شود.

این ابزار به دو شیوه قابل فراخوانی است: با یک مجموعه یا با دو مجموعه از بایگانی‌ها.

در حالت نخست، تنها خط فرمان منطقی نیازمند استفاده از هر چهار آرگومان بازه زمانی است. این بازه‌ها با قالبی مشابه با قالب بازه زمانی توصیف‌شده در PCPIntro(1) مشخص می‌شوند؛ که عبارتند از -S/--start و -T/--finish برای زمان شروع و پایان نخستین بازه زمانی مورد نظر در مجموعه بایگانی، و -B/--before و -E/--end برای زمان شروع و پایان دومین بازه زمانی مورد نظر.

در حالت دوم، همراه با دو مجموعه از بایگانی‌ها، گزینه‌های -B/--before و -E/--end ممکن است غیرضروری باشند. به عنوان مثال، در شرایطی که یک بازه زمانی یکسان از دو روز متوالی (معمولاً دو مجموعه بایگانی مجزا)، یا یک بازه زمانی در همان روز از هفته‌های مختلف مقایسه می‌شود، این گزینه‌ها کاربردی ندارند.

در هر دو حالت، pmdiff یک خلاصه مرتب‌شده از معیارهایی در بازه مشخص‌شده تولید می‌کند که مقادیر آن‌ها بیشترین انحراف را از یک آستانه کمینه داشته‌اند. میزان انحراف از طریق تقسیم مقدار میانگین هر معیار در هر دو گزارش و سپس محاسبه این که آیا نسبت به‌دست‌آمده خارج از بازه نرمال قرار می‌گیرد یا خیر محاسبه می‌شود. این نسبت را می‌توان با استفاده از گزینه -q/--threshold تنظیم کرد و مقدار پیش‌فرض آن ۲ است (یعنی گزارش تمام معیارهایی که مقادیر میانگین آن‌ها در دو بازه زمانی بیش از دو برابر شده یا به کمتر از نصف کاهش یافته است).

اگر مقدار مبنا صفر و مقدار مقایسه‌شده غیرصفر باشد، نسبت به صورت «|+|» (بی‌نهایت بزرگ) گزارش می‌شود. اگر مقدار مقایسه‌شده صفر و مقدار مبنا غیرصفر باشد، نسبت به صورت «|-|» (بی‌نهایت کوچک) گزارش می‌شود.

معیارهای گزارش‌شده بر اساس نسبت، به صورت صعودی مرتب می‌شوند.

اگر هر یک از معیارها در یک بازه موجود بوده ولی در بازه دیگر وجود نداشته باشند، یک پیام تشخیصی شامل فهرستی از هر معیار ناموجود و مجموعه بایگانی که آن معیار در آن وجود نداشته نمایش داده خواهد شد.

معیارهایی با معناشناسی شمارنده (counter) پیش از ارزیابی به نرخ (rate) تبدیل می‌شوند.

گزینه‌ها (OPTIONS)

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

-d, --keep: حالت اشکال‌زدایی، نگه‌داشتن فایل‌های میانی.
-B time, --begin=time: زمان شروع (time) برای دومین بازه زمانی.
-E time, --end=time: زمان پایان (time) برای دومین بازه زمانی.
-p precision, --precision=precision: چاپ تمام اعداد ممیز شناور با تعداد ارقام precision بعد از ممیز اعشار.
-q threshold, --threshold=threshold: تغییر آستانه (threshold) برای معیارهای مورد توجه؛ برای جزئیات بیشتر به بخش‌های بالا مراجعه کنید.
-S time, --start=time: زمان شروع (time) نخستین بازه زمانی.
-T time, --finish=time: زمان پایان (time) نخستین بازه زمانی.
-V, --version: نمایش شماره نسخه و خروج.
-x metric: مقایسه هر metric در هر مجموعه بایگانی در بازه‌های زمانی مشخص‌شده با یک الگوی ارائه‌شده برای egrep(1)، و مستثنی کردن موارد منطبق از خروجی گزارش.
-X file: امکان مشخص کردن یک file را فراهم می‌کند که حاوی الگوهای egrep(1) است؛ این الگوها بر روی نام معیارها اعمال می‌شوند تا در صورت تمایل برخی از آن‌ها از گزارش حذف شوند.
-z, --hostzone: استفاده از منطقه زمانی محلی برگرفته از مجموعه بایگانی ارائه‌شده.
-Z timezone, --timezone=timezone: تغییر منطقه زمانی در برچسب‌های بایگانی به timezone در قالب متغیر محیطی TZ همان‌طور که در environ(7) توضیح داده شده است.
-?, --help: نمایش پیام راهنما و خروج.
--skip-excluded: حذف فهرست نام‌های معیارهای مستثنی‌شده از خروجی.
--skip-missing: به‌طور پیش‌فرض، pmdiff نام هر معیاری را که در یک مجموعه بایگانی هست ولی در دیگری نیست گزارش می‌دهد. این گزینه جلوی این گزارش را می‌گیرد.

فایل‌ها (FILES)

$PCP_LOG_DIR/pmlogger/<hostname>: دایرکتوری پیش‌فرض برای بایگانی‌های PCP شامل مقادیر معیارهای کارایی جمع‌آوری‌شده از میزبان hostname.

محیط PCP (PCP ENVIRONMENT)

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

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

PCPIntro(1)، pmlogger(1)، pmlogsummary(1)، egrep(1)، pcp.conf(5) و pcp.env(5).