PCP-SS(1) General Commands Manual PCP-SS(1)

pcp-ss - گزارش آمار سوکت‌ها

pcp [گزینه‌های pcp] ss [گزینه‌های ss]

دستور pcp-ss آمار سوکت‌های جمع‌آوری‌شده توسط کارگزار PMDA pmdasockets(1) را گزارش می‌دهد. این دستور طوری طراحی شده است که تا حد مناسبی با بسیاری از گزینه‌های خط فرمان و قالب‌های گزارش‌دهی ss(8) سازگار باشد، اما در عین حال مزایای پایش محلی یا از راه دور (در حالت زنده) و همچنین بازپخش پیشینه از یک بایگانی PCP از پیش ضبط‌شده را نیز ارائه دهد. توجه داشته باشید از آنجا که ss(1) دارای گزینه‌های خط فرمان متعددی است که بسیاری از آن‌ها با گزینه‌های استاندارد خط فرمان PCP شرح داده شده در PCPIntro(1) یکسان هستند، ابزار pcp-ss باید همواره توسط کاربران با استفاده از پیشانهٔ (front-end) pcp فراخوانی شود. این امر اجازه می‌دهد گزینه‌های استاندارد خط فرمان PCP مانند -h، -a، -S، -T، -O، -z و غیره بدون تداخل با گزینه‌های ss(1) ارسال شوند. برای نمونه‌های متداول کاربرد و خطوط فرمان، بخش مثال‌ها (EXAMPLES) در ادامه را ببینید.

حالت زنده (Live mode) از گزینهٔ -h host دستور pcp استفاده می‌کند و مستلزم آن است که PMDA مربوط به pmdasockets(1) روی host هدف (محلی یا از راه دور) نصب و فعال شده باشد؛ برای جزئیات در مورد نحوهٔ فعال‌سازی PMDA مربوط به sockets روی یک میزبان خاص، pmdasockets(1) را ببینید. اگر هیچ‌یک از گزینه‌های -h یا -a داده نشوند، منبع پیش‌فرض، معیارهای زندهٔ جمع‌آوری‌شده روی localhost است.

بازپخش پیشینه/بایگانی از گزینهٔ -a archive دستور pcp استفاده می‌کند، که در آن archive نام پایهٔ (basename) یک بایگانی PCP از پیش ضبط‌شده است. ویژگی بازپخش بایگانی به‌ویژه از این جهت مفید است که آمار سوکت می‌تواند برای یک زمان مشخص با استفاده از گزینهٔ --origin دستور pcp گزارش شود (که مقدار پیش‌فرض آن زمان شروع بایگانی است).

نمایش اطلاعات پایه و پیش‌فرض سوکت برای میزبان محلی. این اطلاعات شامل Netid (tcp، udp و غیره)، State (ESTAB، TIME_WAIT و غیره)، طول صف‌های Recv-Q و Send-Q، و نشانی محلی و همتا (peer) و درگاه (port) برای هر سوکت است.
نمایش همان اطلاعات پایهٔ سوکت بالا برای میزبان somehost، که ممکن است همان localhost پیش‌فرض باشد. آرگومان‌های اضافی خط فرمان (-noemitauO) این موارد را نمایش می‌دهند: یک خط برای هر سوکت (-O)، نام‌های عددی (-n) سرویس‌ها (پیش‌فرض)، اطلاعات زمان‌سنج (-o)، جزئیات گسترش‌یافتهٔ سوکت (-e)، میزان مصرف حافظه سوکت (-m)، اطلاعات داخلی TCP (-i)، هر دو سوکت‌های udp (-u) و tcp (-t)، و هر دو سوکت‌های شنونده (listening) و غیرشنونده (-a).
نمایش همان اطلاعات مثال بالا، اما برای بایگانی somearchive با شروع از زمان مشخص‌شدهٔ Wed 16 Jun 2021 12:57:21. توجه داشته باشید که پیشوند نویسه‌ای @ برای زمان مطلق الزامی است؛ برای جزئیات، PCPIntro(1) را ببینید. بایگانی مسلماً باید شامل داده‌های زمان درخواستی باشد. می‌توانید برای بررسی کران‌های زمانی somearchive از دستور pmlogdump -l somearchive استفاده کنید.
همانند بالا، اما با آفست صفر ثانیه (-O-0) پیش از پایان فعلی somearchive، یعنی تازه‌ترین داده‌های ثبت‌شده در گزارش. توجه داشته باشید که ممکن است somearchive در حال حاضر در حال رشد باشد (یعنی داده‌ها با pmlogger(1) در آن در حال ثبت باشند).

به دلیل تعداد زیاد گزینه‌های پشتیبانی‌شده توسط pcp-ss، جهت تعیین گزینه‌هایی نظیر منبع معیارها (میزبان یا بایگانی) و همچنین (در حالت بایگانی) زمان شروع درخواستی یا آفست، و منطقه زمانی، دستور pcp(1) باید همواره برای فراخوانی pcp-ss با گزینه‌های زیر استفاده شود:

نام میزبان دوردست برای اتصال در حالت زنده.
فایل بایگانی برای استفاده در نمونه‌برداری پیشینه.
آفست زمانی برای استفاده درون یک بایگانی (به‌معنای استفاده از -a است).
زمان شروع (مثلاً در قالب ctime(3)) برای استفاده هنگام بازپخش یک بایگانی.
استفاده از یک منطقه زمانی مشخص. از آنجا که pcp-ss برچسب‌های زمانی را گزارش نمی‌کند، این مورد تنها بر تفسیر زمان شروع مطلق (-S) یا آفست (-O) اثر می‌گذارد.
در حالت بایگانی، استفاده از منطقه زمانی بایگانی به جای منطقه زمانی سیستم محلی اجراکنندهٔ pcp-ss. منطقه زمانی، و زمان‌های شروع و پایان بایگانی را می‌توان با استفاده از pmlogdump(1) به همراه گزینهٔ -L بررسی کرد.

گزینه‌های pcp فوق از طریق متغیرهای محیطی به‌طور غیرمستقیم در دسترس دستور pcp-ss قرار می‌گیرند - برای شرح کامل این گزینه‌ها به PCPIntro(1) مراجعه کنید.

گزینه‌های خط فرمان اضافی موجود برای خود pcp-ss عبارتند از:

نمایش پیام راهنما و خروج
نمایش اطلاعات نسخه
عدم حل (resolve) نام‌های سرویس (در حال حاضر همواره فعال است)
نمایش همهٔ سوکت‌ها
نمایش سوکت‌های شنونده (listening)
نمایش اطلاعات زمان‌سنج (timer)
نمایش اطلاعات تفصیلی سوکت
نمایش میزان مصرف حافظه سوکت
نمایش اطلاعات داخلی TCP
-4, --ipv4
نمایش فقط سوکت‌های IP نسخه ۴
-6, --ipv6
نمایش فقط سوکت‌های IP نسخه ۶
نمایش فقط سوکت‌های TCP
نمایش فقط سوکت‌های UDP
عدم نمایش خط سربرگ (header)
چاپ داده‌های هر سوکت در یک خط واحد

ستون‌های موجود در گزارش pcp-ss بر اساس گزینه‌های خط فرمان متفاوت بوده و دارای همان تفسیری هستند که در ss(8) شرح داده شده است.

یک تفاوت در pcp-ss این است که خط نخست گزارش با «# Timestamp» آغاز می‌شود و به دنبال آن برچسب زمانی (در منطقه زمانی درخواستی، -z و -Z در بالا را ببینید) داده‌های نمونه از منبع میزبان یا بایگانی می‌آید. پس از برچسب زمانی، رشتهٔ فیلتر فعال فعلی برای منبع معیارها قرار دارد. در حالت بایگانی، فیلتر فعال را می‌توان به‌صورت پویا تغییر داد، حتی در زمانی که بایگانی در حال ضبط شدن است. این با ss(8) متفاوت است، که در آن فیلتر به‌صورت اختیاری در خط فرمان ابزار مشخص می‌شود و همواره «زنده» (live) است، یعنی ss(8) از بازپخش گذشته‌نگر پشتیبانی نمی‌کند. در pcp-ss، فیلتر در PMDA پسین (back-end) ذخیره می‌شود، ببینید pmdasockets(1)، در معیار network.persocket.filter. فیلتر پیش‌فرض state connected است، که می‌توان با ذخیره یک مقدار رشته‌ای جدید در معیار network.persocket.filter با استفاده از pmstore(1) آن را تغییر داد؛ برای مثال: pmstore network.persocket.filter "state established". این کار فیلتر پیش‌فرض پایدار را بازنویسی (override) می‌کند، که در یک فایل پیکربندی PMDA ذخیره شده و با هر بار راه‌اندازی PMDA سوکت‌ها بارگیری می‌شود. برای جزئیات بیشتر به pmdasockets(1) و برای جزئیات ساختار نحو فیلتر و مثال‌ها به ss(8) مراجعه کنید.

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

برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به pmGetOptions(3) مراجعه کنید.

PCPIntro(1)، pcp(1)، pmdasockets(1)، pmlogger(1)، pcp.conf(5) و ss(8).

PCP Performance Co-Pilot