| PMDASOCKETS(1) | General Commands Manual | PMDASOCKETS(1) |
نام (NAME)
pmdasockets - عامل PMDA برای آمار و معیارهای سوکت‌ها
خلاصه دستور (SYNOPSIS)
$PCP_PMDAS_DIR/sockets/pmdasockets [-D debug]
توضیحات (DESCRIPTION)
برنامه pmdasockets یک عامل دامنه معیارهای کارایی (PMDA) است که مقادیر معیارها را برای سوکت‌های فعلی سیستم محلی برون‌ریزی می‌کند.
این PMDA در حال حاضر داده‌های خود را از طریق ابزار ss(8) جمع‌آوری می‌کند و برای کارکرد صحیح نیازمند نصب بودن آن برنامه است. این وابستگی ممکن است در آینده تغییر کند.
نصب (INSTALLATION)
برای نصب (فعال‌سازی) PMDA مربوط به sockets، دستورات زیر را به عنوان ریشه (root) اجرا کنید:
# cd $PCP_PMDAS_DIR/sockets # ./Install
برای حذف نصب (غیرفعال‌سازی)، دستورات زیر را به عنوان ریشه (root) اجرا کنید:
# cd $PCP_PMDAS_DIR/sockets # ./Remove
برنامه pmdasockets توسط pmcd(1) راه‌اندازی می‌شود و هرگز نباید به صورت مستقیم اجرا گردد. اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، به pmcd(1) اطلاع می‌دهند.
پیکربندی فیلتر (FILTER CONFIGURATION)
معیار
رشته‌ای
network.persocket.filter فیلتر
ss(1) مورد
استفاده
برای گزینش
اختیاری
وضعیت‌های
سوکت،
آدرس‌های IP و
سایر
گزینه‌هایی
را مشخص
می‌کند که
pmdasockets
جمع‌آوری
خواهد کرد
(تا دامنه
نمونه خود
را
مقداردهی
کند). این
فیلتر
هنگام
راه‌اندازی
PMDA از فایل
$(PCP_SYSCONF_DIR)/sockets/filter.conf
(معمولاً
/etc/pcp/sockets/filter.conf)
بارگذاری
می‌شود و
مقدار
پیش‌فرض آن
state connected است؛ به
این معنی که
تنها
سوکت‌های
در وضعیت connected
(متصل) لحاظ
خواهند شد.
این مورد را
می‌توان با
ویرایش
دائمی فایل
filter.conf توسط
کاربر ریشه
تغییر داد.
همچنین
می‌توان
این فیلتر
را پس از
راه‌اندازی
PMDA با
استفاده از
pmstore(1) به صورت
پویا با
ذخیره یک
رشته فیلتر
جدید در
معیار network.persocket.filter
تغییر داد.
به عنوان
مثال:
# pmstore network.persocket.filter "state all"
فیلتر را به شکلی تغییر می‌دهد که سوکت‌ها در تمامی وضعیت‌ها را در بر گیرد. توجه داشته باشید که فیلتر ذخیره‌شده به صورت پویا، پس از راه‌اندازی مجدد PMDA یا راه‌اندازی مجدد سیستم پایدار نمی‌ماند (برای اعمال تغییرات دائمی، فایل پیکربندی را ویرایش کنید). برای جزئیات بیشتر درباره نحو فیلتر و گزینه‌ها، به ss(8) مراجعه کنید.
پیکربندی گزارش‌گیری (LOGGING CONFIGURATION)
فایل پیکربندی pmlogconf(1) برای pmdasockets عبارت است از $PCP_VAR_DIR/config/pmlogconf/networking/persocket-linux (که در آن $PCP_VAR_DIR معمولاً /var/lib/pcp است) که مشخص می‌کند تمامی معیارهای زیر network.persocket در فضای‌نام PCP با بازه نمونه‌برداری پیش‌فرض ۶۰ ثانیه ثبت شوند. بازه زمانی گزارش‌گیری و معیارهای مورد نظر برای ثبت را می‌توان با ویرایش آن فایل و سپس راه‌اندازی مجدد سرویس pmlogger تغییر داد. برای جزئیات بیشتر درباره نحو، به pmlogconf(1) مراجعه کنید.
معیارها (METRICS)
معیارها و
فراداده‌های
پشتیبانی‌شده
توسط pmdasockets
مطابق با
فیلدهای
گزارش‌شده
توسط ss -noemitauOH
هستند و
همچنین به
عنوان متن
راهنمای
ارائه‌شده
توسط PMDA در
دسترس قرار
دارند؛
برای مثال،
جهت فهرست
کردن تمامی
معیارها،
توصیف‌کننده‌های
فراداده و
متن راهنما:
# pminfo -fmdtT network.persocket
توجه داشته باشید که برای کارکرد صحیح این دستور، PMDA باید نصب (فعال) شده باشد؛ به بخش بالا مراجعه کنید.
محیط PCP (PCP ENVIRONMENT)
متغیرهای محیطی با پیشوند PCP_ برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.
گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)
گزینه -D یا --debug خروجی اطلاعات تشخیصی اضافی را در stderr فعال می‌کند تا به تفکیک و ارزیابی مشکلات کمک کند، هرچند این اطلاعات گاهی مبهم است و در وهله اول بیشتر برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی. debug فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از pmdbg(1) به همراه گزینه -l استفاده کنید تا فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها را به دست آورید.
گزینه‌های اشکال‌زدایی مختص pmdasockets به شرح زیر است:
| گزینه | توضیحات |
| appl0 | بارگذاری فیلتر وضعیت سوکت از $PCP_SYSCONF_DIR/filter.conf و منبع داده |
| appl1 | تجزیه خروجی از منبع داده |
همچنین ببینید (SEE ALSO)
| PCP | Performance Co-Pilot |