نام (NAME)

snmpdelta - پایش تغییرات تفاضلی (دلتا) در مقادیر شمارنده SNMP

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

snmpdelta [ COMMON OPTIONS ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [ -CF configfile ] [ -Cl ] [ -Cp period ] [ -CP Peaks ] [ -Ck ] [ -CT ] AGENT OID [ OID ... ]

توضیحات (DESCRIPTION)

snmpdelta شناسه‌های شیء (OID) با مقدار عدد صحیح را پایش کرده و تغییرات آن‌ها در طول زمان را گزارش می‌دهد.

شناسه AGENT یک کارگزار هدف SNMP را مشخص می‌کند که برای پایش اشیاء معین تنظیم شده است. در ساده‌ترین حالت، مشخصات AGENT شامل یک نام میزبان یا نشانی IPv4 خواهد بود. در این وضعیت، دستور تلاش می‌کند با استفاده از UDP/IPv4 به درگاه ۱۶۱ میزبان هدف داده‌شده متصل شود. برای مشاهده فهرست کامل قالب‌های مجاز AGENT به snmpcmd(1) مراجعه کنید.

شناسه OID یک شناسه شیء است که نوع شیء را در یک MIB به‌طور یکتا مشخص می‌کند. چندین OID را می‌توان در یک دستور snmpdelta تعیین کرد.

گزینه‌ها (OPTIONS)

COMMON OPTIONS: لطفاً برای فهرستی از مقادیر ممکن برای گزینه‌های عمومی (COMMON OPTIONS) و همچنین توضیحات آن‌ها، به snmpcmd(1) مراجعه کنید.
-Cf: خطاها را تصحیح نکرده و درخواست را مجدداً امتحان نمی‌کند. بدون این گزینه، اگر چندین OID برای یک درخواست مشخص شده باشد و درخواست برای یک یا چند OID با شکست مواجه شود، snmpdelta درخواست را دوباره امتحان می‌کند تا داده‌های مربوط به OIDهایی غیر از موارد ناموفق همچنان بازگردانده شوند. تعیین -Cf به snmpdelta می‌گوید که حتی در صورت مشخص بودن چندین OID، درخواست را دوباره امتحان نکند.
-Ct: این فلگ فاصله زمانی را از موجودیت تحت پایش تعیین می‌کند.
-Cs: این فلگ یک برچسب زمان (timestamp) را نمایش می‌دهد.
-CS: علاوه بر شمارش نمونه‌های جداگانه، یک «شمارش کل» (sum count) تولید می‌کند. «شمارش کل» مجموع همه دلتاهای جداگانه برای هر دوره زمانی است.
-Cm: حداکثر مقدار کسب‌شده تا کنون را چاپ می‌کند.
-CF configfile: به snmpdelta می‌گوید که پیکربندی خود را از فایل مشخص‌شده بخواند. این گزینه اجازه می‌دهد تا ورودی از قبل تنظیم شود، به‌جای اینکه نیاز باشد در خط فرمان مشخص شود.
-Cl: به snmpdelta می‌گوید که پیکربندی خود را در فایل‌هایی ذخیره کند که نام آن‌ها با نمونه‌های MIB تحت پایش مطابقت دارد. به عنوان مثال، snmpdelta -Cl localhost ifInOctets.1 فایلی با نام "localhost-ifInOctets.1" ایجاد می‌کند.
-Cp: تعداد ثانیه‌های بین دوره‌های نظرسنجی (polling) را تعیین می‌کند. نظرسنجی شامل ارسال یک درخواست به کارگزار است. دوره نظرسنجی پیش‌فرض یک ثانیه است.
-CP peaks: دوره گزارش‌دهی را بر حسب تعداد دوره‌های نظرسنجی تعیین می‌کند. در صورت تعیین این گزینه، snmpdelta کارگزار را به تعداد peaks مرتبه قبل از گزارش نتایج نظرسنجی می‌کند. نتیجه گزارش‌شده شامل مقدار میانگین در طول دوره گزارش‌دهی است. علاوه بر این، بالاترین مقدار نظرسنجی‌شده در طول دوره گزارش‌دهی نشان داده می‌شود.
-Ck: هنگامی که دوره نظرسنجی (-Cp) مضربی از ۶۰ ثانیه باشد و برچسب زمان در خروجی (-Cs) نمایش داده شود، حالت پیش‌فرض برچسب زمان را به صورت hh:mm mm/dd نشان می‌دهد. این گزینه قالب برچسب زمان را به hh:mm:ss mm/dd تغییر می‌دهد.
-CT: باعث می‌شود snmpdelta خروجی خود را به صورت جدول چاپ کند.
-Cv vars/pkt: حداکثر تعداد OIDهای مجاز برای بسته‌بندی در یک PDU واحد را مشخص می‌کند. چندین PDU را می‌توان در یک درخواست ایجاد کرد. مقدار پیش‌فرض متغیرها در هر بسته ۶۰ است. این گزینه زمانی مفید است که پاسخ به یک درخواست به دلیل بزرگ بودن بیش از حد بسته منجر به خطا شود.

توجه داشته باشید که snmpdelta همان‌طور که در صفحه راهنمای snmpcmd(1) شرح داده شده است، به یک آرگومان برای تعیین کارگزار جهت پرس‌وجو و حداقل یک آرگومان OID نیاز دارد.

مثال‌ها (EXAMPLES)

$ snmpdelta -c public -v 1 -Cs localhost IF-MIB::ifInUcastPkts.3 IF-MIB::ifOutUcastPkts.3
[20:15:43 6/14] ifInUcastPkts.3 /1 sec: 158
[20:15:43 6/14] ifOutUcastPkts.3 /1 sec: 158
[20:15:44 6/14] ifInUcastPkts.3 /1 sec: 184
[20:15:44 6/14] ifOutUcastPkts.3 /1 sec: 184
[20:15:45 6/14] ifInUcastPkts.3 /1 sec: 184
[20:15:45 6/14] ifOutUcastPkts.3 /1 sec: 184
[20:15:46 6/14] ifInUcastPkts.3 /1 sec: 158
[20:15:46 6/14] ifOutUcastPkts.3 /1 sec: 158
[20:15:47 6/14] ifInUcastPkts.3 /1 sec: 184
[20:15:47 6/14] ifOutUcastPkts.3 /1 sec: 184
[20:15:48 6/14] ifInUcastPkts.3 /1 sec: 184
[20:15:48 6/14] ifOutUcastPkts.3 /1 sec: 184
[20:15:49 6/14] ifInUcastPkts.3 /1 sec: 158
[20:15:49 6/14] ifOutUcastPkts.3 /1 sec: 158
^C
$ snmpdelta -c public -v 1 -Cs -CT localhost IF-MIB:ifInUcastPkts.3 IF-MIB:ifOutcastPkts.3
localhost	ifInUcastPkts.3	ifOutUcastPkts.3
[20:15:59 6/14]	184.00	184.00
[20:16:00 6/14]	158.00	158.00
[20:16:01 6/14]	184.00	184.00
[20:16:02 6/14]	184.00	184.00
[20:16:03 6/14]	158.00	158.00
[20:16:04 6/14]	184.00	184.00
[20:16:05 6/14]	184.00	184.00
[20:16:06 6/14]	158.00	158.00
^C

مثال زیر از چندین گزینه استفاده می‌کند. از آنجا که گزینه Cl مشخص شده است، خروجی به یک فایل ارسال می‌شود و نه به صفحه نمایش.

$ snmpdelta -c public -v 1 -Ct -Cs -CS -Cm -Cl -Cp 60 -CP 60
  interlink.sw.net.cmu.edu .1.3.6.1.2.1.2.2.1.16.3 .1.3.6.1.2.1.2.2.1.16.4

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

snmpcmd(1), variables(5).