Generic Cisco Device extension
- Latest Dynatrace
- Extension
Monitor Cisco devices using SNMP to feed Dynatrace with metrics and alerts.
Get started
Overview
Cisco devices are a critical component in your network infrastructure. The Generic Cisco Device monitoring extension allows for remote monitoring of your Cisco network devices via the Simple Network Management Protocol (SNMP).
Use cases
- Monitor resource usage of network components
- Detect and alert on issues with critical protocols such as BGP
- Identify problems with network interfaces
Requirements
- Minimum Dynatrace environment and ActiveGate version 1.310
- ActiveGate must be able to communicate with the target devices via SNMP
- Review the SNMP data source documentation for details on support-levels and authentication
- The monitored devices must support a given Management Information Base (MIB) file in order to collect it's data
- Not all Cisco devices support all MIBs
- Some Cisco devices may only partially support a given MIB
Compatibility information
This extension is designed to generically provide visibility into a wide variety of Cisco network devices. Only products still supported by Cisco will be officially supported but it can be used to monitor any devices that meet the requirements for SNMP connectivity and support the MIBs and OIDs used.
Activation and setup
Find 'Generic Cisco Device' in the in-product Extensions App or Hub page and activate (if offline you can download the extension from the Hub page in the 'Release notes' section and install as a custom extension).
Monitoring configurations
You can add multiple target devices to a given monitoring configuration (recommended). Review the SNMP data source documentation for details on the configuration fields for SNMP device monitoring.
After adding the monitored devices you can select which feature sets to enable which will determine what the extension will query for.
Details
Metrics
Review the list of feature sets to see which metrics are collected. Not all feature sets will be applicable to all devices. You can enable or disable feature sets as needed based on the types and versions of devices you are using and your unique monitoring requirements.
Some metrics are required and cannot be disabled. These metrics will be in the "default" feature set. Take extra caution configuring devices and interfaces for which you are collecting data. Make use of Interface filters to limit the number of interfaces, otherwise, all interfaces on the device will be collected.
In case you do not wish to collect interfaces on your device, enter $eq(!) in the Interface filter field.
Licensing and costs
There is no charge to use the extension. You are only charged for the data that the extension ingests.
The Generic Cisco Device extension ingests custom metrics, which consume Davis Data Units (DDUs) (Dynatrace classic license) or Metrics powered by Grail (DPS), according to your license model.
Below is a breakdown of metrics by feature set metrics collected once per minute.
There are two metrics in the default feature set that are collected at a 30 minute interval for the Generic SNMP Cisco Device entity and as such are not included due to a minimal impact on the estimation:
-
default: 20
- 7 x Generic Network Interface
- 3 x Generic Network Device
- 8 x Generic SNMP Cisco Device
-
neighbor-discovery:
- per lldp neighbor: 1
-
Interfaces:
- per interface: 14
-
Memory pools:
- per memory pool: 2
-
High availability: 4
-
Cisco BGP:
- per bgp peer: 5
-
BGP:
- per bgp peer: 5
-
OSPF:
- per ospf peer: 1
-
EIGRP:
- per eigrp peer: 1
-
Sensors:
- per fan: 1
- per temp device: 1
- per power supply: 1
-
Sensors (Advanced):
- per sensor: 1
-
Health: 7
-
Traffic: 14
-
FRUs:
- per FRU (power): 1
- per FRU (fan): 1
Dynatrace Platform Subscription
In the Dynatrace Platform Subscription, metric ingestion consumes Metrics powered by Grail according to the number of ingested metric data points.
To calculate the approximate yearly consumption, apply the following calculation: <metric data points per minute> * 60 minutes * 24 hours * 365 days.
Dynatrace classic license
In the classic licensing model, metric ingestion consumes Davis Data Units (DDUs) at the rate of .001 DDUs per metric data point. Multiply the above formula for annual data points by .001 to estimate annual DDU usage.
The DDU cost above does not include any possible log events or custom events that are triggered by the extension. For more information, see DDU events.
Feature sets
When activating your extension using a monitoring configuration, you can limit monitoring to one of the feature sets. To work properly, the extension has to collect at least one metric after the activation.
In highly segmented networks, feature sets can reflect the segments of your environment. Then, when you create a monitoring configuration, you can select a feature set and a corresponding ActiveGate group that can connect to this particular segment.
All metrics that aren't categorized into any feature set are considered to be the default and are always reported.
A metric inherits the feature set of a subgroup, which in turn inherits the feature set of a group. Also, the feature set defined on the metric level overrides the feature set defined on the subgroup level, which in turn overrides the feature set defined on the group level.
Interfaces
| Metric name | Metric key | Description |
|---|---|---|
| Traffic in | com.dynatrace.extension.network_device.if.bytes_in.count | The volume of traffic, in bytes, inboud to the network interface. |
| Traffic out | com.dynatrace.extension.network_device.if.bytes_out.count | The volume of traffic, in bytes, outbound from the network interface. |
| Errors in | com.dynatrace.extension.network_device.if.in.errors.count | The number of errors, inboud to the network interface. |
| Discards in | com.dynatrace.extension.network_device.if.in.discards.count | The number of discarded packets, inbound to the network interface. |
| Errors out | com.dynatrace.extension.network_device.if.out.errors.count | The number of errors, outbound from the network interface. |
| Discards out | com.dynatrace.extension.network_device.if.out.discards.count | The number of discarded packets, outbound from the network interface. |
| Interface speed | com.dynatrace.extension.network_device.if.speed | The configured speed of the network interface in megabits per second. |
| Last change | com.dynatrace.extension.network_device.if.lastchange | The value of sysUpTime at the time the interface entered its current operational state. |
neighbor-discovery
| Metric name | Metric key | Description |
|---|---|---|
| LLDP Neighbor Information | com.dynatrace.extension.snmp-generic-cisco-device.lldp_neighbor | Conveys information about the existing LLDP neighbor connections. |
entity-enrichment
| Metric name | Metric key | Description |
|---|---|---|
| Stack component state | com.dynatrace.extension.snmp-generic-cisco-device.component.state | Reports the presence of a stack component. State information is carried in dimensions. |
Traffic
| Metric name | Metric key | Description |
|---|---|---|
| TCP active opens | com.dynatrace.extension.snmp-generic-cisco-device.tcp.activeopens.count | Number of transitions of TCP connections from CLOSED to SYN-SENT |
| TCP passive opens | com.dynatrace.extension.snmp-generic-cisco-device.tcp.passiveopens.count | Number of transitions of TCP connections from CLOSED to SYN-RCVD |
| TCP failed attempts | com.dynatrace.extension.snmp-generic-cisco-device.tcp.attemptfails.count | Number of transitions of TCP connections from SYN-SENT/SYN-RCVD to CLOSED and from SYN-RCVD to LISTEN |
| TCP resets | com.dynatrace.extension.snmp-generic-cisco-device.tcp.estab.resets.count | Number of transitions of TCP connections from ESTABLISHED/CLOSE-WAIT to CLOSED |
| TCP connections | com.dynatrace.extension.snmp-generic-cisco-device.tcp.curr.estab | Number of TCP connections in the ESTABLISHED/CLOSE-WAIT state |
| TCP segments received | com.dynatrace.extension.snmp-generic-cisco-device.tcp.hc.in.segs.count | Total number of segments received (including errors) |
| TCP segments sent | com.dynatrace.extension.snmp-generic-cisco-device.tcp.hc.out.segs.count | Total number of segments sent (excluding retransmissions) |
| TCP segments retransmitted | com.dynatrace.extension.snmp-generic-cisco-device.tcp.retrans.segs.count | Total number of segments retransmitted |
| TCP segment errors | com.dynatrace.extension.snmp-generic-cisco-device.tcp.in.errs.count | Total number of segments received in error |
| TCP segment resets | com.dynatrace.extension.snmp-generic-cisco-device.tcp.out.rsts.count | Number of TCP segments sent containing the RST flag |
| UDP datagrams received | com.dynatrace.extension.snmp-generic-cisco-device.udp.hc.in.datagrams.count | Total number of UDP datagrams received |
| UDP datagrams sent | com.dynatrace.extension.snmp-generic-cisco-device.udp.hc.out.datagrams.count | Total number of UDP datagrams sent |
| UDP datagrams received without port | com.dynatrace.extension.snmp-generic-cisco-device.udp.noports.count | Number of received UDP datagrams (no application at the destination port) |
| UDP datagram errors | com.dynatrace.extension.snmp-generic-cisco-device.udp.in.errors.count | Number of received and not delivered UDP datagrams (other than no application at the destination port) |
Cisco BGP
| Metric name | Metric key | Description |
|---|---|---|
| Cisco BGP Peer State | com.dynatrace.extension.snmp-generic-cisco-device.cbgp.peer.state | The Cisco BGP peer connection state. State value is also carried as a dimension. |
| Cisco BGP Peer Admin Status | com.dynatrace.extension.snmp-generic-cisco-device.cbgp.peer.admin.status | The desired state of the Cisco BGP connection. Admin status is also carried as a dimension. |
| Cisco BGP Peer Established Time | com.dynatrace.extension.snmp-generic-cisco-device.cbgp.established_time | Elapsed time in seconds since this peer was last in the established state. |
| Cisco BGP Updates Received | com.dynatrace.extension.snmp-generic-cisco-device.cbgp.updates_received_count | Number of BGP UPDATE messages received from this peer. |
| Cisco BGP Updates Sent | com.dynatrace.extension.snmp-generic-cisco-device.cbgp.updates_sent_count | Number of BGP UPDATE messages sent to this peer. |
OSPF
| Metric name | Metric key | Description |
|---|---|---|
| OSPF Neighbor State | com.dynatrace.extension.snmp-generic-cisco-device.ospf.nbr.state | The state of the OSPF neighbor relationship. State value is also carried as a dimension. |
FRUs
| Metric name | Metric key | Description |
|---|---|---|
| FRU power operational status | com.dynatrace.extension.snmp-generic-cisco-device.fru.power_oper_status | Operational status of the field replaceable power supply unit. |
| FRU fan tray operational status | com.dynatrace.extension.snmp-generic-cisco-device.fru.fan_tray_oper_status | Operational status of the field replaceable fan tray unit. |
Sensors
| Metric name | Metric key | Description |
|---|---|---|
| Fan state | com.dynatrace.extension.snmp-generic-cisco-device.envmon.fan.state | The current state of the fan being instrumented. State is also carried as a dimension. |
| Temperature sensor value | com.dynatrace.extension.snmp-generic-cisco-device.envmon.temperature.status.value | The current measurement of the testpoint being instrumented. |
Interfaces 64-bit
| Metric name | Metric key | Description |
|---|---|---|
| Interface speed | com.dynatrace.extension.snmp-generic-cisco-device.if.highspeed | Speed of the network interface in MegaBits per second. |
| Interface octets in (64-bit) | com.dynatrace.extension.snmp-generic-cisco-device.if.hc.in.octets.count | The total number of octets received on the interface (high-capacity 64-bit counter). |
| Interface octets out (64-bit) | com.dynatrace.extension.snmp-generic-cisco-device.if.hc.out.octets.count | The total number of octets transmitted out of the interface (high-capacity 64-bit counter). |
BGP
| Metric name | Metric key | Description |
|---|---|---|
| BGP Peer Connection State | com.dynatrace.extension.snmp-generic-cisco-device.bgp4.peer.state | The current state of the BGP peer connection. Possible values are idle(1), connect(2), active(3), opensent(4), openconfirm(5), established(6). |
| BGP Peer Admin Status | com.dynatrace.extension.snmp-generic-cisco-device.bgp4.peer.admin.status | The desired state of the BGP connection for this peer. Possible values are stop(1), start(2). |
| BGP Peer Established Time | com.dynatrace.extension.snmp-generic-cisco-device.bgp4.established_time | The time in seconds this peer has been in the established state or how long since this peer was last in the established state. |
default
| Metric name | Metric key | Description |
|---|---|---|
| Uptime | com.dynatrace.extension.network_device.sysuptime | The time, in system ticks (1/100 second), since the last system reboot. |
| CPU usage | com.dynatrace.extension.network_device.cpu_usage | The system's CPU usage expressed as a percentage |
| Free memory | com.dynatrace.extension.network_device.memory_free | The amount of memory, in kilobytes, currently free on the device |
| Used memory | com.dynatrace.extension.network_device.memory_used | The amount of memory, in kilobytes, used by the device |
| Interface status | com.dynatrace.extension.network_device.if.status | A state metric representing a network interface, whose value is always 1 and its dimensions indicate its state details. |
| System uptime | com.dynatrace.extension.snmp-generic-cisco-device.sys.uptime | The time (in hundredths of a second) since the network management portion of the system was last re-initialized. |
EIGRP
| Metric name | Metric key | Description |
|---|---|---|
| EIGRP Peer Smooth Round-Trip Time | com.dynatrace.extension.snmp-generic-cisco-device.eigrp.peer.srtt | The computed smooth round-trip time for packets sent to and received from this EIGRP peer. |
Advanced interfaces
| Metric name | Metric key | Description |
|---|---|---|
| Multicast packets in | com.dynatrace.extension.network_device.if.in.multicast_pkts.count | The number of multicast packets, inbound to the network interface. |
| Multicast packets out | com.dynatrace.extension.network_device.if.out.multicast_pkts.count | The number of multicast packets, outbound from the network interface. |
| Broadcast packets in | com.dynatrace.extension.network_device.if.in.broadcast_pkts.count | The number of broadcast packets, inbound to the network interface. |
| Broadcast packets out | com.dynatrace.extension.network_device.if.out.broadcast_pkts.count | The number of broadcast packets, outbound from the network interface. |
| Unicast packets in | com.dynatrace.extension.network_device.if.in.ucast_pkts.count | The number of unicast packets, inbound to the network interface. |
| Unicast packets out | com.dynatrace.extension.network_device.if.out.ucast_pkts.count | The number of unicast packets, outbound from the network interface. |
| CRC errors (in) | com.dynatrace.extension.network_device.if.in.crc_errors.count | Number of inbound packets that contained a CRC error. |
Sensors (Advanced)
| Metric name | Metric key | Description |
|---|---|---|
| Sensor value | com.dynatrace.extension.snmp-generic-cisco-device.sensor.value | The most recent measurement obtained by the agent for this sensor. |
Interfaces 32-bit
| Metric name | Metric key | Description |
|---|---|---|
| CRC errors in (32-bit) | com.dynatrace.extension.snmp-generic-cisco-device.if.in.crc_errors.count | Number of inbound packets that contained a CRC error (32-bit Cisco counter). |
| Interface last change | com.dynatrace.extension.snmp-generic-cisco-device.if.lastchange | The value of sysUpTime at the time the interface entered its current operational state. |
| Interface octets in (32-bit) | com.dynatrace.extension.snmp-generic-cisco-device.if.in.octets.count | The total number of octets received on the interface, including framing characters. |
| Interface octets out (32-bit) | com.dynatrace.extension.snmp-generic-cisco-device.if.out.octets.count | The total number of octets transmitted out of the interface, including framing characters. |
| Interface inbound errors | com.dynatrace.extension.snmp-generic-cisco-device.if.in.errors.count | For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. |
| Interface inbound discards | com.dynatrace.extension.snmp-generic-cisco-device.if.in.discards.count | The number of inbound packets which were chosen to be discarded even though no errors had been detected. |
| Interface outbound errors | com.dynatrace.extension.snmp-generic-cisco-device.if.out.errors.count | For packet-oriented interfaces, the number of outbound packets that could not be transmitted because of errors. |
| Interface outbound discards | com.dynatrace.extension.snmp-generic-cisco-device.if.out.discards.count | The number of outbound packets which were chosen to be discarded even though no errors had been detected. |
High availability
| Metric name | Metric key | Description |
|---|---|---|
| HA active supervisor CPU utilization | com.dynatrace.extension.snmp-generic-cisco-device.ha.active_supervisor.cpu_utilization | CPU utilization of the active supervisor in a high-availability pair. |
| HA active supervisor memory utilization | com.dynatrace.extension.snmp-generic-cisco-device.ha.active_supervisor.memory_utilization | Memory utilization of the active supervisor in a high-availability pair. |
| HA synchronization enabled | com.dynatrace.extension.snmp-generic-cisco-device.ha.synchronization.enabled | Indicates whether HA state synchronization is enabled. State carried in dimensions. |
| HA synchronization state | com.dynatrace.extension.snmp-generic-cisco-device.ha.synchronization.state | Current synchronization state of the HA pair. State carried in dimensions. |
Power supply
| Metric name | Metric key | Description |
|---|---|---|
| Power supply state | com.dynatrace.extension.snmp-generic-cisco-device.power_supply.state | Reports the presence and status of a power supply unit. State is carried in dimensions. |
Control Plane
| Metric name | Metric key | Description |
|---|---|---|
| CPU busy (1min) | com.dynatrace.extension.snmp-generic-cisco-device.cpm.cpu.total.1min.rev | The overall CPU busy percentage in the last 1-minute period. |
| CPU load average (1min) | com.dynatrace.extension.snmp-generic-cisco-device.cpm.cpu.loadavg.1min | The overall CPU load average in the last 1-minute period. |
| CPU process memory used (64-bit) | com.dynatrace.extension.snmp-generic-cisco-device.cpm.cpu.memory.hc.used | The amount of memory being used by the CPU sub-system (high-capacity 64-bit counter). |
| CPU process memory free (64-bit) | com.dynatrace.extension.snmp-generic-cisco-device.cpm.cpu.memory.hc.free | The amount of memory available to the CPU sub-system (high-capacity 64-bit counter). |
| CPU process memory used (32-bit) | com.dynatrace.extension.snmp-generic-cisco-device.cpm.cpu.memory.used | The amount of memory being used by the CPU sub-system. |
| CPU process memory free (32-bit) | com.dynatrace.extension.snmp-generic-cisco-device.cpm.cpu.memory.free | The amount of memory available to the CPU sub-system. |
Memory pools
| Metric name | Metric key | Description |
|---|---|---|
| Memory pool used (32-bit) | com.dynatrace.extension.snmp-generic-cisco-device.memory_pool.used | Indicates the number of bytes from the memory pool that are currently in use. |
| Memory pool free (32-bit) | com.dynatrace.extension.snmp-generic-cisco-device.memory_pool.free | Indicates the number of bytes from the memory pool that are currently unused. |
| Memory pool used (64-bit) | com.dynatrace.extension.snmp-generic-cisco-device.enhanced.memory_pool.used | Indicates the number of bytes from the memory pool that are currently in use (high-capacity 64-bit counter). |
| Memory pool free (64-bit) | com.dynatrace.extension.snmp-generic-cisco-device.enhanced.memory_pool.free | Indicates the number of bytes from the memory pool that are currently unused (high-capacity 64-bit counter). |
Health
| Metric name | Metric key | Description |
|---|---|---|
| SNMP Messages delivered | com.dynatrace.extension.snmp-generic-cisco-device.snmp.in.pkts.count | Total number of messages delivered to the SNMP entity from the transport service |
| SNMP Messages passed | com.dynatrace.extension.snmp-generic-cisco-device.snmp.out.pkts.count | Total number of messages passed from the SNMP entity to the transport service |
| Silently dropped SNMP PDUs | com.dynatrace.extension.snmp-generic-cisco-device.snmp.silentdrops.count | Number of silently dropped SNMP PDUs due to the large reply size |
| Proxy dropped SNMP PDUs | com.dynatrace.extension.snmp-generic-cisco-device.drops.proxy.count | Number of silently dropped SNMP PDUs due to the other than a time-out |
| Unsupported SNMP version messages | com.dynatrace.extension.snmp-generic-cisco-device.snmp.in.bad.versions.count | Total number of messages delivered with an unsupported SNMP version |
| Messages with bad SNMP community names | com.dynatrace.extension.snmp-generic-cisco-device.snmp.in.bad.community.names.count | Number of messages with an unknown SNMP community name |
| Messages not allowed for SNMP community names | com.dynatrace.extension.snmp-generic-cisco-device.snmp.in.bad.community.uses.count | Number of messages not allowed for the used SNMP community name |
| 'noSuchName' SNMP errors | com.dynatrace.extension.snmp-generic-cisco-device.snmp.in.nosuchnames.count | Number of delivered SNMP PDUs with 'noSuchName' error |
| 'badValue' SNMP errors | com.dynatrace.extension.snmp-generic-cisco-device.snmp.in.bad.values.count | Number of delivered SNMP PDUs with 'badValue' error |
| SNMP Traps processed | com.dynatrace.extension.snmp-generic-cisco-device.snmp.in.traps.count | Total number of SNMP Trap PDUs accepted and processed |
| SNMP Traps generated | com.dynatrace.extension.snmp-generic-cisco-device.snmp.out.traps.count | Total number of SNMP Trap PDUs generated |
FAQ
Basic information is available in the Dynatrace SNMP Troubleshooting doc.
Additional troubleshooting guides are available in the Dynatrace Community.
