'\" t
.\"
.\" Copyright (c) 2021 Red Hat.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMDASOCKETS 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdasockets\f1 \- عامل PMDA برای آمار و معیارهای سوکت‌ها
.ds ia sockets
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/\*(ia/pmda\*(ia\f1
[\f3\-D\f1 \f2debug\f1]
.SH "توضیحات (DESCRIPTION)"
برنامه
.B pmdasockets
یک عامل دامنه معیارهای کارایی (PMDA) است که مقادیر معیارها را برای سوکت‌های فعلی سیستم محلی برون‌ریزی می‌کند.
.PP
این PMDA در حال حاضر داده‌های خود را از طریق ابزار
.BR ss (8)
جمع‌آوری می‌کند و برای کارکرد صحیح نیازمند نصب بودن آن برنامه است.
این وابستگی ممکن است در آینده تغییر کند.
.SH "نصب (INSTALLATION)"
برای نصب (فعال‌سازی) PMDA مربوط به
.BR sockets ،
دستورات زیر را به عنوان ریشه (root) اجرا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/sockets
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف نصب (غیرفعال‌سازی)، دستورات زیر را به عنوان ریشه (root) اجرا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/sockets
# ./Remove
.fi
.ft P
.RE
.sp 1
برنامه
\fBpmdasockets\fR توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به صورت مستقیم اجرا گردد.
اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع می‌دهند.
.SH "پیکربندی فیلتر (FILTER CONFIGURATION)"
معیار رشته‌ای
.B network.persocket.filter
فیلتر
.BR ss (1)
مورد استفاده برای گزینش اختیاری وضعیت‌های سوکت، آدرس‌های IP و سایر گزینه‌هایی را مشخص می‌کند که
.B pmdasockets
جمع‌آوری خواهد کرد (تا دامنه نمونه خود را مقداردهی کند).
این فیلتر هنگام راه‌اندازی PMDA از فایل
.B $(PCP_SYSCONF_DIR)/sockets/filter.conf
(معمولاً
.BR /etc/pcp/sockets/filter.conf )
بارگذاری می‌شود و مقدار پیش‌فرض آن
.B state connected
است؛ به این معنی که تنها سوکت‌های در وضعیت
.B connected
(متصل) لحاظ خواهند شد.
این مورد را می‌توان با ویرایش دائمی فایل
.BR filter.conf
توسط کاربر ریشه تغییر داد.
همچنین می‌توان این فیلتر را پس از راه‌اندازی PMDA با استفاده از
.BR pmstore (1)
به صورت پویا با ذخیره یک رشته فیلتر جدید در معیار
.B network.persocket.filter
تغییر داد.
به عنوان مثال:
.in 1i
.sp 1
.RS +4
.ft B
.nf
# pmstore network.persocket.filter "state all"
.fi
.ft P
.RE
.sp 1
فیلتر را به شکلی تغییر می‌دهد که سوکت‌ها در تمامی وضعیت‌ها را در بر گیرد.
توجه داشته باشید که فیلتر ذخیره‌شده به صورت پویا، پس از راه‌اندازی مجدد PMDA یا راه‌اندازی مجدد سیستم پایدار نمی‌ماند
(برای اعمال تغییرات دائمی، فایل پیکربندی را ویرایش کنید).
برای جزئیات بیشتر درباره نحو فیلتر و گزینه‌ها، به
.BR ss (8)
مراجعه کنید.
.SH "پیکربندی گزارش‌گیری (LOGGING CONFIGURATION)"
فایل پیکربندی
.BR pmlogconf (1)
برای
.B pmdasockets
عبارت است از
.BR $PCP_VAR_DIR/config/pmlogconf/networking/persocket-linux
(که در آن
.B $PCP_VAR_DIR
معمولاً
.BR /var/lib/pcp
است) که مشخص می‌کند تمامی معیارهای زیر
.B network.persocket
در فضای‌نام PCP با بازه نمونه‌برداری پیش‌فرض ۶۰ ثانیه ثبت شوند.
بازه زمانی گزارش‌گیری و معیارهای مورد نظر برای ثبت را می‌توان با ویرایش آن فایل و سپس راه‌اندازی مجدد سرویس
.B pmlogger
تغییر داد.
برای جزئیات بیشتر درباره نحو، به
.BR pmlogconf (1)
مراجعه کنید.
.SH "معیارها (METRICS)"
معیارها و فراداده‌های پشتیبانی‌شده توسط
.B pmdasockets
مطابق با فیلدهای گزارش‌شده توسط
.B ss -noemitauOH
هستند و همچنین به عنوان متن راهنمای ارائه‌شده توسط PMDA در دسترس قرار دارند؛
برای مثال، جهت فهرست کردن تمامی معیارها، توصیف‌کننده‌های فراداده و متن راهنما:
.in 1i
.sp 1
.RS +4
.ft B
.nf
# pminfo -fmdtT network.persocket
.fi
.ft P
.RE
.sp 1
توجه داشته باشید که برای کارکرد صحیح این دستور، PMDA باید نصب (فعال) شده باشد؛ به بخش بالا مراجعه کنید.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fR برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط \fBPCP\fR به کار می‌روند. در هر نصب، فایل \fB/etc/pcp.conf\fR حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fR می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fIpcp.conf\fR(5) شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی اطلاعات تشخیصی اضافی را در
.I stderr
فعال می‌کند تا به تفکیک و ارزیابی مشکلات کمک کند، هرچند این اطلاعات گاهی مبهم است و در وهله اول بیشتر برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
به همراه گزینه
.B \-l
استفاده کنید تا فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها را به دست آورید.
.PP
گزینه‌های اشکال‌زدایی مختص
.B pmdasockets
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
.ad l
بارگذاری فیلتر وضعیت سوکت از
.B $PCP_SYSCONF_DIR/filter.conf
و
منبع داده
T}
_
appl1	T{
.ad l
تجزیه خروجی از منبع داده
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmlogger (1)
و
.BR ss (8).

.\" control lines for scripts/man-spell
.\" +ok+ noemitauOH {from options to ss(1)} persocket linux ss