SNMP Agent

Big Sister as an SNMP trap source

Since version 0.38 Big Sister includes support for sending SNMP traps.

Traps may be sent on the following occasions:

- alarm raised by bb_event_generator - alarm cleared - reminder sent by bb_event_generator - alarm acknowledgement received

Big Sister will (try) to act as an SNMP proxy, the agent reported is usually the IP address of the host associated with the service. If this IP address is not determinable then the agent is reported to be the system on which the SNMP trap is generated.

As of rev 0.99c3 Big Sister also supports sending traps on status changes. Please have a look at the StatusTrap configuration option in bb-display.cfg.

MIB

BIGSISTER-MIB DEFINITIONS ::= BEGIN

IMPORTS
        enterprises
                FROM RFC1155-SMI

        TRAP-TYPE
                FROM RFC-1215

        OBJECT-TYPE
                FROM RFC-1212;


-- Graeffet Communications and Big Sister enterprise OID
graeff          OBJECT IDENTIFIER ::= { enterprises 5281 }

bigsister       OBJECT IDENTIFIER ::= { graeff 1 }


-- object types used in Big Sister traps
-- note that Big Sister will always sort bindings
-- by object type, variables with lower object
-- type will always appear first in the bindings

bstrapinfo      OBJECT IDENTIFIER ::= { bigsister 1 }

bshost  OBJECT-TYPE
                SYNTAX          OCTET STRING
                ACCESS          not-accessible
                STATUS          mandatory
                DESCRIPTION
                        "The name of the monitored host as
                         reported by the Big Sister agent"
                ::= { bstrapinfo 1 }


bsservice OBJECT-TYPE
                SYNTAX          OCTET STRING
                ACCESS          not-accessible
                STATUS          mandatory
                DESCRIPTION
                        "The name of the monitored service"
                ::= { bstrapinfo 2 }

bsstatus OBJECT-TYPE
                SYNTAX          OCTET-STRING
                ACCESS          not-accessible
                STATUS          optional
                DESCRIPTION
                        "The service's status code"
                ::= { bstrapinfo 3 }

bscomment OBJECT-TYPE
                SYNTAX          OCTET-STRING
                ACCESS          not-accessible
                STATUS          optional
                DESCRIPTION
                        "The text reported by the Big Sister
                         agent associated with this event"
                ::= { bstrapinfo 4 }

bsseverity OBJECT-TYPE
                SYNTAX          INTEGER (0..100)
                ACCESS          not-accessible
                STATUS          optional
                DESCRIPTION
                        "This event's severity, 100 for
                         maximum severity"
                ::= { bstrapinfo 5 }

bsackmode OBJECT-TYPE
                SYNTAX          OCTET-STRING
                ACCESS          not-accessible
                STATUS          optional
                DESCRIPTION
                        "In alarm acknowledge events this represents
                         the type of acknowledgement"
                ::= { bstrapinfo 6 }

bsackuser OBJECT-TYPE
                SYNTAX          OCTET-STRING
                ACCESS          not-accessible
                STATUS          optional
                DESCRIPTION
                        "In alarm acknowledge events this represents
                         the name of the acknowledging user"
                ::= { bstrapinfo 7 }


-- Trap types

bsstatuschange TRAP-TYPE
                ENTERPRISE      graeff
                VARIABLES
                        {
                        bshost, bsservice,
                        bsstatus, bscomment
                        }
                DESCRIPTION
                        "This trap will be generated on status changes
                         of any monitored service"
                ::= 1

bsserviceup TRAP-TYPE
                ENTERPRISE      graeff
                VARIABLES
                        {
                        bshost, bsservice,
                        bsstatus, bscomment,
                        bsseverity
                        }
                DESCRIPTION
                        "This trap will be generated by bb_event_generator
                         whenever a service up alarm is raised"
                ::= 2

bsservicedown TRAP-TYPE
                ENTERPRISE      graeff
                VARIABLES
                        {
                        bshost, bsservice,
                        bsstatus, bscomment,
                        bsseverity
                        }
                DESCRIPTION
                        "This trap will be generated by bb_event_generator
                         whenever a service down alarm is raised"
                ::= 3

bsalarmack TRAP-TYPE
                ENTERPRISE      graeff
                VARIABLES
                        {
                        bshost, bsservice,
                        bscomment,
                        bsackmode, bsackuser
                        }
                DESCRIPTION
                        "This trap will be generated by bb_event_generator
                         whenever an alarm acknowledgement is seen"
                ::= 4

bsremind TRAP-TYPE
                ENTERPRISE      graeff
                VARIABLES
                        {
                        bshost, bsservice,
                        bsstatus, bscomment,
                        bsseverity
                        }
                DESCRIPTION
                        "This trap will be generated by bb_event_generator
                         whenever a repeated alarm - aka reminder - is raised"
                ::= 5

END