1 NAGIOS-NOTIFY-MIB DEFINITIONS ::= BEGIN
3 MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
6 nagios,NotifyType,HostStateID,HostStateType,ServiceStateID
9 nagiosNotify MODULE-IDENTITY
10 LAST-UPDATED "200503090000Z" -- March 9, 2005
15 Telephone: +1 201 232 2851
16 Email: sghosh@users.sourceforge.net
22 "Objects for Nagios(tm) events. There are 2 primary tables
23 reflecting the division in Nagios for Host events and
26 The event tables are extended by the HostNotifyTable and the
27 ServiceNotifyTable to keep track of the notifications based on events.
29 The tables entries themselves are not accessible but are used for OID
30 entries for TRAP/INFORM notifications.
32 These objects are based on the macros defined in Nagios v2.0
34 REVISION "200503090000Z" -- March 9, 2005
37 REVISION "200501200000Z" --January 20, 2005
43 nagiosHostEventTable OBJECT-TYPE
44 SYNTAX SEQUENCE OF HostEventEntry
45 MAX-ACCESS not-accessible
48 "Table of Nagios host events"
49 ::= { nagiosNotify 1 }
51 HostEventEntry ::= SEQUENCE {
52 nHostEventIndex Integer32,
53 nHostname OCTET STRING,
54 nHostAlias OCTET STRING,
55 nHostStateID HostStateID,
56 nHostStateType HostStateType,
57 nHostAttempt Integer32,
58 nHostDurationSec Integer32,
59 nHostGroupName OCTET STRING,
60 nHostLastCheck INTEGER,
61 nHostLastChange INTEGER,
63 nHostLastDown INTEGER,
64 nHostLastUnreachable INTEGER,
65 nHostOutput OCTET STRING,
66 nHostPerfData OCTET STRING
69 nagiosHostEventEntry OBJECT-TYPE
71 MAX-ACCESS not-accessible
74 "Each notification event"
75 INDEX { nHostEventIndex }
76 ::= { nagiosHostEventTable 1 }
78 nHostEventIndex OBJECT-TYPE
79 SYNTAX Integer32 (1..65535)
80 MAX-ACCESS not-accessible
83 "This object uniquely identifies this host event entry. It is generated
84 by the SNMP application and is not related to any Nagios data."
85 ::= { nagiosHostEventEntry 1 }
92 "Hostname as specified in the Nagios configuration file."
93 ::= { nagiosHostEventEntry 2 }
95 nHostAlias OBJECT-TYPE
100 "The host alias as specified in the Nagios configuration file"
101 ::= { nagiosHostEventEntry 3 }
103 nHostStateID OBJECT-TYPE
108 "The host state as defined by the HOSTSTATEID macro"
109 ::= { nagiosHostEventEntry 4 }
111 nHostStateType OBJECT-TYPE
116 "The host state as defined by the HOSTSTATETYPE macro"
117 ::= { nagiosHostEventEntry 5 }
119 nHostAttempt OBJECT-TYPE
124 "The number of the current host check retry. For instance, if this is the
125 second time that the host is being rechecked, this will be the number two.
126 Current attempt number is really only useful when writing host event
127 handlers for soft states that take a specific action based on the host retry
128 number. The host state as defined by the HOSTSTATEID macro"
129 ::= { nagiosHostEventEntry 6 }
131 nHostDurationSec OBJECT-TYPE
136 "A number indicating the number of seconds that the host has spent in its
138 ::= { nagiosHostEventEntry 7 }
140 nHostGroupName OBJECT-TYPE
145 "The short name of the hostgroup that this host belongs to. This value is
146 taken from the hostgroup_name directive in the hostgroup definition. If the
147 host belongs to more than one hostgroup this macro will contain the name of
149 ::= { nagiosHostEventEntry 8 }
151 nHostLastCheck OBJECT-TYPE
156 "This is a timestamp in time_t format (seconds since the UNIX epoch)
157 indicating the time at which a check of the host was last performed."
158 ::= { nagiosHostEventEntry 9 }
160 nHostLastChange OBJECT-TYPE
165 "This is a timestamp in time_t format (seconds since the UNIX epoch)
166 indicating the time the host last changed state."
167 ::= { nagiosHostEventEntry 10 }
169 nHostLastUp OBJECT-TYPE
174 "This is a timestamp in time_t format (seconds since the UNIX epoch)
175 indicating the time at which the host was last detected as being in an UP
177 ::= { nagiosHostEventEntry 11 }
179 nHostLastDown OBJECT-TYPE
184 "This is a timestamp in time_t format (seconds since the UNIX epoch)
185 indicating the time at which the host was last detected as being in an
187 ::= { nagiosHostEventEntry 12 }
189 nHostLastUnreachable OBJECT-TYPE
194 "This is a timestamp in time_t format (seconds since the UNIX epoch)
195 indicating the time at which the host was last detected as being in an
197 ::= { nagiosHostEventEntry 13 }
199 nHostOutput OBJECT-TYPE
204 "The text output from the last host check (i.e. Ping OK)."
205 ::= { nagiosHostEventEntry 14 }
207 nHostPerfData OBJECT-TYPE
212 "This object contains any performance data that may have been returned
213 by the last host check."
214 ::= { nagiosHostEventEntry 15 }
219 -- Host Notifications
221 nagiosHostNotifyTable OBJECT-TYPE
222 SYNTAX SEQUENCE OF HostNotifyEntry
223 MAX-ACCESS not-accessible
226 "Table of Nagios host notifications"
229 HostNotifyEntry ::= SEQUENCE {
230 nHostNotifyType NotifyType,
231 nHostNotifyNum Gauge32, -- was Integer32,
232 nHostAckAuthor OCTET STRING,
233 nHostAckComment OCTET STRING
236 nagiosHostNotifyEntry OBJECT-TYPE
237 SYNTAX HostNotifyEntry
238 MAX-ACCESS not-accessible
241 "Nagios host notifications extends the nagiosHostEventTable when a
242 notification is generated for an event."
243 INDEX { nHostEventIndex }
244 ::= { nagiosHostNotifyTable 1 }
246 nHostNotifyType OBJECT-TYPE
251 "This identifies the type of notification that is being sent
252 (PROBLEM, RECOVERY, ACKNOWLEDGEMENT, FLAPPINGSTART or FLAPPINGSTOP)"
253 ::= { nagiosHostNotifyEntry 1 }
255 nHostNotifyNum OBJECT-TYPE
256 SYNTAX Gauge32 -- was NotifyType
260 "This identifies the current notification number for the service or host.
261 The notification number increases by one (1) each time a new notification
262 is sent out for a host or service (except for acknowledgements). The
263 notification number is reset to 0 when the host or service recovers
264 (after the recovery notification has gone out). Acknowledgements do not
265 cause the notification number to increase."
266 ::= { nagiosHostNotifyEntry 2 }
268 nHostAckAuthor OBJECT-TYPE
273 "A string containing the name of the user who acknowledged the host
274 problem. This macro is only valid in notifications where the
275 $NOTIFICATIONTYPE$ macro is set to ACKNOWLEDGEMENT."
276 ::= { nagiosHostNotifyEntry 3 }
278 nHostAckComment OBJECT-TYPE
283 "A string containing the acknowledgement comment that was entered by
284 the user who acknowledged the host problem. This macro is only valid
285 in notifications where the $NOTIFICATIONTYPE$ macro is set to ACKNOWLEDGEMENT"
286 ::= { nagiosHostNotifyEntry 4 }
294 nagiosSvcEventTable OBJECT-TYPE
295 SYNTAX SEQUENCE OF SvcEventEntry
296 MAX-ACCESS not-accessible
299 "Table of Nagios service notifications"
300 ::= { nagiosNotify 3 }
302 SvcEventEntry ::= SEQUENCE {
303 nSvcEventIndex Integer32,
304 nSvcHostname OCTET STRING,
305 nSvcHostAlias OCTET STRING,
306 nSvcHostStateID HostStateID,
307 nSvcHostStateType HostStateType,
308 nSvcDesc OCTET STRING,
309 nSvcStateID ServiceStateID,
310 nSvcAttempt Integer32,
311 nSvcDurationSec Integer32,
312 nSvcGroupName OCTET STRING,
313 nSvcLastCheck INTEGER,
314 nSvcLastChange INTEGER,
316 nSvcLastWarn INTEGER,
317 nSvcLastCrit INTEGER,
318 nSvcLastUnkn INTEGER,
319 nSvcOutput OCTET STRING,
320 nSvcPerfData OCTET STRING
323 nagiosSvcEventEntry OBJECT-TYPE
325 MAX-ACCESS not-accessible
328 "Table of Nagios service events."
329 INDEX { nSvcEventIndex }
330 ::= { nagiosSvcEventTable 1 }
332 nSvcEventIndex OBJECT-TYPE
333 SYNTAX Integer32 (1..65535)
334 MAX-ACCESS not-accessible
337 "This object uniquely identifies this service event entry"
338 ::= { nagiosSvcEventEntry 1 }
340 nSvcHostname OBJECT-TYPE
345 "Hostname as specified in the Nagios configuration file."
346 ::= { nagiosSvcEventEntry 2 }
348 nSvcHostAlias OBJECT-TYPE
353 "The host alias as specified in the Nagios configuration file"
354 ::= { nagiosSvcEventEntry 3 }
356 nSvcHostStateID OBJECT-TYPE
361 "A number that corresponds to the current state of the service: 0=OK,
362 1=WARNING, 2=CRITICAL, 3=UNKNOWN."
363 ::= { nagiosSvcEventEntry 4 }
365 nSvcHostStateType OBJECT-TYPE
370 "Whether the host is in a hard or soft state."
371 ::= { nagiosSvcEventEntry 5 }
378 "This value is taken from the description directive of the service
380 ::= { nagiosSvcEventEntry 6 }
382 nSvcStateID OBJECT-TYPE
383 SYNTAX ServiceStateID
387 " A number that corresponds to the current state of the service: 0=OK,
388 1=WARNING, 2=CRITICAL, 3=UNKNOWN"
389 ::= { nagiosSvcEventEntry 7 }
391 nSvcAttempt OBJECT-TYPE
396 "The number of the current service check retry. For instance, if this is
397 the second time that the service is being rechecked, this will be the
398 number two. Current attempt number is really only useful when writing
399 service event handlers for soft states that take a specific action based
400 on the service retry number."
401 ::= { nagiosSvcEventEntry 8 }
403 nSvcDurationSec OBJECT-TYPE
408 "A number indicating the number of seconds that the service has spent in
410 ::= { nagiosSvcEventEntry 9 }
412 nSvcGroupName OBJECT-TYPE
417 "The short name of the servicegroup that this service belongs to. This
418 value is taken from the servicegroup_name directive in the servicegroup
419 definition. If the service belongs to more than one servicegroup this
420 object will contain the name of just one of them."
421 ::= { nagiosSvcEventEntry 10 }
423 nSvcLastCheck OBJECT-TYPE
428 "This is a timestamp in time_t format (seconds since the UNIX epoch)
429 indicating the time at which a check of the service was last performed."
430 ::= { nagiosSvcEventEntry 11 }
432 nSvcLastChange OBJECT-TYPE
437 "This is a timestamp in time_t format (seconds since the UNIX epoch)
438 indicating the time the service last changed state."
439 ::= { nagiosSvcEventEntry 12 }
441 nSvcLastOK OBJECT-TYPE
446 "This is a timestamp in time_t format (seconds since the UNIX epoch)
447 indicating the time at which the service was last detected as being in an
449 ::= { nagiosSvcEventEntry 13 }
451 nSvcLastWarn OBJECT-TYPE
456 "This is a timestamp in time_t format (seconds since the UNIX epoch)
457 indicating the time at which the service was last detected as being in a
459 ::= { nagiosSvcEventEntry 14 }
461 nSvcLastCrit OBJECT-TYPE
466 "This is a timestamp in time_t format (seconds since the UNIX epoch)
467 indicating the time at which the service was last detected as being in a
469 ::= { nagiosSvcEventEntry 15 }
471 nSvcLastUnkn OBJECT-TYPE
476 "This is a timestamp in time_t format (seconds since the UNIX epoch)
477 indicating the time at which the service was last detected as being in an
479 ::= { nagiosSvcEventEntry 16 }
481 nSvcOutput OBJECT-TYPE
486 "The text output from the last service check (i.e. Ping OK)."
487 ::= { nagiosSvcEventEntry 17 }
489 nSvcPerfData OBJECT-TYPE
494 "This object contains any performance data that may have been returned by
495 the last service check."
496 ::= { nagiosSvcEventEntry 18 }
500 -- Service Notifications
503 nagiosSvcNotifyTable OBJECT-TYPE
504 SYNTAX SEQUENCE OF SvcNotifyEntry
505 MAX-ACCESS not-accessible
508 "Table of Nagios service notifications."
509 ::= { nagiosNotify 4 }
511 SvcNotifyEntry ::= SEQUENCE {
512 nSvcNotifyType NotifyType,
513 nSvcNotifyNum Gauge32, -- Integer32,
514 nSvcAckAuthor OCTET STRING,
515 nSvcAckComment OCTET STRING
518 nagiosSvcNotifyEntry OBJECT-TYPE
519 SYNTAX SvcNotifyEntry
520 MAX-ACCESS not-accessible
523 "Nagios service notifications extends the nagiosSvcEnevtsTable when
524 a notification is generated for an event."
525 INDEX { nSvcEventIndex }
526 ::= { nagiosSvcNotifyTable 1}
529 nSvcNotifyType OBJECT-TYPE
534 "A string identifying the type of notification that is being sent
535 (PROBLEM, RECOVERY, ACKNOWLEDGEMENT, FLAPPINGSTART or FLAPPINGSTOP)."
536 ::= { nagiosSvcNotifyEntry 1 }
538 nSvcNotifyNum OBJECT-TYPE
539 SYNTAX Gauge32 -- Integer32
543 "The current notification number for the service or host. The notification
544 number increases by one (1) each time a new notification is sent out for a
545 host or service (except for acknowledgements). The notification number is
546 reset to 0 when the host or service recovers (after the recovery
547 notification has gone out). Acknowledgements do not cause the notification
549 ::= { nagiosSvcNotifyEntry 2 }
551 nSvcAckAuthor OBJECT-TYPE
556 "A string containing the name of the user who acknowledged the service
557 problem. This object is only valid in notifications where the
558 nSvcNotifyType object is set to ACKNOWLEDGEMENT."
559 ::= { nagiosSvcNotifyEntry 3 }
561 nSvcAckComment OBJECT-TYPE
566 "A string containing the acknowledgement comment that was entered by the
567 user who acknowledged the service problem. This object is only valid in
568 notifications where the nSvcNotifyType object is set to ACKNOWLEDGEMENT."
569 ::= { nagiosSvcNotifyEntry 4 }
573 -- Events and Notifications
576 nHostEvent NOTIFICATION-TYPE
577 OBJECTS { nHostname, nHostStateID, nHostStateType, nHostAttempt,
578 nHostDurationSec, nHostGroupName, nHostLastCheck, nHostLastChange,
582 "The SNMP trap that is generated as a result of an event with the host
585 ::= { nagiosNotify 5 }
587 nHostNotify NOTIFICATION-TYPE
588 OBJECTS { nHostNotifyType, nHostNotifyNum, nHostAckAuthor, nHostAckComment,
589 nHostname, nHostStateID, nHostStateType, nHostAttempt,
590 nHostDurationSec, nHostGroupName, nHostLastCheck, nHostLastChange,
594 "The SNMP trap that is generated as a result of an event requiring
595 notification for a host in Nagios."
596 ::= { nagiosNotify 6 }
598 nSvcEvent NOTIFICATION-TYPE
599 OBJECTS { nHostname, nHostStateID, nSvcDesc, nSvcStateID, nSvcAttempt,
600 nSvcDurationSec, nSvcGroupName, nSvcLastCheck, nSvcLastChange,
604 "The SNMP trap that is generated as a result of an event with the service
606 ::= { nagiosNotify 7 }
608 nSvcNotify NOTIFICATION-TYPE
609 OBJECTS { nSvcNotifyType, nSvcNotifyNum, nSvcAckAuthor, nSvcAckComment,
610 nHostname, nHostStateID, nSvcDesc, nSvcStateID, nSvcAttempt,
611 nSvcDurationSec, nSvcGroupName, nSvcLastCheck, nSvcLastChange,
615 "The SNMP trap that is generated as a result of an event requiring
616 notification for a service in Nagios."
617 ::= { nagiosNotify 8 }