CISCO-SYSLOG-MIB-V1SMI.my

-- MIB file created 02-May-2006 15:23:07, by
--   SMICng version 2.2.11-beta(PRO)(Solaris), January 20, 2001. Enterprise key cisco.com

CISCO-SYSLOG-MIB DEFINITIONS ::= BEGIN

-- From file: "CISCO-SYSLOG-MIB.my"
-- Compile options "4 7 F H N O W 03 06 0B 0G 0N 0T"

IMPORTS
    DisplayString, TimeStamp, TruthValue, RowStatus
            FROM SNMPv2-TC-v1
    SnmpAdminString
            FROM SNMP-FRAMEWORK-MIB
    ciscoMgmt
            FROM CISCO-SMI
    InetAddress, InetAddressType
            FROM INET-ADDRESS-MIB
    Counter, Gauge
            FROM RFC1155-SMI
    OBJECT-TYPE
            FROM RFC-1212
    TRAP-TYPE
            FROM RFC-1215;

ciscoSyslogMIB OBJECT IDENTIFIER ::= { ciscoMgmt 41 }
-- MODULE-IDENTITY
--  LastUpdated
--    200512030000Z
--  OrgName
--    Cisco Systems, Inc.
--  ContactInfo
--           Cisco Systems
--            Customer Service
--    
--    Postal: 170 W Tasman Drive
--            San Jose, CA  95134
--            USA
--    
--       Tel: +1 800 553-NETS
--    
--    E-mail: cs-snmp@cisco.com
--  Descr
--    The MIB module to describe and store the system
--     messages generated by the IOS and any other
--     OS which supports syslogs.
--  RevDate
--    200512030000Z
--  RevDescr
--    Removed UNITS clause for clogOriginIDType
--    as UNITS clause is not applicable.
--  RevDate
--    200508110000Z
--  RevDescr
--    Added following objects:
--       clogOriginIDType
--       clogOriginID
--  RevDate
--    200506010000Z
--  RevDescr
--    Added clogServerGroup.
--  RevDate
--    9508070000Z
--  RevDescr
--    Initial version of this MIB module.

ciscoSyslogMIBObjects OBJECT IDENTIFIER ::= { ciscoSyslogMIB 1 }
clogBasic       OBJECT IDENTIFIER ::= { ciscoSyslogMIBObjects 1 }
clogHistory     OBJECT IDENTIFIER ::= { ciscoSyslogMIBObjects 2 }
clogServer      OBJECT IDENTIFIER ::= { ciscoSyslogMIBObjects 3 }
ciscoSyslogMIBNotificationPrefix OBJECT IDENTIFIER ::= { ciscoSyslogMIB 2 }
ciscoSyslogMIBNotifications OBJECT IDENTIFIER ::= { ciscoSyslogMIBNotificationPrefix 0 }
ciscoSyslogMIBConformance OBJECT IDENTIFIER ::= { ciscoSyslogMIB 3 }
ciscoSyslogMIBCompliances OBJECT IDENTIFIER ::= { ciscoSyslogMIBConformance 1 }
ciscoSyslogMIBGroups OBJECT IDENTIFIER ::= { ciscoSyslogMIBConformance 2 }

SyslogSeverity ::= INTEGER {
        emergency(1),
        alert(2),
        critical(3),
        error(4),
        warning(5),
        notice(6),
        info(7),
        debug(8)
        }
-- TEXTUAL-CONVENTION
--  Status
--    mandatory
--  Descr
--    The severity of a syslog message.  The enumeration
--     values are equal to the values that syslog uses + 1.
--     For example, with syslog, emergency=0.
--    
--      'emergency' : system is unusable
--      'alert'     : action must be taken immediately
--      'critical'  : critical conditions
--      'error'     : error conditions
--      'warning'   : warning conditions
--      'notice'    : normal but significant condition
--      'informational': informational messages 
--      'debug'        : debug-level messages.
--  Refer
--    RFC 3164, Section 4.1 - syslog Message Parts

clogNotificationsSent OBJECT-TYPE
    SYNTAX Counter
--  Units
--    notifications
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The number of clogMessageGenerated notifications that
         have been sent. This number may include notifications
         that were prevented from being transmitted due to
         reasons such as resource limitations and/or
         non-connectivity.  If one is receiving notifications,
         one can periodically poll this object to determine if
         any notifications were missed.  If so, a poll of the
         clogHistoryTable might be appropriate."
    ::= { clogBasic 1 }

clogNotificationsEnabled OBJECT-TYPE
    SYNTAX TruthValue
--    Rsyntax INTEGER {
--        true(1),
--        false(2)
--        }
    ACCESS read-write
    STATUS mandatory
    DESCRIPTION
        "Indicates whether clogMessageGenerated notifications
         will or will not be sent when a syslog message is
         generated by the device.  Disabling notifications
         does not prevent syslog messages from being added
         to the clogHistoryTable."
    DEFVAL { false }
    ::= { clogBasic 2 }

clogMaxSeverity OBJECT-TYPE
    SYNTAX SyslogSeverity
--    Rsyntax INTEGER {
--        emergency(1),
--        alert(2),
--        critical(3),
--        error(4),
--        warning(5),
--        notice(6),
--        info(7),
--        debug(8)
--        }
    ACCESS read-write
    STATUS mandatory
    DESCRIPTION
        "Indicates which syslog severity levels will be
         processed.  Any syslog message with a severity value
         greater than this value will be ignored by the agent.
         note: severity numeric values increase as their
         severity decreases, e.g. 'error' is more severe than
         'debug'."
    DEFVAL { warning }
    ::= { clogBasic 3 }

clogMsgIgnores OBJECT-TYPE
    SYNTAX Counter
--  Units
--    messages
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The number of syslog messages which were ignored.  A
         message will be ignored if it has a severity value
         greater than clogMaxSeverity."
    ::= { clogBasic 4 }

clogMsgDrops OBJECT-TYPE
    SYNTAX Counter
--  Units
--    messages
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The number of syslog messages which could not be
         processed due to lack of system resources. Most
         likely this will occur at the same time that syslog
         messages are generated to indicate this lack of
         resources.  Increases in this object's value may serve
         as an indication that system resource levels should be
         examined via other mib objects.  A message that is
         dropped will not appear in the history table and
         no notification will be sent for this message."
    ::= { clogBasic 5 }

clogOriginIDType OBJECT-TYPE
    SYNTAX INTEGER {
        none(1),
        other(2),
        hostName(3),
        ipv4Address(4),
        contextName(5),
        userDefined(6)
        }
    ACCESS read-write
    STATUS mandatory
    DESCRIPTION
        "This object identifies the type of value that
        will be contained in clogOriginID object.
        
        The possible value(s) are:
           'none'       : do not send origin identifier in 
                          syslog messages.
           'other'      : type that is not identified by other 
                          values specified in this object.
           'hostName'   : Send hostname of the system in syslog
                          messages.
           'ipv4Address': Send IP address of the sending interface.
           'contextName': Send context name of the security device.
           'userDefined': Send user configured string in
                          syslog message.
        
           The value 'other' and 'none' can not be set but
           can only be read."
    DEFVAL { none }
    ::= { clogBasic 6 }

clogOriginID OBJECT-TYPE
    SYNTAX SnmpAdminString
--    Rsyntax OCTET STRING(SIZE(0..255))
    ACCESS read-write
    STATUS mandatory
    DESCRIPTION
        "This object is used for configuring the
        origin identifier for the syslog messages.
        
        The origin identifier is useful for identifying 
        the source of system logging messages in cases 
        syslog messages from multiple devices are sent 
        to a single syslog host.
        The origin identifier is added to the beginning of
        all system logging (syslog) messages sent to remote 
        hosts.
        
        The type of the identifier is specified
        by clogOriginIDType object.
        
        This object can be written by the SNMP manager
        only when clogOriginIDType is set to 'userDefined'.
        
        For following value(s) of clogOriginIDType,
        this object can not be set; the value of this
        object is derived by the system in these cases:
           'contextName' 
           'ipv4Address'
           'hostName'
           'other'     
           'none'     
        
        This object contains the context name
        of the device, when clogOriginIDType is 
        set to 'contextName'.
        
        This object contains IPv4 address
        (in dotted decimal notation) of the sending 
        interface when clogOriginIDType is set to
        'ipv4Address'.
        
        This object contains hostname of the system
        when clogOriginIDType is set to 'hostName'.
        
        This object will contain zero length
        octet string when clogOriginIDType is
        either 'none' or 'other'."
    DEFVAL { "" }
    ::= { clogBasic 7 }

clogHistTableMaxLength OBJECT-TYPE
    SYNTAX INTEGER(0..500)
--  Units
--    entries
    ACCESS read-write
    STATUS mandatory
    DESCRIPTION
        "The upper limit on the number of entries that the
         clogHistoryTable may contain.  A value of 0 will
         prevent any history from being retained. When this
         table is full, the oldest entry will be deleted and
         a new one will be created."
    DEFVAL { 1 }
    ::= { clogHistory 1 }

clogHistMsgsFlushed OBJECT-TYPE
    SYNTAX Counter
--  Units
--    messages
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The number of entries that have been removed from
         the clogHistoryTable in order to make room for new
         entries. This object can be utilized to determine
         whether your polling frequency on the history table
         is fast enough and/or the size of your history table
         is large enough such that you are not missing
         messages."
    ::= { clogHistory 2 }

clogHistoryTable OBJECT-TYPE
    SYNTAX SEQUENCE OF ClogHistoryEntry
    ACCESS not-accessible
    STATUS mandatory
    DESCRIPTION
        "A table of syslog messages generated by this device.
         All 'interesting' syslog messages (i.e. severity <=
         clogMaxSeverity) are entered into this table."
    ::= { clogHistory 3 }

clogHistoryEntry OBJECT-TYPE
    SYNTAX ClogHistoryEntry
    ACCESS not-accessible
    STATUS mandatory
    DESCRIPTION
        "A syslog message that was previously generated by this
         device. Each entry is indexed by a message index."
    INDEX { clogHistIndex }
    ::= { clogHistoryTable 1 }

ClogHistoryEntry ::= SEQUENCE {
    clogHistIndex INTEGER,
    clogHistFacility DisplayString,
    clogHistSeverity SyslogSeverity,
    clogHistMsgName DisplayString,
    clogHistMsgText DisplayString,
    clogHistTimestamp TimeStamp
    }

clogHistIndex OBJECT-TYPE
    SYNTAX INTEGER(1..2147483647)
    ACCESS not-accessible
    STATUS mandatory
    DESCRIPTION
        "A monotonically increasing integer for the sole
         purpose of indexing messages.  When it reaches the
         maximum value the agent flushes the table and wraps
         the value back to 1."
    ::= { clogHistoryEntry 1 }

clogHistFacility OBJECT-TYPE
    SYNTAX DisplayString(SIZE(1..20))
--    Rsyntax OCTET STRING(SIZE(1..20))
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "Name of the facility that generated this message.
         For example: 'SYS'."
    ::= { clogHistoryEntry 2 }

clogHistSeverity OBJECT-TYPE
    SYNTAX SyslogSeverity
--    Rsyntax INTEGER {
--        emergency(1),
--        alert(2),
--        critical(3),
--        error(4),
--        warning(5),
--        notice(6),
--        info(7),
--        debug(8)
--        }
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The severity of the message."
    ::= { clogHistoryEntry 3 }

clogHistMsgName OBJECT-TYPE
    SYNTAX DisplayString(SIZE(1..30))
--    Rsyntax OCTET STRING(SIZE(1..30))
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "A textual identification for the message type.
         A facility name in conjunction with a message name
         uniquely identifies a message type."
    ::= { clogHistoryEntry 4 }

clogHistMsgText OBJECT-TYPE
    SYNTAX DisplayString(SIZE(1..255))
--    Rsyntax OCTET STRING(SIZE(1..255))
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The text of the message.  If the text of the message
         exceeds 255 bytes, the message will be truncated to
         254 bytes and a '*' character will be appended -
         indicating that the message has been truncated."
    ::= { clogHistoryEntry 5 }

clogHistTimestamp OBJECT-TYPE
    SYNTAX TimeStamp
--    Rsyntax TimeTicks
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The value of sysUpTime when this message was
         generated."
    ::= { clogHistoryEntry 6 }

clogMaxServers OBJECT-TYPE
    SYNTAX Gauge
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "The maximum number of syslog servers that can be
         configured for the system in clogServerConfigTable.
        
         A value of zero for this object indicates there is
         no specified limit for the system and is only dictated
         by system resources."
    ::= { clogServer 1 }

clogServerConfigTable OBJECT-TYPE
    SYNTAX SEQUENCE OF ClogServerConfigEntry
    ACCESS not-accessible
    STATUS mandatory
    DESCRIPTION
        "This table contains entries that allow application
         to configure syslog servers for the system.
        
         The maximum number of entries that can be created
         for this table is limited by the object
         clogMaxServers."
    ::= { clogServer 2 }

clogServerConfigEntry OBJECT-TYPE
    SYNTAX ClogServerConfigEntry
    ACCESS not-accessible
    STATUS mandatory
    DESCRIPTION
        "An entry containing information about syslog servers
         configured for the system."
    INDEX { clogServerAddrType, clogServerAddr }
    ::= { clogServerConfigTable 1 }

ClogServerConfigEntry ::= SEQUENCE {
    clogServerAddrType InetAddressType,
    clogServerAddr InetAddress,
    clogServerStatus RowStatus
    }

clogServerAddrType OBJECT-TYPE
    SYNTAX InetAddressType
--    Rsyntax INTEGER {
--        ?? enum value of zero may cause problems
--        unknown(0),
--        ipv4(1),
--        ipv6(2),
--        ipv4z(3),
--        ipv6z(4),
--        dns(16)
--        }
    ACCESS not-accessible
    STATUS mandatory
    DESCRIPTION
        "The type of Internet address of this syslog server."
    ::= { clogServerConfigEntry 1 }

clogServerAddr OBJECT-TYPE
    SYNTAX InetAddress(SIZE(0..64))
--    Rsyntax OCTET STRING(SIZE(0..64))
    ACCESS not-accessible
    STATUS mandatory
    DESCRIPTION
        "The Internet address of this syslog server.
         The type of this address is determined by the
         value of the clogServerAddrType object."
    ::= { clogServerConfigEntry 2 }

clogServerStatus OBJECT-TYPE
    SYNTAX RowStatus
--    Rsyntax INTEGER {
--        active(1),
--        notInService(2),
--        notReady(3),
--        createAndGo(4),
--        createAndWait(5),
--        destroy(6)
--        }
    ACCESS read-write
    STATUS mandatory
    DESCRIPTION
        "The status object used to manage rows in this table.
        
         A row may only be created by setting this object to
         'createAndGo'.
        
         A row may only be deleted by setting this object to
         'destroy'."
    ::= { clogServerConfigEntry 3 }

clogMessageGenerated TRAP-TYPE
-- Reverse mappable trap
    ENTERPRISE ciscoSyslogMIBNotificationPrefix
    VARIABLES {
        clogHistFacility, clogHistSeverity, clogHistMsgName, 
        clogHistMsgText, clogHistTimestamp }
--  Status
--    mandatory
    DESCRIPTION
        "When a syslog message is generated by the device a
         clogMessageGenerated notification is sent.  The
         sending of these notifications can be enabled/disabled
         via the clogNotificationsEnabled object."
    ::= 1

ciscoSyslogMIBGroup OBJECT IDENTIFIER ::= { ciscoSyslogMIBGroups 1 }
-- OBJECT-GROUP
--  Status
--    mandatory
--  Descr
--    A collection of objects providing the syslog
--     MIB capability.
--  objects
--    clogNotificationsSent, clogNotificationsEnabled, 
--    clogMaxSeverity, clogMsgIgnores, clogMsgDrops, 
--    clogHistTableMaxLength, clogHistMsgsFlushed, clogHistFacility, 
--    clogHistSeverity, clogHistMsgName, clogHistMsgText, 
--    clogHistTimestamp

clogServerGroup OBJECT IDENTIFIER ::= { ciscoSyslogMIBGroups 3 }
-- OBJECT-GROUP
--  Status
--    mandatory
--  Descr
--    A collection of objects providing syslog server
--     information for the system.
--  objects
--    clogMaxServers, clogServerStatus

clogOriginIDGroup OBJECT IDENTIFIER ::= { ciscoSyslogMIBGroups 4 }
-- OBJECT-GROUP
--  Status
--    mandatory
--  Descr
--    A collection of objects providing information
--    on origin of syslog messages.
--  objects
--    clogOriginIDType, clogOriginID

clogNotificationsGroup OBJECT IDENTIFIER ::= { ciscoSyslogMIBGroups 2 }
-- NOTIFICATION-GROUP
--  Status
--    mandatory
--  Descr
--    A collection of notification(s) for syslog feature.
--  notifications
--    clogMessageGenerated

ciscoSyslogMIBCompliance OBJECT IDENTIFIER ::= { ciscoSyslogMIBCompliances 1 }
-- MODULE-COMPLIANCE
--  Status
--    deprecated
--  Descr
--    The compliance statement for entities which implement
--     the Cisco syslog MIB.
--  Module
--    >>current<<
--   MandGroup
--    ciscoSyslogMIBGroup

ciscoSyslogMIBComplianceRev1 OBJECT IDENTIFIER ::= { ciscoSyslogMIBCompliances 2 }
-- MODULE-COMPLIANCE
--  Status
--    mandatory
--  Descr
--    The compliance statement for entities which implement
--     the Cisco syslog MIB.
--  Module
--    >>current<<
--   MandGroup
--    ciscoSyslogMIBGroup
--   OptGroup
--    clogServerGroup
--   OptGroup
--    clogOriginIDGroup
--   OptGroup
--    clogNotificationsGroup


END