نام (NAME)

bmon - پایشگر پهنای باند و برآوردکننده نرخ انتقال داده

خلاصه دستور (SYNOPSIS)

bmon [--show-all] [--use-si] [--input=ماژول] [--output=ماژول] [گزینه‌ها...]

توضیحات (DESCRIPTION)

دستور bmon یک ابزار پایش و اشکال‌زدایی برای جمع‌آوری آمار مربوط به شبکه و آماده‌سازی بصری آن‌ها به شکلی کاربرپسند برای انسان است. این ابزار از روش‌های خروجی گوناگونی از جمله رابط کاربری تعاملی curses و خروجی متنی قابل برنامه‌ریزی برای اسکریپت‌نویسی پشتیبانی می‌کند.

گزینه‌ها (OPTIONS)

-h, --help

متن راهنمای کوتاهی را چاپ کرده و خارج می‌شود.

-V, --version

شناسه نسخه را چاپ کرده و خارج می‌شود.

-i, --input=ماژول[:گزینه‌ها][,ماژول...]

فهرست ماژول‌های ورودی جهت بارگذاری و استفاده را تنظیم می‌کند. چندین ماژول می‌توانند به‌طور همزمان استفاده شوند. bmon به‌طور خودکار یک ماژول ورودی کاربردی و فعال را به‌صورت پیش‌فرض بارگذاری می‌کند. برای جزئیات بیشتر بخش ماژول‌های ورودی (INPUT MODULES) را ببینید.

-o, --output=ماژول[:گزینه‌ها][,ماژول...]

فهرست ماژول‌های خروجی جهت بارگذاری و استفاده را تنظیم می‌کند. چندین ماژول می‌توانند به‌طور همزمان استفاده شوند. به‌طور پیش‌فرض، bmon از حالت خروجی curses استفاده می‌کند؛ اگر به دلیل ناسازگاری کنسول در دسترس نباشد، به یک حالت متنی ساده بازمی‌گردد. برای جزئیات بیشتر بخش ماژول‌های خروجی (OUTPUT MODULES) را ببینید.

-U, --use-si

استفاده از سیستم یکاهای SI (که در آن ۱ کیلوبایت = ۱٬۰۰۰ بایت است) به جای ۱ کیلوبایت = ۱٬۰۲۴ بایت.

-f, --configfile=فایل

تنظیم مسیر جایگزین برای فایل پیکربندی.

-p, --policy=سیاست

تنظیم سیاستی که مشخص می‌کند کدام رابط‌های شبکه نمایش داده شوند. برای جزئیات بیشتر بخش انتخاب رابط (INTERFACE SELECTION) را ببینید.

-a, --show-all

نمایش تمام رابط‌ها، حتی رابط‌هایی که از نظر مدیریتی غیرفعال (down) هستند.

-r, --read-interval=اعشاری

تنظیم بازه زمانی بر حسب ثانیه که در آن ماژول‌های ورودی آمار را از منبع خود می‌خوانند. مقدار پیش‌فرض ۱٫۰ ثانیه است.

-R, --rate-interval=اعشاری

تنظیم بازه زمانی بر حسب ثانیه که در آن نرخ به ازای هر شمارنده محاسبه می‌شود. مقدار پیش‌فرض ۱٫۰ ثانیه است.

-b, --use-bit

نمایش نرخ‌ها بر حسب بیت بر ثانیه به جای بایت بر ثانیه.

-L, --lifetime=اعشاری

تنظیم طول عمر یک عنصر بر حسب ثانیه، پیش از آنکه در صورت عدم دریافت به‌روزرسانی آماری دیگر نمایش داده نشود. مقدار پیش‌فرض ۳۰ ثانیه است.

ماژول‌های ورودی (INPUT MODULES)

ماژول‌های ورودی داده‌های آماری مربوط به عناصر را فراهم می‌کنند. هر عنصر از ویژگی‌هایی تشکیل شده است که نشان‌دهنده یک شمارنده، نرخ یا درصد هستند. عناصر ممکن است دارای عناصر فرزند اضافی باشند تا یک ساختار سلسله‌مراتبی را نشان دهند. هر عنصر به یک گروه که توسط ماژول ورودی تعریف شده، تخصیص می‌یابد. ماژول‌های ورودی در فواصل زمانی بازه خواندن پیکربندی‌شده مورد پرسش (poll) قرار می‌گیرند.

ماژول‌های ورودی زیر در دسترس هستند:

netlink: از پروتکل Netlink برای جمع‌آوری آمار رابط‌ها و کنترل ترافیک از هسته استفاده می‌کند. این ماژول ورودی پیش‌فرض است.
proc: آمار رابط‌ها را از فایل /proc/net/dev می‌خواند. این یک رابط قدیمی (legacy) محسوب می‌شود و به دلایل سازگاری با نسخه‌های پیشین ارائه شده است. در صورتی که رابط Netlink در دسترس نباشد، این ماژول به عنوان جایگزین (fallback) عمل می‌کند.
dummy: ماژول ورودی قابل برنامه‌ریزی برای اهداف اشکال‌زدایی و آزمایش.
null: هیچ داده‌ای جمع‌آوری نمی‌شود.

برای دریافت اطلاعات بیشتر درباره یک ماژول، آن را همراه با گزینه "help" به این صورت اجرا کنید:

bmon -i netlink:help

برای جزئیات بیشتر بخش پیکربندی ماژول (MODULE CONFIGURATION) را ببینید.

ماژول‌های خروجی (OUTPUT MODULES)

ماژول‌های خروجی داده‌های آماری جمع‌آوری‌شده توسط ماژول‌های ورودی را نمایش داده یا صادر می‌کنند. چندین ماژول خروجی می‌توانند به‌طور همزمان اجرا شوند. bmon از تداخل‌های احتمالی مانند نوشتن همزمان چندین ماژول خروجی در کنسول جلوگیری نخواهد کرد.

ماژول‌های خروجی زیر وجود دارند:

curses: رابط کاربری متنی تعاملی مبتنی بر curses که برآورد نرخ‌ها به‌صورت بلادرنگ و نمایش گرافیکی هر ویژگی را ارائه می‌دهد. برای نمایش راهنمای مرجع سریع کلید '?' را فشار دهید. این حالت خروجی پیش‌فرض است.
ascii: خروجی متنی ساده و قابل برنامه‌ریزی برای استفاده کاربر. قادر به چاپ فهرست رابط‌ها، شمارنده‌های دقیق و نمودارها در کنسول است. در صورتی که curses در دسترس نباشد، این حالت خروجی جایگزین (fallback) پیش‌فرض است.
format: حالت خروجی کاملاً اسکریپت‌پذیر برای استفاده توسط سایر برنامه‌ها. برای اطلاعات تکمیلی متن راهنمای ماژول را ببینید.
null: غیرفعال کردن خروجی.

برای دریافت اطلاعات بیشتر درباره یک ماژول، آن را همراه با گزینه "help" به این صورت اجرا کنید:

bmon -o curses:help

برای جزئیات بیشتر بخش پیکربندی ماژول (MODULE CONFIGURATION) را ببینید.

پیکربندی ماژول (MODULE CONFIGURATION)

نحو (Syntax) پیکربندی ماژول‌ها به صورت زیر است:

ARGUMENT ::= mod1[:OPTS][,mod2[:OPTS]...]
OPTS     ::= OPTION[;OPTION...]
OPTION   ::= option[=value]

ماژول را با گزینه "help" اجرا کنید تا فهرست گزینه‌های هر ماژول را دریافت کنید:

bmon -i module:help

انتخاب رابط (INTERFACE SELECTION)

از نحو زیر برای تعریف سیاست انتخاب رابط استفاده می‌شود:

SELECTION ::= NAME[,NAME[,...]]
NAME      ::= [!]interface

نام رابط می‌تواند شامل نویسه '*' باشد که به عنوان نویسه عام (wildcard) عمل کرده و نشان‌دهنده هر تعداد از هر نوع نویسه است، مانند ... ,eth*, h*0

مثال‌ها:

lo,eth0,eth1
eth*,!eth0

مثال‌ها (EXAMPLES)

برای اجرای bmon در حالت curses و پایش رابط‌های eth0 و eth1:

bmon -p eth0,eth1 -o curses

برای اجرای bmon در حالت format، پایش هر رابط *eth با یک رشته قالب‌بندی مشخص:

bmon -p 'eth*' -o format:fmt='$(element:name) $(attr:rxrate:packets)\n'

فایل‌ها (FILES)

/etc/bmon.conf
$HOME/.bmonrc

همچنین ببینید (SEE ALSO)

ip(8), netstat(8), ifconfig(8), netlink(7)

نویسندگان (AUTHORS)

Thomas Graf <tgraf@suug.ch> و دیگران