PCP-DSTAT(5) File Formats Manual PCP-DSTAT(5)

pcp-dstat - فایل پیکربندی pcp-dstat

دستور pcp-dstat ابزاری با قابلیت سفارشی‌سازی برای گزارش‌گیری از معیارهای کارایی است. این ابزار ساختار مبتنی بر «پلاگین» دارد، جایی که مجموعه‌ای از پلاگین‌های از پیش تعریف‌شده، مجموعه‌های کوچکی از گزارش‌های ستونی معیارها را ارائه می‌دهند، و گزینه‌های خط فرمان pcp-dstat مشخص می‌کنند که کدام‌یک از این پلاگین‌ها در گزارش تولیدی استفاده شوند.

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

فایل‌های پیکربندی هم از دایرکتوری سیستم و هم از دایرکتوری خانگی کاربر خوانده می‌شوند (/dstat و /home/ahoura/.pcp/dstat).

فایل‌های پیکربندی از ساختار سبک ini متشکل از بخش‌ها (پلاگین‌ها) و گزینه‌های درون هر بخش پیروی می‌کنند. یک بخش با نام پلاگین درون براکت آغاز شده و تا شروع بخش بعدی ادامه می‌یابد. نمونه‌ای از یک بخش با دو گزینه در ادامه آمده است:

[plugin]
option = value
metric.option = value2

توضیحات درون خط با علامت هش («#») یا نقطه ویرگول («;») آغاز می‌شود. توضیحات درون خطی (inline) پشتیبانی نمی‌شوند.

برخی گزینه‌ها بر کل پلاگین اعمال می‌شوند، و هر چیز دیگری به عنوان تعریف ستون در نظر گرفته می‌شود. تعاریف ستون‌ها مستقیماً با معیارهای منفرد PCP نگاشت می‌شوند.

label (string)

عنوان کلی مورد استفاده برای این پلاگین. در حالت خاص معیارهایی که نمونه‌های آن‌ها به صورت یک گروه گزارش می‌شوند (به grouptype در زیر مراجعه کنید)، این رشته می‌تواند حاوی الگوی %I باشد که با نام نمونه جایگزین خواهد شد - برای نمونه‌هایی از این نحو خاص، به پلاگین‌های cpu ،disk ،net و int(errupts) مراجعه کنید. به صورت پیش‌فرض تعریف نشده است، و به طور خودکار برابر نام بخش (پلاگین) قرار می‌گیرد.

width (integer)

عرض ستون مورد استفاده برای معیارها در این پلاگین. پیش‌فرض 5 است.

precision (integer)

حداکثر دقت (precision) مورد استفاده هنگام گزارش ستون‌ها با ممیز شناور در این پلاگین. به طور پیش‌فرض تعریف نشده و بر اساس width به صورت خودکار تعیین می‌شود.

printtype (character)

نوع سبک گزارش‌گیری برای مقادیر معیار در این پلاگین را مشخص می‌کند. تنظیمات ممکن عبارتند از: d(ecimal) برای مبنای ۱۰، f(loat) برای ممیز شناور، p(ercent) برای درصد، s(tring) برای رشته، b(its) برای بیت، t(ime) برای زمان. به طور پیش‌فرض، مقداری بر اساس نوع و مفهوم معنایی معیار استفاده می‌شود - برای جزئیات بیشتر درباره متادیتای معیارهای PCP به PMAPI(3) مراجعه کنید.

colorstep (integer)

نشان‌دهنده «گام» تغییری است که در آن رنگ بعدی هنگام گزارش مقادیر معیار اعمال می‌شود. همان‌طور که مقادیر معیار در هر نمونه تغییر می‌کنند، مقدار colorstep برای تعیین گام‌های افزایشی استفاده می‌شود که پس از آن رنگ جدیدی باید انتخاب شود. پیش‌فرض 1000 است.

grouptype (integer)

برای پلاگین‌هایی با معیارهایی که دامنه نمونه یکسانی دارند، می‌توان رفتار گروه‌بندی پیچیده‌تری درخواست کرد. رفتار پیش‌فرض این است که از گروه‌بندی نمونه‌ها استفاده نشود و هر نمونه از معیار در ستونی جداگانه گزارش شود (پلاگین load نمونه‌ای از این موضوع است که از معیار kernel.all.load استفاده می‌کند).

گروه‌بندی را می‌توان در سطوح مختلف ۱، ۲، ۳ یا ۴ تنظیم کرد. سطح ۱ تنها نمونه‌های معیارها را نمایش می‌دهد (بدون مجموع) - این معادل استفاده از پلاگین --cpu در خط فرمان pcp-dstat با نمایش میزان مصرف پردازنده‌های خاص است؛ برای نمونه نمایش پردازنده‌های شماره ۴، ۵ و ۱۲ (-C 4,5,12). سطح ۲ ستون مجموع را نمایش می‌دهد - مجموع تمام نمونه‌ها برای معیارهای مشخص‌شده در این پلاگین. سطح ۳ ترکیبی از هر دو حالت است، برای نمونه استفاده از پلاگین --cpu در pcp-dstat با گزینه‌های -C 4,5,12,total. سطح ۴ حالتی شبیه به top است، که در آن یک عبارت خاص "top" برای رتبه‌بندی همه نمونه‌ها استفاده می‌شود - بیشترین (بزرگ‌ترین) مقدار نمایش داده خواهد شد.

instances (comma-separated-value string)

نمونه‌هایی را مشخص می‌کند که باید برای معیار گزارش شوند. پیش‌فرض گزارش تمام نمونه‌ها برای معیارهای چندمقداری است.

cullinsts (regex pattern)

یک عبارت باقاعده اختیاری که می‌تواند برای حذف برخی نمونه‌های معیار از تجمیع ('total') در گزارش‌های تولیدشده استفاده شود. به عنوان مثال، مستثنی کردن دستگاه‌های loopback از گزارش‌های رابط شبکه امری رایج است که با این گزینه به دست می‌آید. پیش‌فرض گزارش روی همه نمونه‌ها است (بدون حذف).

filtertype (string)

برای معیارهای پلاگینی استفاده می‌شود که امکان فیلتر کردن نمونه‌ها را از طریق خط فرمان فراهم می‌کنند. مقدار مدخل filtertype باید با گزینه انتخاب نمونه مورد استفاده مطابق جدول زیر متناسب باشد.
filtertype instance select option
cpu -C
disk -D
dm -L
md -M
part -P
int -I
net -N
net-packets -N
swap -S

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

پیش از هر چیز، هر ستون معمولاً توسط یک معیار منفرد نشان داده می‌شود (اگر معیار چندمقداری باشد - یعنی دارای نمونه‌ها باشد - این امر منجر به چند ستون خواهد شد). این مورد با تنظیم یک کلید جدید (ستون) به عنوان مشخصه معیار تعیین می‌شود. نام ستون (کلید) واژه‌ای اختیاری با استفاده از حروف الفبا است. مشخصه معیار می‌تواند هر نام معیار PCP یا مشخصه معیار مشتق‌شده باشد، که امکان استفاده از محاسبات حسابی پایه را برای ایجاد این ستون منفرد فراهم می‌کند. نحو معیارهای مشتق‌شده در صفحه راهنمای pmRegisterDerived(3) شرح داده شده است.

برخی مثال‌ها از هر دو شکل مشخصه معیار در زیر در بخش «مثال‌ها» آمده است. هنگامی که یک ستون با یک معیار پیوند داده شد، سایر گزینه‌های مربوط به آن ستون را می‌توان با استفاده از نحوی جداشده با نقطه تنظیم کرد.

گزینه‌های معیار

metric.label

زیرعنوان مورد استفاده برای مقادیر گزارش‌شده این معیار. برچسب پیش‌فرض همان نام ستون از فایل پیکربندی است.

هنگام استفاده از معیارهای چندمقداری PCP (دارای نمونه‌ها)، اغلب مناسب است که شماره نمونه یا نام نمونه در سربرگ مشخص شود. این کار با استفاده از مشخص‌کننده‌های قالب انجام می‌شود - «%d» یا «%i» برای شماره نمونه‌ها (مانند جایگزینی با «6» برای ششمین پردازنده)، و «%s» یا «%I» برای نام نمونه‌ها (مانند جایگزینی با «eth0» برای رابط اترنت). نام‌های نمونه موجود برای هر معیار را می‌توان از طریق دستورات pminfo(1) یا pmprobe(1) کشف کرد.

metric.width

عرض ستون مورد استفاده هنگام گزارش مقادیر برای این معیار.

metric.unit (string)

تعیین تبدیل واحد/مقیاس برای معیار. باید از نظر ابعادی سازگار باشد و برای معیارهای غیررشته‌ای استفاده می‌شود. برای مقادیر مجاز، pmrep(1) را ببینید.

metric.type (string)

اگر روی raw تنظیم شود، تبدیل نرخ برای این معیار غیرفعال خواهد شد.

metric.precision (integer)

دقت را برای مقادیر ممیز شناور مشخص می‌کند.

metric.limit (string)

فیلتر حد مقدار را برای مقادیر عددی معیار تعریف می‌کند.

مثال زیر یک پلاگین فایل‌سیستم مجازی با دو ستون تعریف می‌کند، که با استفاده از سه معیار PCP تعریف شده است: vfs.files.count ،vfs.inodes.count و vfs.inodes.free. معیارهای inode با استفاده از نمادگذاری معیار مشتق‌شده ترکیب شده‌اند.

[vfs]
width = 6
label = filesystem
files = vfs.files.count
inode = vfs.inodes.count - vfs.inodes.free
inode.label = inodes

فایل‌های پیش‌فرض پلاگین pcp-dstat در سیستم حاوی مثال‌های بیشتری هستند.

/home/ahoura/.pcp/dstat/
فایل‌های پیکربندی اختصاصی به ازای هر کاربر
/dstat/
فایل‌های پیکربندی سراسری سیستم

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

برای متغیرهای محیطی که بر ابزارهای PCP تأثیر می‌گذارند، pmGetOptions(3) را ببینید.

PCPIntro(1), pcp-dstat(1), pminfo(1), pmprobe(1), pmrep(1), PMAPI(3), pmGetOptions(3), pmRegisterDerived(3) و pmrep.conf(5).

PCP Performance Co-Pilot