ZENOSS-IMPACT-MIB DEFINITIONS ::= BEGIN

IMPORTS
    enterprises, Gauge32, MODULE-IDENTITY,
    Unsigned32, NOTIFICATION-TYPE, OBJECT-TYPE        FROM SNMPv2-SMI
    DateAndTime, TEXTUAL-CONVENTION                   FROM SNMPv2-TC
    MODULE-COMPLIANCE, NOTIFICATION-GROUP,
    OBJECT-GROUP                                      FROM SNMPv2-CONF
    zen, ZenUUID, ZenEventStatus, ZenEventSeverity    FROM ZENOSS-MIB;

zenossImpactMIB MODULE-IDENTITY
    LAST-UPDATED    "201306040000Z"
    ORGANIZATION    "Zenoss, Inc."
    CONTACT-INFO    "support@zenoss.com"
    DESCRIPTION
        "This module defines notifications, objects and conformance related to
         the Zenoss Impact product."
    REVISION        "201306040000Z"
    DESCRIPTION
        "Second revision."
    ::= { zen 2 }

--
-- top-level MIB branches
--
zenImpactNotifications         OBJECT IDENTIFIER ::= { zenossImpactMIB 0 }
zenImpactObjects               OBJECT IDENTIFIER ::= { zenossImpactMIB 1 }
zenImpactNotificationsObjects  OBJECT IDENTIFIER ::= { zenImpactObjects 1 }

--
-- objects
--

zenImpactUUID OBJECT-TYPE
    SYNTAX      ZenUUID
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "UUID of impact event summary. See ZenUUID textual convention for
         formatting details."
    ::= { zenImpactNotificationsObjects 1 }

zenImpactServiceName OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Name of impacted service."
    ::= { zenImpactNotificationsObjects 2 }

zenImpactServiceState OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "New state of impacted service. This is a string representation
         instead of an enumeration because impact states are not static.

         Standard availability states are UP, ATRISK, DEGRADED and DOWN.

         Standard performance states are ACCEPTABLE, DEGRADED, UNACCEPTABLE."
    ::= { zenImpactNotificationsObjects 3 }

zenImpactStatus OBJECT-TYPE
    SYNTAX      ZenEventStatus
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Status of service impact event. See ZenEventStatus textual convention
         for possible values."
    ::= { zenImpactNotificationsObjects 4 }

zenImpactSeverity OBJECT-TYPE
    SYNTAX      ZenEventSeverity
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Severity of service impact event. See ZenEventSeverity textual
         convention for possible values."
    ::= { zenImpactNotificationsObjects 5 }

zenImpactClass OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Event class of service impact event."
    ::= { zenImpactNotificationsObjects 6 }

zenImpactSummary OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Summary of service impact event."
    ::= { zenImpactNotificationsObjects 7 }

zenImpactLastStatusChange OBJECT-TYPE
    SYNTAX      DateAndTime
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Timestamp of last zenImpactStatus change for this service impact
         event. See DateAndTime textual convention for format details."
    ::= { zenImpactNotificationsObjects 8 }

zenImpactFirstOccurrence OBJECT-TYPE
    SYNTAX      DateAndTime
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Timestamp of first occurrence of this service impact event. See
         DateAndTime textual convention for format details."
    ::= { zenImpactNotificationsObjects 9 }

zenImpactLastOccurrence OBJECT-TYPE
    SYNTAX      DateAndTime
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Timestamp of most recent occurrence of this service impact event. See
         DateAndTime textual convention for format details."
    ::= { zenImpactNotificationsObjects 10 }

zenImpactCount OBJECT-TYPE
    SYNTAX      Gauge32 (1..4294967295)
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Count of occurences for this service impact event that occurred
         within zenImpactFirstOccurrence and zenImpactLastOccurrence
         inclusively."
    ::= { zenImpactNotificationsObjects 11 }

zenImpactURL OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "HTTP URL that will navigate directly to this impact event's details.
         Authentication will be required."
    ::= { zenImpactNotificationsObjects 12 }

zenImpactRootCauseTotal OBJECT-TYPE
    SYNTAX      Gauge32
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Total number of root cause events related to this service impact.
         Some details about these root cause events will be included in the
         notification.

         The top 2 (at most) root cause events ranked by confidence will
         include the following objects with indexes of 1 and 2:

            zenImpactRootCauseUUID
            zenImpactRootCauseConfidence
            zenImpactRootCauseImpactChain
            zenImpactRootCauseResourceName
            zenImpactRootCauseResourceClass
            zenImpactRootCauseComponentName
            zenImpactRootCauseStatus
            zenImpactRootCauseSeverity
            zenImpactRootCauseClass
            zenImpactRootCauseSummary

         The next 8 (at most) root cause events ranked by confidence will
         include only the following objects with indexes of 3-8:

            zenImpactRootCauseUUID
            zenImpactRootCauseConfidence

         In the case that more than 10 root cause events exist for a given
         service impact, the Zenoss API can be used to find the full list by
         querying the related events router with zenImpactUUID."
    ::= { zenImpactNotificationsObjects 100 }

-- minimal root cause details.

zenImpactRootCauseUUID OBJECT-TYPE
    SYNTAX      ZenUUID
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "UUID of root cause event summary. See ZenUUID textual convention for
         formatting details."
    ::= { zenImpactNotificationsObjects 101  }

zenImpactRootCauseConfidence OBJECT-TYPE
    SYNTAX      Gauge32 (1..99)
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Weight (1-99) confidence that this event is the root cause. A higher
         confidence value indicates higher confidence."
    ::= { zenImpactNotificationsObjects 102 }

-- complete root cause details.

zenImpactRootCauseImpactChain OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "String representation of impact chain for this root cause.

         Example: chassis -> blade -> host -> VM -> OS -> application"
    ::= { zenImpactNotificationsObjects 103 }

zenImpactRootCauseResourceName OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Name of resource (typically a device) attributed to root cause
         event."
    ::= { zenImpactNotificationsObjects 104 }

zenImpactRootCauseResourceClass OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Resource class (typically device class) of
         zenImpactRootCauseResourceName."
    ::= { zenImpactNotificationsObjects 105 }

zenImpactRootCauseComponentName OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Name of component on zenImpactRootCauseResourceName attributed to
         root cause event. Commonly an empty string if the root cause event is
         attributed directly to the resource and component-specificity isn't
         applicable."
    ::= { zenImpactNotificationsObjects 106 }

zenImpactRootCauseStatus OBJECT-TYPE
    SYNTAX      ZenEventStatus
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Status of root cause event. See ZenEventStatus textual convention for
         possible values."
    ::= { zenImpactNotificationsObjects 107 }

zenImpactRootCauseSeverity OBJECT-TYPE
    SYNTAX      ZenEventSeverity
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Severity of root cause event. See ZenEventSeverity textual convention
         for possible values."
    ::= { zenImpactNotificationsObjects 108 }

zenImpactRootCauseClass OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Event class of root cause event."
    ::= { zenImpactNotificationsObjects 109 }

zenImpactRootCauseSummary OBJECT-TYPE
    SYNTAX      OCTET STRING
    MAX-ACCESS  accessible-for-notify
    STATUS      current
    DESCRIPTION
        "Summary of root cause event."
    ::= { zenImpactNotificationsObjects 110 }


--
-- notifications
--

zenImpactTrap NOTIFICATION-TYPE
    OBJECTS {
        zenImpactUUID,
        zenImpactServiceName,
        zenImpactServiceState,
        zenImpactStatus,
        zenImpactSeverity,
        zenImpactClass,
        zenImpactSummary,
        zenImpactLastStatusChange,
        zenImpactFirstOccurrence,
        zenImpactLastOccurrence,
        zenImpactCount,
        zenImpactURL,
        zenImpactRootCauseTotal,
        zenImpactRootCauseUUID,
        zenImpactRootCauseConfidence,
        zenImpactRootCauseImpactChain,
        zenImpactRootCauseResourceName,
        zenImpactRootCauseResourceClass,
        zenImpactRootCauseComponentName,
        zenImpactRootCauseStatus,
        zenImpactRootCauseSeverity,
        zenImpactRootCauseClass,
        zenImpactRootCauseSummary
    }
    STATUS      current
    DESCRIPTION
        "Notification sent when a new service impact event occurs. Depending
         on how notifications are configured in the source system this
         notification could also be sent when a status change occurs on an
         existing service impact event, and when the service impact clears."
    ::= { zenImpactNotifications 1 }


--
-- conformance and compliance
--

zenImpactConformance   OBJECT IDENTIFIER ::= { zenossImpactMIB 2 }
zenImpactCompliances   OBJECT IDENTIFIER ::= { zenImpactConformance 1 }
zenImpactGroups        OBJECT IDENTIFIER ::= { zenImpactConformance 2 }

-- compliance

zenImpactMIBCompliance MODULE-COMPLIANCE
    STATUS      current
    DESCRIPTION
        "MIB compliance."
    MODULE
        MANDATORY-GROUPS {
            zenImpactTrapObjectsGroup,
            zenImpactNotificationsGroup
        }
    ::= { zenImpactCompliances 1 }

-- groups

zenImpactTrapObjectsGroup OBJECT-GROUP
    OBJECTS {
        zenImpactUUID,
        zenImpactServiceName,
        zenImpactServiceState,
        zenImpactStatus,
        zenImpactSeverity,
        zenImpactClass,
        zenImpactSummary,
        zenImpactLastStatusChange,
        zenImpactFirstOccurrence,
        zenImpactLastOccurrence,
        zenImpactCount,
        zenImpactURL,
        zenImpactRootCauseTotal,
        zenImpactRootCauseUUID,
        zenImpactRootCauseConfidence,
        zenImpactRootCauseImpactChain,
        zenImpactRootCauseResourceName,
        zenImpactRootCauseResourceClass,
        zenImpactRootCauseComponentName,
        zenImpactRootCauseStatus,
        zenImpactRootCauseSeverity,
        zenImpactRootCauseClass,
        zenImpactRootCauseSummary
    }
    STATUS      current
    DESCRIPTION
        "Objects included in zenImpactTrap notification variable bindings."
    ::= { zenImpactGroups 1 }

zenImpactNotificationsGroup NOTIFICATION-GROUP
    NOTIFICATIONS {
        zenImpactTrap
    }
    STATUS      current
    DESCRIPTION
        "All zenossImpactMIB notifications."
    ::= { zenImpactGroups 2 }

END