Professional Documents
Culture Documents
MERAKI-CLOUD-CONTROLLER-MIB
IMPORTS
enterprises, MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, IpAddress,
Counter32
FROM SNMPv2-SMI
DateAndTime, DisplayString
FROM SNMPv2-TC
ifIndex, InterfaceIndex
FROM IF-MIB
PhysAddress
FROM RFC1213-MIB;
cloudController MODULE-IDENTITY
LAST-UPDATED "201609010001Z"
ORGANIZATION "Cisco Systems, Inc."
CONTACT-INFO
"Cisco Systems, Inc.
500 Terry Francois Blvd.,
San Francisco, CA 94158
USA
Tel: +1-415-632-5800"
DESCRIPTION
"Management information base in SMI v2 for the Meraki Cloud Controller."
REVISION "201609010001Z"
DESCRIPTION
"Updated vpnConnectivityChange trap."
REVISION "201506250001Z"
DESCRIPTION
"The latest version of this MIB module."
REVISION "201205240001Z"
DESCRIPTION
"The initial version of this MIB module."
::= { meraki 1 }
testTrap NOTIFICATION-TYPE
OBJECTS {networkName}
STATUS current
DESCRIPTION "A test trap to verify whether the receiving server is configured
correctly.
The name of the network where the trap configuration resides will be
sent as well. "
::= { traps 1 }
deviceGoesDownTrap NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac}
STATUS current
DESCRIPTION "Alert when a device becomes unreachable
from the Meraki cloud. The device's mac address is
enclosed."
::= { traps 2 }
deviceComesOnline NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac}
STATUS current
DESCRIPTION "Alert when a device reconnects to
the Meraki cloud. The device's mac address is
enclosed."
::= { traps 3 }
foreignAPDetected NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac}
STATUS current
DESCRIPTION "Alert when an unknown access point appears
on the network."
::= { traps 4 }
cellularNetworkUp NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devInterfaceModel,
devInterfaceCarrier, devInterfaceName}
STATUS current
DESCRIPTION "Alert when a network connects to a cellular
network."
::= { traps 5 }
cellularNetworkDown NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devInterfaceModel,
devInterfaceCarrier, devInterfaceName}
STATUS current
DESCRIPTION "Alert when a network disconnects from a cellular
network."
::= { traps 6 }
newDhcpServerAlert NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devLanIp, devSubnet,
vlanNumber}
STATUS current
DESCRIPTION "Alert when a new dhcp server appears on the
network."
::= { traps 7 }
noDhcpLeases NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devLanIp, vlanNumber}
STATUS current
DESCRIPTION "Alert when DHCP leases are exhausted."
::= { traps 8 }
uplinkStatusChanged NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devInterfaceName}
STATUS current
DESCRIPTION "Alert when an uplink status changes."
::= { traps 9 }
unreachableDevicesDetected NOTIFICATION-TYPE
OBJECTS {organizationName, networkName}
STATUS current
DESCRIPTION "Unreachable devices have been detected on the
network. Adjust firewall settings accordingly."
::= { traps 10 }
upcomingFirewallInformationChanges NOTIFICATION-TYPE
OBJECTS {organizationName, networkName}
STATUS current
DESCRIPTION "Upcoming firewall information changes. Adjust firewall
settings accordingly."
::= { traps 11 }
gatewayToRepeater NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac}
STATUS current
DESCRIPTION "Alert when a gateway becomes a repeater."
::= { traps 12 }
ipConflict NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devLanIp, devMac}
STATUS current
DESCRIPTION "Alert if a client IP conflict is detected."
::= { traps 13 }
newSplashSignup NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, ssidName, userName, userEmail}
STATUS current
DESCRIPTION "Alert when a new splash user registers to an SSID."
::= { traps 14 }
portCableError NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devInterfaceDescription,
devInterfacePortDescription}
STATUS current
DESCRIPTION "Alert when a cable error is detected."
::= { traps 15 }
portConnected NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devInterfaceDescription}
STATUS current
DESCRIPTION "Alert when a switch port is connected."
::= { traps 16 }
portDisconnected NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devInterfaceDescription}
STATUS current
DESCRIPTION "Alert when a switch port is disconnected."
::= { traps 17 }
portSpeedChange NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devInterfaceDescription,
devInterfacePortDescription}
STATUS current
DESCRIPTION "Alert when a switch port link speed changed."
::= { traps 18 }
rogueDhcpServer NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devSubnet, devLanIp,
vlanNumber }
STATUS current
DESCRIPTION "Alert when a rogue DHCP server is detected. Contains the mac, IP,
subnet and VLAN of the Rogue DHCP server."
::= { traps 19 }
settingsChanged NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, networkAdmin, changeDescription}
STATUS current
DESCRIPTION "Alert when Meraki Dashboard settings are changed. Includes
information about the network admin that made the changes."
::= { traps 20 }
unreachableRadiusServer NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, radiusServerIp, ssidName, devLanIp}
STATUS current
DESCRIPTION "Alert when a RADIUS authentication server becomes
unreachable. Contains the IP of the RADIUS server,
the IP of the Meraki server having trouble connecting to it
and the name of the SSID that uses the RADIUS server."
::= { traps 21 }
vpnConnectivityChange NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, vpnPeer, devStatus,
tunnelDescription}
STATUS current
DESCRIPTION "Alert when VPN connectivity changed. Contains the IP and port of
VPN peer, the mac address of the device used to VPN, and the
status
whether or not the VPN is on or offline"
::= { traps 22 }
warmSpareFailoverDetected NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, devStatus}
STATUS current
DESCRIPTION "Alert when a warm spare failover is detected."
::= { traps 23 }
loginAttempt NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, loginEmail, loginResult,
loginDescription}
STATUS current
DESCRIPTION "Alert when a login attempt is detected."
::= { traps 24 }
malwareDetected NOTIFICATION-TYPE
OBJECTS {organizationName, networkName}
STATUS current
DESCRIPTION "Alert when malware has been downloaded on the network."
::= { traps 25 }
malwareBlocked NOTIFICATION-TYPE
OBJECTS {organizationName, networkName}
STATUS current
DESCRIPTION "Alert when malware download attempt has been blocked on the
network."
::= { traps 26 }
powerSupplyUp NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, powerSupplyNum}
STATUS current
DESCRIPTION "Alert when an external power supply gains connectivity."
::= { traps 27 }
powerSupplyDown NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, powerSupplyNum}
STATUS current
DESCRIPTION "Alert when an external power supply loses connectivity."
::= { traps 28 }
redundantPowerSupplyBackup NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, powerSupplyNum}
STATUS current
DESCRIPTION "Alert when an external redundant power supply is providing primary
power to a switch. Only applies to Layer 2 switches."
::= { traps 29 }
redundantPowerSupplyBackToPrimary NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, powerSupplyNum}
STATUS current
DESCRIPTION "Alert when the internal power supply returns to providing primary
power to a switch. Only applies to Layer 2 switches."
::= { traps 30 }
udldError NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac, portNumber,
devInterfacePortDescription, actionTaken}
STATUS current
DESCRIPTION "Alert when there are UDLD errors seen on a port."
::= { traps 31 }
criticalTemperature NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, devMac}
STATUS current
DESCRIPTION "Alert when a device starts operating at critical temperature."
::= { traps 32 }
usageAlert NOTIFICATION-TYPE
OBJECTS {organizationName, networkName, period, endOfHighUsageWindow,
threshold, usage}
STATUS current
DESCRIPTION "Alert when a network's total usage passes a specified threshold."
::= { traps 33 }
changeDescription OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The description of a settingsChanged event."
::= { merakiObjects 1 }
loginEmail OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The email used for the login attempt."
::= { merakiObjects 2 }
loginResult OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The result of the login attempt, either success or failure."
::= { merakiObjects 3 }
loginDescription OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "A JSON description of the login attempt which includes the location
and time of the attempt."
::= { merakiObjects 4 }
tunnelDescription OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "A JSON description of the tunnel's detailed information."
::= { merakiObjects 5 }
period OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Time period over which network usage is tracked for threshold."
::= { merakiObjects 6 }
endOfHighUsageWindow OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "End time of high usage window."
::= { merakiObjects 7 }
threshold OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Maximum desired network usage."
::= { merakiObjects 8 }
usage OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Actual network usage."
::= { merakiObjects 9 }
organizationName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Organization name."
::= { organization 1 }
networkTable OBJECT-TYPE
SYNTAX SEQUENCE OF MerakiNetwork
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Networks table."
::= { organization 2 }
networkEntry OBJECT-TYPE
SYNTAX MerakiNetwork
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Describes each network."
INDEX { networkId }
::= { networkTable 1 }
networkId OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..64))
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Network id, consists of 8 octets. Remains the same even
if the name of the network changes"
::= { networkEntry 1 }
networkName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Network name."
::= { networkEntry 2 }
networkAdmin OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Name and email of a network admin."
::= { networkEntry 3 }
vpnPeer OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION "IP and port of a VPN peer connected to the network."
::= { networkEntry 4 }
ssidTable OBJECT-TYPE
SYNTAX SEQUENCE OF MerakiSSID
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "SSID table."
::= { organization 3 }
ssidEntry OBJECT-TYPE
SYNTAX MerakiSSID
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Describes each SSID."
INDEX { networkId, ssidNumber }
::= { ssidTable 1 }
ssidNetworkName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The name of the network the SSID is part of."
::= { ssidEntry 1 }
ssidNumber OBJECT-TYPE
SYNTAX INTEGER (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION "SSID number."
::= { ssidEntry 2 }
ssidName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "SSID name."
::= { ssidEntry 3 }
userName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Name of user connected to SSID."
::= { ssidEntry 4 }
userEmail OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Email of user connected to SSID."
::= { ssidEntry 5 }
radiusServerIp OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION "IP address of RADIUS server used for authentication
on an SSID."
::= { ssidEntry 6 }
radiusServerPort OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Port associated with an IP address of RADIUS server
used for authentication on an SSID."
::= { ssidEntry 7 }
devTable OBJECT-TYPE
SYNTAX SEQUENCE OF MerakiDev
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Device table."
::= { organization 4 }
devEntry OBJECT-TYPE
SYNTAX MerakiDev
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Describes each device."
INDEX { devMac }
::= { devTable 1 }
devMac OBJECT-TYPE
SYNTAX PhysAddress (SIZE(6))
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The MAC address of the device."
::= { devEntry 1 }
devName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Device name."
::= { devEntry 2 }
devStatus OBJECT-TYPE
SYNTAX INTEGER { offline(0), online(1) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The status of the device's connection to the Meraki Cloud
Controller"
::= { devEntry 3 }
devContactedAt OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The last time the device contacted the Cloud Controller."
::= { devEntry 4 }
devClientCount OBJECT-TYPE
SYNTAX INTEGER
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The number of clients currently associated with the device."
::= { devEntry 5 }
devMeshStatus OBJECT-TYPE
SYNTAX INTEGER { gateway(0), repeater(1) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Whether the device is currently acting as a gateway or a repeater."
::= { devEntry 6 }
devPublicIp OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Whether the device is currently acting as a gateway (as opposed to a
repeater)."
::= { devEntry 7 }
devSerial OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Device serial number."
::= { devEntry 8 }
devProductCode OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Device product code."
::= { devEntry 9 }
devProductDescription OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Device product description."
::= { devEntry 10 }
devNetworkName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The name of the network this device is in. Useful in tables."
::= { devEntry 11 }
devLanIp OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The LAN IP of the device. Useful for DHCP server alerts."
::= { devEntry 12 }
devSubnet OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The subnet the device is on. Useful for DHCP server alerts."
::= { devEntry 13 }
devCellularStatus OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The Cellular status of the device. Useful for monitoring the state
of the cellular modem."
::= { devEntry 14 }
devInterfaceTable OBJECT-TYPE
SYNTAX SEQUENCE OF MerakiDev
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Device interfaces table."
::= { organization 5 }
devInterfaceEntry OBJECT-TYPE
SYNTAX MerakiDev
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Describes each device."
INDEX { devInterfaceDevMac, devInterfaceIndex }
::= { devInterfaceTable 1 }
devInterfaceDevMac OBJECT-TYPE
SYNTAX PhysAddress (SIZE(6))
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The MAC address of the device."
::= { devInterfaceEntry 1 }
devInterfaceIndex OBJECT-TYPE
SYNTAX INTEGER (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The index of this interface."
::= { devInterfaceEntry 2 }
devInterfaceName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The name of this interface."
::= { devInterfaceEntry 3 }
devInterfaceSentPkts OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The number of packets sent on this interface."
::= { devInterfaceEntry 4 }
devInterfaceRecvPkts OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The number of packets received on this interface."
::= { devInterfaceEntry 5 }
devInterfaceSentBytes OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The number of bytes sent on this interface."
::= { devInterfaceEntry 6 }
devInterfaceRecvBytes OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The number of bytes received on this interface."
::= { devInterfaceEntry 7 }
devInterfaceModel OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The model of the interface. Useful for cellular interfaces."
::= { devInterfaceEntry 8 }
devInterfaceCarrier OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The carrier for the interface. Useful for cellular interfaces."
::= { devInterfaceEntry 9 }
devInterfaceDescription OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Description for the interface. Useful for information
about ports"
::= { devInterfaceEntry 10 }
devInterfacePortDescription OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Description for errors occurring on the interface.
Useful for information about ports"
::= { devInterfaceEntry 11 }
vlanTable OBJECT-TYPE
SYNTAX SEQUENCE OF MerakiVLAN
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "VLAN table."
::= { organization 6 }
vlanEntry OBJECT-TYPE
SYNTAX MerakiVLAN
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Describes each VLAN."
INDEX { networkId, vlanNumber }
::= { vlanTable 1 }
powerSupplyNum OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "External power supply number. Will be 0 for redundant supplies and
1+ for modular supplies."
::= { devInterfaceEntry 12 }
actionTaken OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Action taken on the port."
::= { devInterfaceEntry 13 }
portNumber OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "Description for the interface. Useful for information about ports"
::= { devInterfaceEntry 14 }
vlanNetworkName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The name of the network the VLAN is part of."
::= { vlanEntry 1 }
vlanNumber OBJECT-TYPE
SYNTAX INTEGER (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION "VLAN number."
::= { vlanEntry 2 }
vlanName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION "VLAN name."
::= { vlanEntry 3 }