نام (NAME)

mpstat - گزارش آمارهای مرتبط با پردازنده‌ها.

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

mpstat [ -A ] [ --dec={ 0 | 1 | 2 } ] [ -H ] [ -n ] [ -U ] [ -u ] [ -T ] [ -V ] [ -I { keyword[,...] | ALL } ] [ -N { node_list | ALL } ] [ -o JSON ] [ -P { cpu_list | ALL } ] [ interval [ count ] ]

توضیحات (DESCRIPTION)

دستور mpstat فعالیت‌های هر پردازندهٔ دردسترس را در خروجی استاندارد می‌نویسد که پردازندهٔ 0 نخستین آن‌ها است. میانگین فعالیت‌های سراسری میان تمامی پردازنده‌ها نیز گزارش می‌شود. دستور mpstat هم بر روی ماشین‌های SMP و هم UP قابل استفاده است، اما در ماشین‌های UP، تنها میانگین فعالیت‌های سراسری چاپ خواهد شد. اگر هیچ فعالیتی انتخاب نشده باشد، گزارش پیش‌فرض همان گزارش میزان مصرف CPU است.

پارامتر interval میزان زمان بر حسب ثانیه را میان هر گزارش مشخص می‌کند. مقدار 0 (یا نبود هیچ پارامتری) مشخص می‌کند که آمارهای پردازنده‌ها برای زمان سپری‌شده از راه‌اندازی سیستم (بوت) گزارش شوند. پارامتر count می‌تواند در ترکیب با پارامتر interval مشخص شود، در صورتی که مقدار interval صفر تنظیم نشده باشد. مقدار count تعداد گزارش‌های تولیدشده به فاصلهٔ interval ثانیه را تعیین می‌کند. اگر پارامتر interval بدون پارامتر count مشخص شود، دستور mpstat گزارش‌ها را به‌صورت پیوسته تولید می‌کند.

گزینه‌ها (OPTIONS)

-A

این گزینه معادل با مشخص کردن -n -u -I ALL است. این گزینه همچنین شامل تعیین -N ALL -P ALL نیز می‌شود، مگر اینکه این گزینه‌ها به‌طور صریح در خط فرمان مشخص شده باشند.

--dec={ 0 | 1 | 2 }

تعداد ارقام اعشار مورد استفاده را مشخص می‌کند (0 تا 2، مقدار پیش‌فرض 2 است).

-H

همچنین vCPUهایی را که به‌صورت فیزیکی اتصال‌گرم (hotplugged) شده‌اند شناسایی کرده و آمار آن‌ها را نمایش می‌دهد.

-I { keyword[,...] | ALL }

گزارش آمار وقفه‌ها (interrupts). کلیدواژه‌های ممکن عبارتند از: CPU، SCPU و SUM.

کلیدواژهٔ ALL معادل مشخص کردن تمامی کلیدواژه‌های بالاست و بنابراین تمامی آمارهای وقفه‌ها نمایش داده می‌شوند.

-N { node_list | ALL }

گره‌های NUMA را که آمارها باید برای آن‌ها گزارش شوند مشخص می‌کند. node_list فهرستی از مقادیر یا بازه‌ای از مقادیر جدا شده با کاما است (مانند 0,2,4-7,12-). توجه داشته باشید که گره all میانگین سراسری در میان تمامی گره‌هاست. کلیدواژهٔ ALL مشخص می‌کند که آمارها باید برای تمامی گره‌ها گزارش شوند.

-n

گزارش خلاصهٔ آمارهای CPU بر اساس جایگیری در گره‌های NUMA. مقادیر زیر نمایش داده می‌شوند:

تمامی فیلدهای دیگر مشابه مواردی هستند که با گزینهٔ -u نمایش داده می‌شوند (به پایین مراجعه کنید).

-o JSON

نمایش آمارها در قالب JSON (JavaScript Object Notation). ترتیب فیلدهای خروجی JSON تعریف‌نشده است و ممکن است فیلدهای جدیدی در آینده افزوده شوند.

-P { cpu_list | ALL }

پردازنده‌هایی را که باید آمارها برای آن‌ها گزارش شوند مشخص می‌کند. cpu_list فهرستی از مقادیر یا بازه‌ای از مقادیر جدا شده با کاما است (مانند 0,2,4-7,12-). توجه داشته باشید که پردازندهٔ 0 اولین پردازنده است و پردازندهٔ all میانگین سراسری میان تمامی پردازنده‌هاست. کلیدواژهٔ ALL مشخص می‌کند که آمارها باید برای تمامی پردازنده‌ها گزارش شوند. پردازنده‌های آفلاین نمایش داده نمی‌شوند.

-T

نمایش عناصر توپولوژی در گزارش CPU (گزینهٔ -u در زیر را ببینید). عناصر زیر نمایش داده می‌شوند:

-U

نمایش برچسب زمانی (UTC - ساعت هماهنگ جهانی) بر حسب ثانیه از زمان مبدأ (epoch).

-u

گزارش میزان مصرف CPU. مقادیر زیر نمایش داده می‌شوند:

-V

چاپ شمارهٔ نگارش و خروج.

محیط (ENVIRONMENT)

دستور mpstat متغیرهای محیطی زیر را مد نظر قرار می‌دهد:

S_COLORS

به‌طور پیش‌فرض، هنگامی که خروجی به یک ترمینال متصل باشد، آمارها به‌صورت رنگی نمایش داده می‌شوند. از این متغیر برای تغییر تنظیمات استفاده کنید. مقادیر ممکن برای این متغیر عبارتند از never، always یا auto (مورد آخر معادل تنظیمات پیش‌فرض است).
لطفاً توجه داشته باشید که رنگ استفاده‌شده برای نمایش یک مقدار (قرمز، زرد یا هر رنگ دیگر)، صرفاً به دلیل رنگ آن نشان‌دهندهٔ هیچ‌گونه مشکلی نیست؛ بلکه تنها بازه‌های مختلف مقادیر را مشخص می‌کند.

S_COLORS_SGR

رنگ‌ها و سایر مشخصه‌های مورد استفاده برای نمایش آمارها در ترمینال را مشخص می‌کند. مقدار آن فهرستی از قابلیت‌هاست که با دونقطه (:) از یکدیگر جدا شده‌اند و به‌طور پیش‌فرض برابر است با I=32;22:N=34;1:W=35;1:X=31;1:Z=34;22. قابلیت‌های پشتیبانی‌شده عبارتند از:

S_TIME_FORMAT

اگر این متغیر وجود داشته باشد و مقدار آن ISO باشد، محلی‌سازی (locale) جاری هنگام چاپ تاریخ در سربرگ گزارش نادیده گرفته خواهد شد. دستور mpstat در عوض از قالب ISO 8601 (به‌صورت YYYY-MM-DD) استفاده خواهد کرد. برچسب زمانی نیز با قالب ISO 8601 سازگار خواهد بود.

مثال‌ها (EXAMPLES)

mpstat 2 5

نمایش پنج گزارش از آمارهای سراسری میان تمام پردازنده‌ها در فواصل دو ثانیه‌ای.

mpstat -P ALL 2 5

نمایش پنج گزارش از آمارهای تمامی پردازنده‌ها در فواصل دو ثانیه‌ای.

گزارش باگ‌ها (BUGS)

سیستم‌فایل /proc باید سوار (mount) شده باشد تا دستور mpstat کار کند.

فایل‌ها (FILES)

مسیر /proc شامل فایل‌های گوناگونی با آمارهای سیستم است.

نویسندگان (AUTHORS)

Sebastien Godard (sysstat <at> orange.fr)

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

sar(1), pidstat(1), iostat(1), vmstat(8)

https://github.com/sysstat/sysstat
https://sysstat.github.io