PCP-HTOP(5) قالب‌های فایل PCP-HTOP(5)

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

pcp-htop یک ابزار سفارشی‌سازی‌پذیر برای گزارش‌گیری معیارهای عملکرد است. این ابزار دارای معماری پویایی است که در آن مجموعه‌ای از فایل‌های پیکربندی، سنجه‌ها و ستون‌های اختیاری و بیشتری را برای گسترش گزینه‌های نمایشیِ ثابت ارائه‌شده توسط htop معمولی فراهم می‌کنند.

این فایل‌های پیکربندی می‌توانند هم از مکان‌های سراسری سیستم (نخست /etc/pcp/htop و سپس /usr/share/pcp/htop) و هم از زیرشاخه خانگی کاربر (معمولاً ~/.config/htop) بارگذاری شوند. درون این مسیرها، دایرکتوری‌های meters و columns برای مشخصات پویای سنجه‌ها و ستون‌ها پویش می‌شوند.

سنجه‌ها در بخش بالایی پنجره‌ی pcp-htop و ستون‌ها در بخش پایینی نمایش داده می‌شوند. سنجه‌ها تمایل به نمایش معیارهای سراسری سیستم دارند، و ستون‌ها معیارهای مربوط به هر فرایند را به‌طور جداگانه نمایش می‌دهند.

قالب‌ها مشابه هستند اما نیازمندی‌های کمی متفاوتی دارند. هر دو قالب از سبک رایج ini پیروی می‌کنند. خطوط خالی نادیده گرفته می‌شوند. خطوطی که با نویسه "#" آغاز می‌شوند به عنوان توضیح (کامنت) در نظر گرفته می‌شوند.

در ادامه یک نمونه پیکربندی برای یک سنجه‌ی جدید Redis آورده شده است:

[redisclient]
caption = Redis clients
type = bar
blocked.metric = redis.blocked_clients
blocked.color = blue
blocked.label = blk
clients.metric = redis.connected_clients
clients.color = green
clients.label = conn

یک فایل پیکربندی می‌تواند شامل چندین تعریف سنجه باشد. هر تعریف با یک نام شناسایی درون قلاب آغاز می‌شود - redisclient در این مثال. این نام به‌صورت داخلی درون pcp-htop استفاده می‌شود و باید یکتا باشد، با یک نویسه‌ی الفبایی آغاز شود و در ادامه تنها می‌تواند شامل نویسه‌های حرفی-عددی یا نویسه‌ی زیرخط (underscore) باشد. استفاده از فاصله خالی یا سایر نویسه‌ها مجاز نیست.

چندین پارامتر وجود دارند که نحوه نمایش سنجه را برای کاربر تعیین می‌کنند.

این مقدار پس از انتخاب سنجه، در صفحه برپایی (Setup) نمایش داده می‌شود. همچنین نسخه کوتاه‌شده‌ای از caption (به همراه یک دونقطه بعد از آن) هنگام به‌روزرسانی سنجه در نمایشگر اصلی نشان داده خواهد شد.
می‌توان از این گزینه برای ارائه جزئیات بیشتر در حین فرایند انتخاب سنجه در صفحه Setup استفاده کرد و در صورت وجود، در ستون "Available Meters" نمایش داده می‌شود. اگر مشخص نشده باشد، caption برای این منظور به کار می‌رود. اگر هیچ‌کدام وجود نداشته باشند، همان name داخلی (اجباری) استفاده خواهد شد.
این تنظیم امکان مشخص کردن نوع پیش‌فرض ترجیحی سنجه را فراهم می‌کند. مقدار مربوطه باید یکی از bar، text، graph یا led باشد. اگر مقداری برای یک سنجه پویا تعیین نشود، مقدار پیش‌فرض text استفاده خواهد شد.
همچنین می‌توان یک مقدار عددی برای تعیین اندازه سنجه تنظیم کرد، به طوری که مقادیر (مثلاً برای نمایش سنجه از نوع bar) بین بازه صفر تا maximum مقیاس‌بندی شوند.

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

این تنها فیلد اجباری است و یک معیار PCP را به سنجه پیوند می‌دهد. مقادیر نمونه‌برداری‌شده برای هر معیار در زمان اجرا، پویانمایی قابل مشاهده در نمایشگر pcp-htop را فراهم می‌کنند. مشخصه معیار می‌تواند یک نام معیار PCP باشد همان‌گونه که توسط pminfo(1) فهرست می‌شود، یا یک عبارت معیار «مشتق‌شده» (derived). قالب عبارات معیارهای مشتق‌شده در صفحه راهنمای pmRegisterDerived(3) توضیح داده شده است.
تنظیم رنگی که هنگام رندر کردن مقادیر معیار استفاده می‌شود. مقادیر ممکن عبارتند از: red، green، blue، cyan، magenta، yellow، gray، darkgray یا white.
یک برچسب اختیاری و کوتاه برای نمایش پیش از مقدار معیار. نویسه ":" قبل از بخش مقدار معیار در نمایشگر، به label اضافه خواهد شد.
یک پسوند اختیاری و کوتاه برای نمایش پس از مقدار معیار. معمولاً برای نشان دادن مقادیر به صورت درصد با استفاده از مقدار "%" برای suffix و همچنین برای ارائه واحد اندازه‌گیری پایه استفاده می‌شود. توجه داشته باشید که از آنجا که PCP واحدها را برای معیارها نگهداری می‌کند، برای معیارهایی که دارای بعد «فضا» هستند (بایت، کیلوبایت، مگابایت و غیره)، یک پسوند به‌طور خودکار اضافه خواهد شد.

در ادامه یک نمونه پیکربندی برای ستونی جدید آورده شده است که توصیف‌کننده‌های پرونده باز (open file descriptors) را برای هر فرایند نشان می‌دهد:

[openfds]
heading = FDS
caption = FDCOUNT
description = Open file descriptors
metric = proc.fd.count
width = 3

یک فایل پیکربندی می‌تواند شامل چندین تعریف ستون باشد. هر تعریف با یک نام شناسایی درون قلاب آغاز می‌شود - openfds در این مثال، و همان قوانینی که در بالا برای نام سنجه‌ها ذکر شد در اینجا نیز اعمال می‌شود.

هر ستون باید یک معیار را مشخص کند. پارامترهای اختیاری نیز می‌توانند تنظیم شوند.

همانند سنجه‌ها، مقدار معیار باید یا یک نام معیار PCP باشد (به‌گونه‌ای که توسط pminfo(1) فهرست می‌شود) یا یک معیار مشتق‌شده. معیار باید یک دامنه نمونه (مجموعه‌ای از مقادیر) داشته باشد و آن دامنه نمونه باید به مجموعه‌ای از فرایندها با شناسه‌های فرایند (PID) به عنوان شناسه نمونه نگاشت شود. به‌طور معمول این معیارها از فضای‌نام‌های proc یا hotproc هستند (pmdaproc(1))، اما معیارهای سایر دامنه‌ها (pmdabpf(1) و غیره) که دارای مقادیر به ازای هر فرایند هستند نیز به همان اندازه قابل استفاده‌اند.
عرض ستون برای استفاده هنگام نمایش مقادیر معیار. یک مقدار منفی می‌تواند برای مشخص کردن تراز از سمت چپ استفاده شود. حداکثر محدودیت ۲۸ نویسه برای عرض ستون اعمال می‌شود. عرض پیش‌فرض ستون ۵ نویسه است.
عنوان کوتاهی که در بالای ستون نمایش داده می‌شود - معمولاً یک رشته کوتاه، رمزی و تماماً با حروف بزرگ.
یک کلمه شناسایی کوتاه که در صفحه Setup در هر دو فهرست Available Columns و Active Columns به کاربران نشان داده می‌شود.
متنی که به کاربران کمک می‌کند تا معنای این ستون را هنگامی که در صفحه Setup در فهرست Available Columns ارائه می‌شود، درک کنند.

pcp-htop(1)، pminfo(1)، pmcd(1)، pmdaproc(1)، pmdabpf(1) و pmRegisterDerived(3).

htop در ابتدا توسط Hisham Muhammad توسعه یافت. امروزه این ابزار توسط جامعه در <htop@groups.io> نگهداری می‌شود.

pcp-htop به عنوان یک همکاری میان جوامع <htop@groups.io> و <pcp@groups.io> نگهداری می‌شود و بخشی از مجموعه ابزارهای Performance Co-Pilot را تشکیل می‌دهد.

2026 Performance Co-Pilot