ovs-dpctl-top(8)              Open vSwitch Manual             ovs-dpctl-top(8)

نام (NAME)
       ovs-dpctl-top - ابزار پایش بصری شبیه top برای دیتapathهای Open vSwitch

خلاصه دستور (SYNOPSIS)
       ovs-dpctl-top [-h] [-v] [-f FLOWFILES] [-V] [-s] [--host HOST] [-a |
       --accumulate] [--accumulate-decay ACCUMULATEDECAY] [-d DELAY]

توضیحات (DESCRIPTION)
       این برنامه با تجمیع تعداد بسته‌ها، کل بایت‌ها و رخداد فیلدهای زیر، محتوای
       جریان‌های ovs-dpctl را خلاصه‌سازی می‌کند:

              - درگاه ورودی (in_port) دیتapath

              - نوع اترنت (Ethernet type)

              - نشانی‌های MAC مبدأ و مقصد

              - پروتکل IP

              - نشانی‌های IPv4 مبدأ و مقصد

              - نشانی‌های IPv6 مبدأ و مقصد

              - درگاه‌های مقصد UDP و TCP

              - نشانی‌های مبدأ و مقصد تونل

   مقادیر نمایش‌یافته در خروجی (Output shows four values):
              - FIELDS: فیلدهای جریان، برای نمونه in_port(1).

              - COUNT: تعداد خطوط در خروجی dump-flow که حاوی این فیلد جریان
              هستند.

              - PACKETS: تعداد کل بسته‌های حاوی این فیلد جریان.

              - BYTES: تعداد کل بایت‌های حاوی این فیلد جریان. در صورتی که واحد
              مشخص نشده باشد، مقادیر بر حسب بایت هستند.

              - AVERAGE: میانگین اندازه بسته‌ها (BYTES/PACKET).

   رفتار شبیه Top (Top Behavior)
       در حین قرار داشتن در حالت top (که رفتار پیش‌فرض است)، دستورهای تک‌نویسه‌ای
       زیر پشتیبانی می‌شوند:

              a - تغییر وضعیت بین حالت انباشتی (accumulate) و زنده (live).
              حالت انباشتی در ادامه تشریح شده است.

              s - تغییر ستون مورد استفاده برای مرتب‌سازی نزولی محتوا. عنوان
              DESC در بالای ستون قرار می‌گیرد.

              _ - فاصله (space) نشان‌دهنده جمع‌آوری مجدد محتوای dump-flow است.

              h - توقف خروجی. فشردن هر کلیدی نمونه‌برداری را دوباره راه‌اندازی
              می‌کند.

              f - پیمایش چرخشی میان فیلدهای جریان.

              q - حرف q برای خروج (quit).

   حالت انباشتی (Accumulate Mode)
       دو حالت پشتیبانی می‌شود: زنده (live) و انباشتی (accumulate). پیش‌فرض حالت
       زنده است.  پارامتر --accumulate یا نویسه 'a' در حالت top، حالت دوم را
       فعال می‌کند. در حالت زنده، محتوای اخیر dump-flow نمایش داده می‌شود؛ در
       حالی که در حالت انباشتی، اطلاعات تاریخی پیشین تا زمان بازنشانی جریان (و
       نه هنگام پاکسازی جریان) نگهداری و ردیابی می‌شوند.  جریان‌های بازنشانی‌شده
       زمانی تشخیص داده می‌شوند که تعداد بسته‌های یک جریان نسبت به نمونه پیشین
       خود کاهش یافته باشد.  یک نکته وجود دارد: سیستم در نهایت با کمبود حافظه
       روبرو خواهد شد، مگر اینکه پس از پایان دوره زوال انباشت
       (accumulate-decay)، جریان‌هایی که تازه‌سازی نشده‌اند پاکسازی گردند.  هدف
       در اینجا آزادسازی حافظه از جریان‌های غیرفعال است. آمارها کاهش نمی‌یابند؛
       هدف آن‌ها بازتاب تاریخچه کلی فیلدهای جریان است.

   اشکال‌زدایی خطاها (Debugging Errors)
       خطاهای تجزیه شمارش شده و در خط وضعیت در ابتدای خروجی نمایش داده می‌شوند.
       برای مشاهده خروجی‌هایی که تجزیه نشده‌اند، از گزینه --verbose همراه با
       --script استفاده کنید، مانند:

       $ ovs-dpctl dump-flows | ovs-dpctl-top --script --verbose

       پیام‌های خطا محتوایی را که تجزیه آن با شکست مواجه شده است مشخص می‌کنند.

   دسترسی به میزبان‌های دوردست (Access Remote Hosts)
       گزینه --host باید از قالب user@hostname پیروی کند. این اسکریپت صرفاً
       'ssh user@Hostname' را بدون بررسی اعتبارنامه‌های ورود فراخوانی می‌کند؛
       بنابراین کلیدهای عمومی باید روی سیستمی که با hostname مشخص شده است نصب
       باشند، مانند:

       $ ssh-copy-id user@hostname

       برای جزئیات بیشتر به صفحات راهنمای ssh-copy-id(1) مراجعه کنید.

   کاربرد مورد انتظار (Expected usage)
       $ ovs-dpctl-top

       یا برای اجرا در قالب یک اسکریپت:

       $ ovs-dpctl dump-flows > dump-flows.log
       $ ovs-dpctl-top --script --flow-file dump-flows.log

   گزینه‌ها (OPTIONS)
       -h, --help
              نمایش این پیام راهنما و خروج.

       -v, --version
              نمایش شماره نسخه برنامه و خروج.

       -f FLOWFILES, --flow-file FLOWFILES
              فایل حاوی جریان‌ها از خروجی ovs-dpctl dump-flow.

       -V, --verbose
              فعال‌سازی پرگویی در سطح اشکال‌زدایی (debug).

       -s, --script
              اجرا از طریق اسکریپت (بدون رابط کاربری).

       --host HOST
              مشخص کردن یک user@host برای واکشی جریان‌ها؛ برای اطلاعات بیشتر
              بخش دسترسی به میزبان‌های دوردست را ببینید.

       -a, --accumulate
              انباشت محتوای dump-flow.

       --accumulate-decay ACCUMULATEDECAY
              زوال جریان‌های انباشته قدیمی. مقدار پیش‌فرض ۵ دقیقه است. مقدار ۰
              فرآیند زوال را غیرفعال می‌کند.

       -d DELAY, --delay DELAY
              تاخیر بر حسب میلی‌ثانیه برای جمع‌آوری محتوای dump-flow (نرخ
              نمونه‌برداری).

Open vSwitch                         4.0.0                    ovs-dpctl-top(8)