NotifyType set to Gauge32, instead of Integer32, for host and service notifications...
[nagiosmib.git] / MIB / NAGIOS-NOTIFY-MIB
blob03b4c077a91e979b139f3e7a4fe76dc0da0ed905
1 NAGIOS-NOTIFY-MIB DEFINITIONS ::= BEGIN
2   IMPORTS
3     MODULE-IDENTITY, OBJECT-TYPE,  NOTIFICATION-TYPE,
4     Integer32, Gauge32
5       FROM SNMPv2-SMI
6     nagios,NotifyType,HostStateID,HostStateType,ServiceStateID
7       FROM NAGIOS-ROOT-MIB;
9 nagiosNotify MODULE-IDENTITY
10   LAST-UPDATED "200503090000Z" -- March 9, 2005
11   ORGANIZATION "Nagios"
12   CONTACT-INFO
13       " Subhendu Ghosh
14       
15       Telephone: +1 201 232 2851
16       Email: sghosh@users.sourceforge.net
18       Nagios Information:
19         http://www.nagios.org
20       "
21   DESCRIPTION
22       "Objects for Nagios(tm) events.  There are 2 primary tables
23       reflecting the division in Nagios for Host events and
24       Service events.
26       The event tables are extended by the HostNotifyTable and the 
27       ServiceNotifyTable to keep track of the notifications based on events.
28       
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
33       "
34   REVISION "200503090000Z" -- March 9, 2005
35   DESCRIPTION
36        "Spell check"
37   REVISION "200501200000Z" --January 20, 2005
38   DESCRIPTION
39       "Initial Version"
40         ::= { nagios 1 }
43 nagiosHostEventTable OBJECT-TYPE 
44   SYNTAX      SEQUENCE OF HostEventEntry
45   MAX-ACCESS  not-accessible
46   STATUS      current
47   DESCRIPTION
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,
62   nHostLastUp        INTEGER,
63   nHostLastDown      INTEGER,
64   nHostLastUnreachable INTEGER,
65   nHostOutput        OCTET STRING,
66   nHostPerfData      OCTET STRING
67   }
68   
69 nagiosHostEventEntry  OBJECT-TYPE
70   SYNTAX      HostEventEntry
71   MAX-ACCESS  not-accessible
72   STATUS      current
73   DESCRIPTION
74     "Each notification event"
75   INDEX { nHostEventIndex }
76   ::= { nagiosHostEventTable 1 }
77   
78 nHostEventIndex OBJECT-TYPE
79   SYNTAX     Integer32 (1..65535)
80   MAX-ACCESS not-accessible
81   STATUS     current
82   DESCRIPTION 
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 }
87 nHostname    OBJECT-TYPE
88   SYNTAX     OCTET STRING
89   MAX-ACCESS read-only
90   STATUS     current
91   DESCRIPTION 
92     "Hostname as specified in the Nagios configuration file."
93   ::= { nagiosHostEventEntry 2 }
95 nHostAlias   OBJECT-TYPE
96   SYNTAX     OCTET STRING
97   MAX-ACCESS read-only
98   STATUS     current
99   DESCRIPTION
100     "The host alias as specified in the Nagios configuration file"
101   ::= { nagiosHostEventEntry 3 }
102   
103 nHostStateID OBJECT-TYPE
104   SYNTAX     HostStateID
105   MAX-ACCESS read-only
106   STATUS     current
107   DESCRIPTION
108     "The host state as defined by the HOSTSTATEID macro"
109   ::= { nagiosHostEventEntry 4 }
111 nHostStateType  OBJECT-TYPE
112   SYNTAX     HostStateType
113   MAX-ACCESS read-only
114   STATUS     current
115   DESCRIPTION
116     "The host state as defined by the HOSTSTATETYPE macro"
117   ::= { nagiosHostEventEntry 5 }
118   
119 nHostAttempt  OBJECT-TYPE
120   SYNTAX     Integer32
121   MAX-ACCESS read-only
122   STATUS     current
123   DESCRIPTION
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
132   SYNTAX     Integer32
133   MAX-ACCESS read-only
134   STATUS     current
135   DESCRIPTION
136    "A number indicating the number of seconds that the host has spent in its 
137    current state"
138   ::= { nagiosHostEventEntry 7 }
139   
140 nHostGroupName   OBJECT-TYPE
141   SYNTAX     OCTET STRING
142   MAX-ACCESS read-only
143   STATUS     current
144   DESCRIPTION
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
148     just one of them."
149   ::= { nagiosHostEventEntry 8 }
150   
151 nHostLastCheck  OBJECT-TYPE
152   SYNTAX     INTEGER
153   MAX-ACCESS read-only
154   STATUS     current
155   DESCRIPTION
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
161   SYNTAX     INTEGER
162   MAX-ACCESS read-only
163   STATUS     current
164   DESCRIPTION
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
170   SYNTAX     INTEGER
171   MAX-ACCESS read-only
172   STATUS     current
173   DESCRIPTION
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
176     state."
177   ::= { nagiosHostEventEntry 11 }
178   
179 nHostLastDown OBJECT-TYPE
180   SYNTAX     INTEGER
181   MAX-ACCESS read-only
182   STATUS     current
183   DESCRIPTION
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
186     DOWN state."
187   ::= { nagiosHostEventEntry 12 }
189 nHostLastUnreachable OBJECT-TYPE
190   SYNTAX     INTEGER
191   MAX-ACCESS read-only
192   STATUS     current
193   DESCRIPTION
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
196     UNREACHABLE state."
197   ::= { nagiosHostEventEntry 13 }
198   
199 nHostOutput  OBJECT-TYPE
200   SYNTAX     OCTET STRING
201   MAX-ACCESS read-only
202   STATUS     current
203   DESCRIPTION
204     "The text output from the last host check (i.e. Ping OK)."
205   ::= { nagiosHostEventEntry 14 }
207 nHostPerfData OBJECT-TYPE
208   SYNTAX     OCTET STRING
209   MAX-ACCESS read-only
210   STATUS     current
211   DESCRIPTION
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
224   STATUS      current
225   DESCRIPTION
226     "Table of Nagios host notifications"
227   ::= {nagiosNotify 2}
229 HostNotifyEntry ::= SEQUENCE {
230   nHostNotifyType    NotifyType,
231   nHostNotifyNum     Gauge32,    -- was Integer32,
232   nHostAckAuthor     OCTET STRING,
233   nHostAckComment    OCTET STRING
234   }
236 nagiosHostNotifyEntry  OBJECT-TYPE
237   SYNTAX      HostNotifyEntry
238   MAX-ACCESS  not-accessible
239   STATUS      current
240   DESCRIPTION
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
247   SYNTAX     NotifyType
248   MAX-ACCESS read-only
249   STATUS     current
250   DESCRIPTION 
251     "This identifies the type of notification that is being sent
252     (PROBLEM, RECOVERY, ACKNOWLEDGEMENT, FLAPPINGSTART or FLAPPINGSTOP)"
253   ::= { nagiosHostNotifyEntry 1 }
254   
255 nHostNotifyNum OBJECT-TYPE
256   SYNTAX     Gauge32    -- was NotifyType
257   MAX-ACCESS read-only
258   STATUS     current
259   DESCRIPTION 
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
269   SYNTAX     OCTET STRING
270   MAX-ACCESS read-only
271   STATUS     current
272   DESCRIPTION
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 } 
277   
278 nHostAckComment   OBJECT-TYPE
279   SYNTAX     OCTET STRING
280   MAX-ACCESS read-only
281   STATUS     current
282   DESCRIPTION
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 } 
289 -- 
290 -- Service Events 
291 -- 
294 nagiosSvcEventTable OBJECT-TYPE
295   SYNTAX      SEQUENCE OF SvcEventEntry
296   MAX-ACCESS  not-accessible
297   STATUS      current
298   DESCRIPTION
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,
315   nSvcLastOK        INTEGER,
316   nSvcLastWarn      INTEGER,
317   nSvcLastCrit      INTEGER,
318   nSvcLastUnkn      INTEGER,
319   nSvcOutput        OCTET STRING,
320   nSvcPerfData      OCTET STRING
321   }
323 nagiosSvcEventEntry OBJECT-TYPE
324   SYNTAX        SvcEventEntry
325   MAX-ACCESS    not-accessible
326   STATUS        current
327   DESCRIPTION
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
335   STATUS       current
336   DESCRIPTION
337    "This object uniquely identifies this service event entry"
338   ::= { nagiosSvcEventEntry 1 }
339   
340 nSvcHostname      OBJECT-TYPE
341   SYNTAX          OCTET STRING
342   MAX-ACCESS      read-only
343   STATUS          current
344   DESCRIPTION
345     "Hostname as specified in the Nagios configuration file."
346   ::= { nagiosSvcEventEntry 2 }
348 nSvcHostAlias     OBJECT-TYPE
349   SYNTAX          OCTET STRING
350   MAX-ACCESS      read-only
351   STATUS          current
352   DESCRIPTION
353     "The host alias as specified in the Nagios configuration file"
354   ::= { nagiosSvcEventEntry 3 }
355   
356 nSvcHostStateID   OBJECT-TYPE
357   SYNTAX          HostStateID
358   MAX-ACCESS      read-only
359   STATUS          current
360   DESCRIPTION
361     "A number that corresponds to the current state of the service: 0=OK,
362     1=WARNING, 2=CRITICAL, 3=UNKNOWN."
363   ::= { nagiosSvcEventEntry 4 }
364   
365 nSvcHostStateType OBJECT-TYPE 
366   SYNTAX          HostStateType
367   MAX-ACCESS      read-only
368   STATUS          current
369   DESCRIPTION
370     "Whether the host is in a hard or soft state."
371   ::= { nagiosSvcEventEntry 5 }
372   
373 nSvcDesc          OBJECT-TYPE
374   SYNTAX          OCTET STRING
375   MAX-ACCESS      read-only
376   STATUS          current
377   DESCRIPTION
378     "This value is taken from the description directive of the service
379     definition."
380   ::= { nagiosSvcEventEntry 6 }
382 nSvcStateID       OBJECT-TYPE
383   SYNTAX          ServiceStateID
384   MAX-ACCESS      read-only
385   STATUS          current
386   DESCRIPTION
387     " A number that corresponds to the current state of the service: 0=OK,
388     1=WARNING, 2=CRITICAL, 3=UNKNOWN"
389   ::= {  nagiosSvcEventEntry 7 }
390   
391 nSvcAttempt       OBJECT-TYPE
392   SYNTAX          Integer32
393   MAX-ACCESS      read-only
394   STATUS          current
395   DESCRIPTION
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
404   SYNTAX          Integer32
405   MAX-ACCESS      read-only
406   STATUS          current
407   DESCRIPTION
408     "A number indicating the number of seconds that the service has spent in
409     its current state."
410   ::= { nagiosSvcEventEntry 9 }
412 nSvcGroupName     OBJECT-TYPE
413   SYNTAX          OCTET STRING
414   MAX-ACCESS      read-only
415   STATUS          current
416   DESCRIPTION
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
424   SYNTAX          INTEGER
425   MAX-ACCESS      read-only
426   STATUS          current
427   DESCRIPTION
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
433   SYNTAX          INTEGER
434   MAX-ACCESS      read-only
435   STATUS          current
436   DESCRIPTION
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
442   SYNTAX          INTEGER
443   MAX-ACCESS      read-only
444   STATUS          current
445   DESCRIPTION
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
448     OK state."
449   ::= { nagiosSvcEventEntry 13 }
451 nSvcLastWarn      OBJECT-TYPE
452   SYNTAX          INTEGER
453   MAX-ACCESS      read-only
454   STATUS          current
455   DESCRIPTION
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
458     WARNING state."
459   ::= { nagiosSvcEventEntry 14 }
461 nSvcLastCrit      OBJECT-TYPE
462   SYNTAX          INTEGER
463   MAX-ACCESS      read-only
464   STATUS          current
465   DESCRIPTION
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
468     CRITICAL state."
469   ::= { nagiosSvcEventEntry 15 }
471 nSvcLastUnkn      OBJECT-TYPE
472   SYNTAX          INTEGER
473   MAX-ACCESS      read-only
474   STATUS          current
475   DESCRIPTION
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
478     UNKNOWN state."
479   ::= { nagiosSvcEventEntry 16 }
480   
481 nSvcOutput        OBJECT-TYPE
482   SYNTAX          OCTET STRING
483   MAX-ACCESS      read-only
484   STATUS          current
485   DESCRIPTION
486     "The text output from the last service check (i.e. Ping OK)."
487   ::= { nagiosSvcEventEntry 17 }
489 nSvcPerfData      OBJECT-TYPE
490   SYNTAX          OCTET STRING
491   MAX-ACCESS      read-only
492   STATUS          current
493   DESCRIPTION
494     "This object contains any performance data that may have been returned by
495     the last service check."
496   ::= { nagiosSvcEventEntry 18 }
499 -- 
500 -- Service Notifications
501 -- 
503 nagiosSvcNotifyTable OBJECT-TYPE
504   SYNTAX       SEQUENCE OF SvcNotifyEntry
505   MAX-ACCESS   not-accessible
506   STATUS       current
507   DESCRIPTION
508     "Table of Nagios service notifications."
509   ::= { nagiosNotify 4 }
510   
511 SvcNotifyEntry ::= SEQUENCE {
512   nSvcNotifyType    NotifyType,
513   nSvcNotifyNum     Gauge32,    -- Integer32,
514   nSvcAckAuthor     OCTET STRING,
515   nSvcAckComment    OCTET STRING
516   }
518 nagiosSvcNotifyEntry OBJECT-TYPE
519   SYNTAX       SvcNotifyEntry
520   MAX-ACCESS   not-accessible
521   STATUS       current
522   DESCRIPTION
523     "Nagios service notifications extends the nagiosSvcEnevtsTable when
524     a notification is generated for an event."
525   INDEX { nSvcEventIndex }
526   ::= { nagiosSvcNotifyTable 1}
527   
528   
529 nSvcNotifyType OBJECT-TYPE
530   SYNTAX       NotifyType
531   MAX-ACCESS   read-only
532   STATUS       current
533   DESCRIPTION
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
540   MAX-ACCESS   read-only
541   STATUS       current
542   DESCRIPTION
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
548     number to increase."
549   ::= { nagiosSvcNotifyEntry 2 }
551 nSvcAckAuthor  OBJECT-TYPE
552   SYNTAX       OCTET STRING
553   MAX-ACCESS   read-only
554   STATUS       current
555   DESCRIPTION
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
562   SYNTAX       OCTET STRING
563   MAX-ACCESS   read-only
564   STATUS       current
565   DESCRIPTION
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 }
570     
573 -- Events and Notifications
576 nHostEvent  NOTIFICATION-TYPE
577   OBJECTS { nHostname, nHostStateID, nHostStateType, nHostAttempt,
578             nHostDurationSec, nHostGroupName, nHostLastCheck, nHostLastChange, 
579             nHostOutput }
580   STATUS  current
581   DESCRIPTION
582     "The SNMP trap that is generated as a result of an event with the host
583     in Nagios."
585   ::= { nagiosNotify 5 }
587 nHostNotify NOTIFICATION-TYPE
588   OBJECTS { nHostNotifyType, nHostNotifyNum, nHostAckAuthor, nHostAckComment,
589             nHostname, nHostStateID, nHostStateType, nHostAttempt,
590             nHostDurationSec, nHostGroupName, nHostLastCheck, nHostLastChange,
591             nHostOutput  }
592   STATUS  current
593   DESCRIPTION
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,
601             nSvcOutput }
602   STATUS  current
603   DESCRIPTION
604     "The SNMP trap that is generated as a result of an event with the service
605     in Nagios."
606   ::= { nagiosNotify 7 }
608 nSvcNotify NOTIFICATION-TYPE
609   OBJECTS { nSvcNotifyType, nSvcNotifyNum, nSvcAckAuthor, nSvcAckComment,
610             nHostname, nHostStateID, nSvcDesc, nSvcStateID, nSvcAttempt,
611             nSvcDurationSec, nSvcGroupName, nSvcLastCheck, nSvcLastChange,
612             nSvcOutput }
613   STATUS  current
614   DESCRIPTION
615     "The SNMP trap that is generated as a result of an event requiring
616     notification for a service in Nagios."
617   ::= { nagiosNotify 8 }