نام (NAME)

snmptrapd - دریافت و ثبت پیام‌های trap در پروتکل SNMP

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

snmptrapd [گزینه‌ها] [نشانی‌های شنود]

توضیحات (DESCRIPTION)

برنامه snmptrapd یک برنامه کاربردی SNMP است که پیام‌های TRAP و INFORM پروتکل SNMP را دریافت و ثبت می‌کند.

نکته: حالت پیش‌فرض، شنود روی پورت 162 پروتکل UDP بر روی تمامی رابط‌های IPv4 است. از آنجا که ۱۶۲ یک درگاه ممتاز (نیازمند دسترسی ویژه) است، snmptrapd معمولاً باید با دسترسی مدیر سیستم (root) اجرا شود.

گزینه‌ها (OPTIONS)

-a: نادیده گرفتن ترپ‌های authenticationFailure.
-A: الحاق به انتهای فایل لاگ به جای بازنویسی و پاک کردن آن.
توجه داشته باشید که این گزینه باید پیش از هر گزینه -Lf که قرار است بر آن اعمال شود قرار گیرد.
-c FILE: خواندن FILE به عنوان فایل پیکربندی (یا فهرستی جداشده با کاما از فایل‌های پیکربندی).
-C: نخواندن هیچ‌یک از فایل‌های پیکربندی به جز فایلی که احیاناً با گزینه -c مشخص شده است.
-d: تخلیه بسته‌های SNMP ارسال‌شده و دریافت‌شده در مبنای ۱۶ (هگزادسیمال).
-D[TOKEN[,...]]: فعال کردن خروجی اشکال‌زدایی برای نشانه‌(های) مشخص‌شده. برای خروجی بسیار پرجزئیات، ALL را امتحان کنید.
-f: انشعاب نیافتن (fork نشدن) از پوسته فراخواننده.
-F FORMAT: هنگام ثبت گزارش در خروجی استاندارد، از قالب موجود در رشته FORMAT استفاده شود. برای جزئیات بیشتر به بخش مشخصات قالب در زیر مراجعه کنید.
-h, --help: نمایش پیام خلاصه نحوه استفاده و سپس خروج.
-H: نمایش فهرستی از دستورالعمل‌های فایل پیکربندی که برای دیمن trap قابل فهم است و سپس خروج.
-I [-]INITLIST: مشخص می‌کند کدام ماژول‌ها در هنگام راه‌اندازی snmptrapd باید مقداردهی اولیه شوند (یا نشوند). اگر فهرست جداشده با کاما به نام INITLIST با یک '-' آغاز شود، فهرستی از ماژول‌ها است که نباید شروع شوند. در غیر این صورت، این تنها فهرستی از ماژول‌هایی است که باید راه‌اندازی شوند.
برای دریافت فهرستی از ماژول‌های کامپایل‌شده، snmptrapd را با آرگومان‌های -Dmib_init -H اجرا کنید (با فرض اینکه پشتیبانی از اشکال‌زدایی در آن کامپایل شده باشد).
-L[efos]: مشخص کردن مقصد خروجی لاگ (خطای استاندارد یا خروجی استاندارد، به یک فایل یا از طریق syslog). برای جزئیات به بخش LOGGING OPTIONS در snmpcmd(1) مراجعه کنید.
-m MIBLIST: فهرستی جداشده با دونقطه از ماژول‌های MIB برای بارگذاری در این برنامه تعیین می‌کند. این گزینه بر متغیر محیطی MIBS اولویت دارد. برای جزئیات به snmpcmd(1) مراجعه کنید.
-M DIRLIST: فهرستی جداشده با دونقطه از دایرکتوری‌ها را برای جستجوی MIBها مشخص می‌کند. این گزینه متغیر محیطی MIBDIRS را لغو و بازنویسی می‌کند. برای جزئیات به snmpcmd(1) مراجعه کنید.
-n: تلاش نکردن برای تبدیل نشانی‌های مبدأ بسته‌های ورودی به نام‌های میزبان.
-p FILE: ذخیره شناسه فرآیند (PID) دیمن trap در FILE.
-O [abeEfnqQsStTuUvxX]: مشخص می‌کند اشیاء MIB و سایر خروجی‌ها چگونه باید نمایش داده شوند. برای جزئیات به بخش OUTPUT OPTIONS در صفحه راهنمای snmpcmd(1) مراجعه کنید.
-t: عدم ثبت ترپ‌ها در syslog. این گزینه گزارش‌گیری در syslog را غیرفعال می‌کند. این ویژگی زمانی مفید است که بخواهید برنامه snmptrapd تنها قلاب‌های traphandle را اجرا کند و هیچ ترپی را در هیچ مکانی لاگ نکند.
-v, --version: چاپ اطلاعات نسخه دیمن trap و سپس خروج.
-x ADDRESS: اتصال به عامل اصلی AgentX در نشانی مشخص‌شده، به جای نشانی پیش‌فرض "/var/agentx/master". برای جزئیات قالب این نشانی‌ها به snmpd(8) مراجعه کنید.
-X: عدم اتصال به عامل اصلی AgentX.
--name="value": امکان مشخص کردن هر نشانه ("name") پشتیبانی‌شده در فایل snmptrapd.conf و تنظیم مقدار آن به "value". این گزینه نشانه‌ی متناظر در فایل snmptrapd.conf را بازنویسی می‌کند. برای فهرست کامل نشانه‌ها به snmptrapd.conf(5) مراجعه کنید.

مشخصات قالب (FORMAT SPECIFICATIONS)

دستور snmptrapd رشته‌های قالب را مشابه با printf(3) تفسیر می‌کند. دنباله‌های قالب‌بندی زیر را پشتیبانی می‌نماید:

%%: نویسه واقعی %
%a: محتوای فیلد agent-addr در بسته PDU (تنها برای ترپ‌های v1)
%A: نام میزبان متناظر با محتوای فیلد agent-addr در بسته PDU، در صورت در دسترس بودن؛ در غیر این صورت محتوای فیلد agent-addr در PDU (تنها ترپ‌های v1).
%b: نشانی انتقال PDU (توجه: این نشانی الزاماً یک آدرس IPv4 نیست).
چیزی شبیه به "[UDP: [172.16.10.12]:23456->[10.150.0.8]]"
%B: نام میزبان مبدأ PDU در صورت وجود، در غیر این صورت آدرس مبدأ PDU (به یادداشت بالا مراجعه کنید)
%E: شناسه موتور زمینه SNMPv3 (context engine id)
%h: ساعت جاری در سیستم محلی
%H: فیلد ساعت از متغیر sysUpTime.0
%j: دقیقه جاری در سیستم محلی
%J: فیلد دقیقه از متغیر sysUpTime.0
%k: ثانیه جاری در سیستم محلی
%K: فیلد ثانیه از متغیر sysUpTime.0
%l: روز جاری ماه در سیستم محلی
%L: فیلد روز ماه از متغیر sysUpTime.0
%m: ماه جاری (عددی) در سیستم محلی
%M: فیلد عددی ماه از متغیر sysUpTime.0
%N: رشته سازمانی (enterprise string)
%P: اطلاعات امنیتی از PDU (نام community برای v1/v2c، کاربر و context برای v3)
%q: زیرنوع ترپ (عددی، در مبنای ۱۰)
%s: شماره نسخه SNMP (برابر 0: v1، برابر 1: v2c، برابر 2: v3)
%S: شماره نسخه مدل امنیتی SNMPv3
%t: تعداد ثانیه‌های مبنای ۱۰ گذشته از زمان مرجع سیستم‌عامل (مطابق خروجی time(2))
%T: مقدار متغیر sysUpTime.0 بر حسب ثانیه
%u: نام امنیتی SNMPv3، یا نام community در v1/v2c
%v: فهرست متغیرهای پیوندداده‌شده از محموله اعلان. این موارد با یک تب یا با کاما و یک فاصله در صورت درخواست فرم جایگزین جدا می‌شوند. به %V نیز مراجعه کنید.
%V: جداکننده متغیرهای پیوندداده‌شده را مشخص می‌کند. این گزینه دنباله‌ای از نویسه‌ها را تا نویسه بعدی % دریافت می‌کند (برای گنجاندن یک % در رشته از استفاده کنید)
%w: نوع ترپ (عددی، در مبنای ۱۰)
%W: شرح ترپ
%y: سال جاری در سیستم محلی
%Y: فیلد سال از متغیر sysUpTime.0

علاوه بر این مقادیر، عرض و دقت فیلد نیز می‌تواند به صورت اختیاری تعیین شود، درست همانند printf(3)، و همچنین یک مقدار فلگ. فلگ‌های زیر پشتیبانی می‌شوند:

-: تراز به چپ
0: استفاده از صفرهای ابتدایی
#: استفاده از فرم جایگزین

فلگ «استفاده از فرم جایگزین» رفتار دنباله‌های مختلف رشته قالب را تغییر می‌دهد:

: اطلاعات زمانی بر اساس GMT نمایش داده می‌شود (به جای منطقه زمانی محلی)
: متغیرهای پیوندداده‌شده فهرستی جداشده با کاما خواهند بود (به جای جداشده با تب)
: زمان کارکرد سیستم (uptime) به قالبی خوانا برای انسان تبدیل می‌شود (به جای یک عدد صحیح ساده)

مثال‌ها (Examples)

برای دریافت پیامی مانند "14:03 TRAP3.1 from humpty.ucd.edu" می‌توانید از دستوری شبیه به این استفاده کنید:

snmptrapd -P -F "%02.2h:%02.2j TRAP%w.%q from %A\n"

اگر همان پیام را در زمان GMT به جای ساعت محلی می‌خواهید، استفاده کنید از:

snmptrapd -P -F "%#02.2h:%#02.2j TRAP%w.%q from %A\n"

نشانی‌های شنود (LISTENING ADDRESSES)

به طور پیش‌فرض، snmptrapd بسته‌های ورودی SNMP TRAP و INFORM را روی پورت 162 پروتکل UDP بر روی تمامی رابط‌های IPv4 شنود می‌کند. با این حال، می‌توان با مشخص کردن یک یا چند نشانی شنود به عنوان آرگومان‌های snmptrapd این رفتار را تغییر داد. برای اطلاعات بیشتر پیرامون ساختار نشانی‌های شنود به صفحه راهنمای snmpd(8) مراجعه کنید.

پشتیبانی از NOTIFICATION-LOG-MIB (NOTIFICATION-LOG-MIB SUPPORT)

از نسخه net-snmp 5.0، برنامه کاربردی snmptrapd از ماژول NOTIFICATION-LOG-MIB پشتیبانی می‌کند. این کار با باز کردن یک اتصال زیرعامل AgentX به عامل اصلی snmpd و ثبت جدول‌های گزارش اعلان‌ها انجام می‌شود. تا زمانی که برنامه snmpd اول راه‌اندازی شود، این برنامه به آن متصل خواهد شد و بنابراین باید بتوانید آخرین اعلان‌های ثبت‌شده را از طریق nlmLogTable و nlmLogVariableTable مشاهده کنید. برای غیرفعال کردن این پشتیبانی به فایل snmptrapd.conf و نشانه‌ی "doNotRetainNotificationLogs" مراجعه کنید. برای جزئیات بیشتر درباره خود MIB به NOTIFICATION-LOG-MIB مراجعه نمایید.

توسعه‌پذیری و پیکربندی (EXTENSIBILITY AND CONFIGURATION)

صفحه راهنمای snmptrapd.conf(5) را ببینید.

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

snmpcmd(1), snmpd(8), printf(3), snmptrapd.conf(5), syslog(8), traptoemail(1), variables(5)