Network Performance Monitoring is now generally available! Network Monitoring is now available!

SNMP

Agent Check Agent Check

Supported OS: Linux Mac OS Windows

Overview

Simple Network Management Protocol (SNMP) is a standard for monitoring network-connected devices, such as routers, switches, servers, and firewalls. This check collects SNMP metrics from your network devices.

SNMP uses sysOIDs (System Object Identifiers) to uniquely identify devices, and OIDs (Object Identifiers) to uniquely identify managed objects. OIDs follow a hierarchical tree pattern: under the root is ISO, which is numbered 1. The next level is ORG and numbered 3 and so on, with each level being separated by a ..

A MIB (Management Information Base) acts as a translator between OIDs and human readable names, and organizes a subset of the hierarchy. Because of the way the tree is structured, most SNMP values start with the same set of objects:

  • 1.3.6.1.1: (MIB-II) A standard that holds system information like uptime, interfaces, and network stack.
  • 1.3.6.1.4.1: A standard that holds vendor specific information.

Setup

Installation

The SNMP check is included in the Datadog Agent package. No additional installation is necessary.

Configuration

Note: The following features are in beta.

The Datadog SNMP check auto-discovers network devices on a provided subnet, and collects metrics using Datadog’s sysOID mapped device profiles.

Edit the subnet, SNMP version, and profiles in the snmp.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample snmp.d/conf.yaml for all available configuration options.

Autodiscovery

To use Autodiscovery with the SNMP check:

  1. Install or upgrade the Datadog Agent to v6.16+. For platform specific instructions, see the Datadog Agent documentation.

  2. Configure the SNMP check with snmp.d/conf.yaml. The following parameters are available. See the sample config for required parameters, default values, and examples.

ParameterDescription
profilesA list of profiles to use. A profile is a collection of OIDs the Datadog Agent collects metrics and associated tags from. A complete list of Datadog supported profiles can be found in Github. Profiles can be referenced by file, under definition_file, or written inline under definition. Any of the OOTB Datadog profiles can be listed by their name. Additional custom profiles can be referenced by the file path. Note: The generic profile is generic_router.yaml, which should work for routers, switches, etc.
network_addressThe subnet and mask written in IPv4 notation for the Agent to scan and discover devices on.
community_stringFor use with SNMPv1 and SNMPv2
snmp_versionThe SNMP version you are using.
portThe port for the Datadog Agent to listen on.
timeoutThe number of seconds before timing out.
retriesThe number of retries before failure.
discovery_intervalThe interval between discovery scans.
discovery_allowed_failuresThe number of times a discovered host can fail before being removed from the list of discovered devices.
bulk_thresholdThe number of symbols in a table that triggers a BULK request. This paramater is only relevant for SNMPv > 1.
tagsA list of global tags to add to all SNMP metrics. Read more about tagging in Datadog.
Sample config
init_config:
  profiles:
    f5-big-ip:
      definition_file: f5-big-ip.yaml
    router:
      definition_file: generic-router.yaml

instances:
  -  
    ## @param network_address - string - optional
    network_address: "<NETWORK_ADDRESS>"

    ## @param port - integer - optional - default: 161
    port: 161

    ## @param community_string - string - optional
    community_string: public

    ## @param snmp_version - integer - optional - default: 2
    snmp_version: 2

    ## @param timeout - integer - optional - default: 1
    timeout: 1

    ## @param retries - integer - optional - default: 5
    retries: 5

    ## @param discovery_interval - integer - optional - default: 3600
    discovery_interval: 3600

    ## @param discovery_allowed_failures - integer - optional - default: 3
    discovery_allowed_failures: 3

    ## @param enforce_mib_constraints - boolean - optional - default: true
    enforce_mib_constraints: true

    ## @param bulk_threshold - integer - optional - default: 5
    bulk_threshold: 5

    ## @param tags - list of key:value element - optional
    tags:
       - "<KEY_1>:<VALUE_1>"
       - "<KEY_2>:<VALUE_2>"
sysOID mapped device profiles

Profiles allow the SNMP check to reuse metric definitions across several device types or instances. Profiles define metrics the same way as instances, either inline in the configuration file or in separate files. Each instance can only match a single profile. For example, you can define a profile in the init_config section:

init_config:
  profiles:
    my-profile:
      definition:
        - MIB: IP-MIB
          table: ipSystemStatsTable
          symbols:
            - ipSystemStatsInReceives
          metric_tags:
            - tag: ipversion
          index: 1
      sysobjectid: '1.3.6.1.4.1.8072.3.2.10'

Then either reference it explicitly by name, or use sysObjectID detection:

instances:
   - ip_address: 192.168.34.10
     profile: my-profile
   - ip_address: 192.168.34.11
     # Don't need anything else here, the check will query the sysObjectID
     # and use the profile if it matches.

If necessary, additional metrics can be defined in the instances. These metrics are collected in addition to those in the profile.

Metric definition by profile

Profiles can be used interchangeably, such that devices that share MIB dependencies can reuse the same profiles. For example, the Cisco c3850 profile can be used across many Cisco switches.

Generic router profile

The generic router profile collects the following metrics.

MetricDescriptionTags
snmp.ifInDiscardsThe number of inbound packets chosen to be discarded even though no errors had been detected to prevent them being deliverable to a higher-layer protocol.interface
snmp.ifOutErrorsThe number of outbound packets that could not be transmitted because of errors.interface
snmp.ifOutDiscardsThe number of outbound packets chosen to be discarded even though no errors had been detected to prevent them being transmitted.interface
snmp.ifInErrorsThe number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.interface
snmp.ifAdminStatusThe desired state of the interface.interface
snmp.ifOperStatusThe current operational state of the interface.interface
snmp.ifHCInOctetsThe total number of octets received on the interface including framing characters.interface
snmp.ifHCInUcastPktsThe number of packets delivered by this sub-layer to a higher (sub-)layer that were not addressed to a multicast or broadcast address at this sub-layer.interface
snmp.ifHCInBroadcastPktsThe number of packets delivered by this sub-layer to a higher (sub-)layer that were addressed to a broadcast address at this sub-layer.interface
snmp.ifHCOutOctetsThe total number of octets transmitted out of the interface including framing characters.interface
snmp.ifHCOutUcastPktsThe total number of packets higher-level protocols requested be transmitted that were not addressed to a multicast or broadcast address at this sub-layer including those that were discarded or not sent.interface
snmp.ifHCOutMulticastPktsThe total number of packets that higher-level protocols requested be transmitted that were addressed to a multicast address at this sub-layer including those that were discarded or not sent.interface
snmp.ifHCOutBroadcastPktsThe total number of packets that higher-level protocols requested be transmitted that were addressed to a broadcast address at this sub-layer, including those that were discarded or not sent.interface
snmp.ipSystemStatsHCInReceivesThe total number of input IP datagrams received including those received in error.ipversion
snmp.ipSystemStatsHCInOctetsThe total number of octets received in input IP datagrams including those received in error.ipversion
snmp.ipSystemStatsInHdrErrorsThe number of input IP datagrams discarded due to errors in their IP headers including version number mismatch, their IP headers, other format errors, hop count exceeded, errors discovered in processing their IP options, etc.ipversion
snmp.ipSystemStatsInNoRoutesThe number of input IP datagrams discarded because no route could be found to transmit them to their destination.ipversion
snmp.ipSystemStatsInAddrErrorsThe number of input IP datagrams discarded because the IP address in the header’s destination field was not a valid address to be received at this entity.ipversion
snmp.ipSystemStatsInUnknownProtosThe number of locally-addressed IP datagrams received successfully but discarded because of an unknown or unsupported protocol.ipversion
snmp.ipSystemStatsInTruncatedPktsThe number of input IP datagrams discarded because the datagram frame didn’t carry enough data.ipversion
snmp.ipSystemStatsHCInForwDatagramsThe number of input datagrams for which this entity was not their final IP destination and for which this entity attempted to find a route to forward them to that final destination.ipversion
snmp.ipSystemStatsReasmReqdsThe number of IP fragments received that needed to be reassembled at this interface.ipversion
snmp.ipSystemStatsReasmOKsThe number of IP datagrams successfully reassembled.ipversion
snmp.ipSystemStatsReasmFailsThe number of failures detected by the IP reassembly algorithm (for whatever reason: timed out, errors, etc.).ipversion
snmp.ipSystemStatsInDiscardsThe number of input IP datagrams for which no problems were encountered to prevent their continued processing, but were discarded due to other reasons, for example lack of buffer space.ipversion
snmp.ipSystemStatsHCInDeliversThe total number of datagrams successfully delivered to IP user-protocols (including ICMP).ipversion
snmp.ipSystemStatsHCOutRequestsThe total number of IP datagrams that local IP user-protocols (including ICMP) supplied to IP in requests for transmission.ipversion
snmp.ipSystemStatsOutNoRoutesThe number of locally generated IP datagrams discarded because no route could be found to transmit them to their destination.ipversion
snmp.ipSystemStatsHCOutForwDatagramsThe number of datagrams for which this entity was not their final IP destination and for which it was successful in finding a path to their final destination.ipversion
snmp.ipSystemStatsOutDiscardsThe number of output IP datagrams for which no problem was encountered to prevent their transmission to their destination, but were discarded due to other reasons, for example lack of buffer space.ipversion
snmp.ipSystemStatsOutFragReqdsThe number of IP datagrams that would require fragmentation to be transmitted.ipversion
snmp.ipSystemStatsOutFragOKsThe number of IP datagrams successfully fragmented.ipversion
snmp.ipSystemStatsOutFragFailsThe number of IP datagrams discarded because they needed to be fragmented but could not be.ipversion
snmp.ipSystemStatsOutFragCreatesThe number of output datagram fragments generated as a result of IP fragmentation.ipversion
snmp.ipSystemStatsHCOutTransmitsThe total number of IP datagrams that this entity supplied to the lower layers for transmission.ipversion
snmp.ipSystemStatsHCOutOctetsThe total number of octets in IP datagrams delivered to the lower layers for transmission.ipversion
snmp.ipSystemStatsHCInMcastPktsThe number of IP multicast datagrams received.ipversion
snmp.ipSystemStatsHCInMcastOctetsThe total number of octets received in IP multicast datagrams.ipversion
snmp.ipSystemStatsHCOutMcastPktsThe number of IP multicast datagrams transmitted.ipversion
snmp.ipSystemStatsHCOutMcastOctetsThe total number of octets transmitted in IP multicast datagrams.ipversion
snmp.ipSystemStatsHCInBcastPktsThe number of IP broadcast datagrams received.ipversion
snmp.ipSystemStatsHCOutBcastPktsThe number of IP broadcast datagrams transmitted.ipversion
snmp.ipIfStatsHCInOctetsThe total number of octets received in input IP datagrams including those received in error.ipversion, interface
snmp.ipIfStatsInHdrErrorsThe number of input IP datagrams discarded due to errors in their IP headers including version number mismatch, other format errors, hop count exceeded, errors discovered in processing their IP options, etc.ipversion, interface
snmp.ipIfStatsInNoRoutesThe number of input IP datagrams discarded because no route could be found to transmit them to their destination.ipversion, interface
snmp.ipIfStatsInAddrErrorsThe number of input IP datagrams discarded because the IP address in their IP header’s destination field was not a valid address to be received at this entity.ipversion, interface
snmp.ipIfStatsInUnknownProtosThe number of locally-addressed IP datagrams received successfully but discarded because of an unknown or unsupported protocol.ipversion, interface
snmp.ipIfStatsInTruncatedPktsThe number of input IP datagrams discarded because the datagram frame didn’t carry enough data.ipversion, interface
snmp.ipIfStatsHCInForwDatagramsThe number of input datagrams for which this entity was not their final IP destination and for which this entity attempted to find a route to forward them to that final destination.ipversion, interface
snmp.ipIfStatsReasmReqdsThe number of IP fragments received that needed to be reassembled at this interface.ipversion, interface
snmp.ipIfStatsReasmOKsThe number of IP datagrams successfully reassembled.ipversion, interface
snmp.ipIfStatsReasmFailsThe number of failures detected by the IP reassembly algorithm (for whatever reason: timed out, errors, etc.).ipversion, interface
snmp.ipIfStatsInDiscardsThe number of input IP datagrams for which no problems were encountered to prevent their continued processing, but were discarded due to other reasons, for example lack of buffer space.ipversion, interface
snmp.ipIfStatsHCInDeliversThe total number of datagrams successfully delivered to IP user-protocols (including ICMP).ipversion, interface
snmp.ipIfStatsHCOutRequestsThe total number of IP datagrams that local IP user-protocols (including ICMP) supplied to IP in requests for transmission.ipversion, interface
snmp.ipIfStatsHCOutForwDatagramsThe number of datagrams for which this entity was not their final IP destination and for which it was successful in finding a path to their final destination.ipversion, interface
snmp.ipIfStatsOutDiscardsThe number of output IP datagrams for which no problem was encountered to prevent their transmission to their destination, but were discarded due to other reasons, for example lack of buffer space.ipversion, interface
snmp.ipIfStatsOutFragReqdsThe number of IP datagrams requiring fragmentation to be transmitted.ipversion, interface
snmp.ipIfStatsOutFragOKsThe number of IP datagrams successfully fragmented.ipversion, interface
snmp.ipIfStatsOutFragFailsThe number of IP datagrams discarded because they needed to be fragmented but could not be.ipversion, interface
snmp.ipIfStatsOutFragCreatesThe number of output datagram fragments generated as a result of IP fragmentation.ipversion, interface
snmp.ipIfStatsHCOutTransmitsThe total number of IP datagrams that this entity supplied to the lower layers for transmission.ipversion, interface
snmp.ipIfStatsHCOutOctetsThe total number of octets in IP datagrams delivered to the lower layers for transmission.ipversion, interface
snmp.ipIfStatsHCInMcastPktsThe number of IP multicast datagrams received.ipversion, interface
snmp.ipIfStatsHCInMcastOctetsThe total number of octets received in IP multicast datagrams.ipversion, interface
snmp.ipIfStatsHCOutMcastPktsThe number of IP multicast datagrams received.ipversion, interface
snmp.ipIfStatsHCOutMcastOctetsThe total number of octets transmitted in IP multicast datagrams.ipversion, interface
snmp.ipIfStatsHCInBcastPktsThe number of IP broadcast datagrams received.ipversion, interface
snmp.ipIfStatsHCOutBcastPktsThe number of IP broadcast datagrams transmitted.ipversion, interface
snmp.tcpActiveOpensThe number of times that TCP connections have made a direct transition to the SYN-SENT state from the CLOSED state.
snmp.tcpPassiveOpensThe number of times TCP connections have made a direct transition to the SYN-RCVD state from the LISTEN state.
snmp.tcpAttemptFailsThe number of times that TCP connections have made a direct transition to the CLOSED state from either the SYN-SENT state or the SYN-RCVD state, plus the number of times that TCP connections have made a direct transition to the LISTEN state from the SYN-RCVD state.
snmp.tcpEstabResetsThe number of times that TCP connections have made a direct transition to the CLOSED state from either the ESTABLISHED state or the CLOSE-WAIT state.
snmp.tcpCurrEstabThe number of TCP connections for which the current state is either ESTABLISHED or CLOSE-WAIT.
snmp.tcpHCInSegsThe total number of segments received, including those received in error.
snmp.tcpHCOutSegsThe total number of segments sent, including those on current connections but excluding those containing only retransmitted octets.
snmp.tcpRetransSegsThe total number of segments retransmitted; that is, the number of TCP segments transmitted containing one or more previously transmitted octets.
snmp.tcpInErrsThe total number of segments received in error (e.g., bad TCP checksums).
snmp.tcpOutRstsThe number of TCP segments sent containing the RST flag.
snmp.udpHCInDatagramsThe total number of UDP datagrams delivered to UDP users, for devices that can receive more than 1 million UDP datagrams per second.
snmp.udpNoPortsThe total number of received UDP datagrams for which there was no application at the destination port.
snmp.udpInErrorsThe number of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port.
snmp.udpHCOutDatagramsThe total number of UDP datagrams sent from this entity, for devices that can transmit more than 1 million UDP datagrams per second.
F5 BIG-IP profile

The F5 BIG-IP profile collects the following metrics.

MetricDescriptionTags
snmp.sysStatMemoryTotalThe total memory available in bytes for TMM (Traffic Management Module).
snmp.sysStatMemoryUsedThe memory in use in bytes for TMM (Traffic Management Module).
snmp.sysGlobalTmmStatMemoryTotalThe total memory available in bytes for TMM (Traffic Management Module).
snmp.sysGlobalTmmStatMemoryUsedThe memory in use in bytes for TMM (Traffic Management Module).
snmp.sysGlobalHostOtherMemoryTotalThe total other non-TMM memory in bytes for the system.
snmp.sysGlobalHostOtherMemoryUsedThe other non-TMM memory in bytes currently in use for the system.
snmp.sysGlobalHostSwapTotalThe total swap in bytes for the system.
snmp.sysGlobalHostSwapUsedThe swap in bytes currently in use for the system.
snmp.sysMultiHostCpuTableA table containing entries of system CPU usage information for a system.
snmp.sysMultiHostCpuUserThe time spent by the specified processor in user context for the associated host.cpu
snmp.sysMultiHostCpuNiceThe time spent by the specified processor running niced processes for the associated host.cpu
snmp.sysMultiHostCpuSystemThe time spent by the specified processor servicing system calls for the associated host.cpu
snmp.sysMultiHostCpuIdleThe time spent by the specified processor doing nothing for the associated host.cpu
snmp.sysMultiHostCpuIrqThe time spent by the specified processor servicing hardware interrupts for the associated host.cpu
snmp.sysMultiHostCpuSoftirqThe time spent by the specified processor servicing soft interrupts for the associated host.cpu
snmp.sysMultiHostCpuIowaitThe time spent by the specified processor waiting for external I/O to complete for the associated host.cpu
snmp.sysTcpStatOpenThe number of current open connections.
snmp.sysTcpStatCloseWaitThe number of current connections in CLOSE-WAIT/LAST-ACK.
snmp.sysTcpStatFinWaitThe number of current connections in FIN-WAIT/CLOSING.
snmp.sysTcpStatTimeWaitThe number of current connections in TIME-WAIT.
snmp.sysTcpStatAcceptsThe number of connections accepted.
snmp.sysTcpStatAcceptfailsThe number of connections not accepted.
snmp.sysTcpStatConnectsThe number of connections established.
snmp.sysTcpStatConnfailsThe number of connection failures.
snmp.sysUdpStatOpenThe number of current open connections.
snmp.sysUdpStatAcceptsThe number of connections accepted.
snmp.sysUdpStatAcceptfailsThe number of connections not accepted.
snmp.sysUdpStatConnectsThe number of connections established.
snmp.sysUdpStatConnfailsThe number of connection failures.
snmp.sysClientsslStatCurConnsThe current number of concurrent connections with established SSL sessions being maintained by the filter.
snmp.sysClientsslStatEncryptedBytesInThe total encrypted bytes received.
snmp.sysClientsslStatEncryptedBytesOutThe total encrypted bytes sent.
snmp.sysClientsslStatDecryptedBytesInThe total decrypted bytes received.
snmp.sysClientsslStatDecryptedBytesOutThe total decrypted bytes sent.
snmp.sysClientsslStatHandshakeFailuresThe total number of handshake failures.
snmp.ifInErrorsThe number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.interface
snmp.ifOutErrorsThe number of outbound packets that could not be transmitted because of errors.interface
snmp.ifAdminStatusThe desired state of the interface.interface
snmp.ifOperStatusThe current operational state of the interface.interface
snmp.tcpActiveOpensThe number of times TCP connections have made a direct transition to the SYN-SENT state from the CLOSED state.
snmp.tcpPassiveOpensThe number of times TCP connections have made a direct transition to the SYN-RCVD state from the LISTEN state.
snmp.tcpAttemptFailsThe number of times TCP connections have made a direct transition to the CLOSED state from either the SYN-SENT state or the SYN-RCVD state, plus the number of times that TCP connections have made a direct transition to the LISTEN state from the SYN-RCVD state.
snmp.tcpEstabResetsThe number of times TCP connections have made a direct transition to the CLOSED state from either the ESTABLISHED state or the CLOSE-WAIT state.
snmp.tcpCurrEstabThe number of TCP connections for which the current state is either ESTABLISHED or CLOSE-WAIT.
snmp.tcpHCInSegsThe total number of segments received including those received in error.
snmp.tcpHCOutSegsThe total number of segments sent including those on current connections but excluding those containing only retransmitted octets.
snmp.tcpRetransSegsThe total number of segments retransmitted, meaning the number of TCP segments transmitted containing one or more previously transmitted octets.
snmp.tcpInErrsThe total number of segments received due to errors such as bad TCP checksums.
snmp.tcpOutRstsThe number of TCP segments sent containing the RST flag.
snmp.udpHCInDatagramsThe total number of UDP datagrams delivered to UDP users for devices that can receive more than 1 million UDP datagrams per second.
snmp.udpNoPortsThe total number of received UDP datagrams for which there was no application at the destination port.
snmp.udpInErrorsThe number of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port.
snmp.udpHCOutDatagramsThe total number of UDP datagrams sent from this entity for devices that can transmit more than 1 million UDP datagrams per second.
Cisco c3850 device profile

The Cisco c3850 device profile collects the following metrics.

MetricDescriptionTags
snmp.entSensorValueThe most recent measurement seen by the sensor.sensor_id, sensor_type
snmp.cefcFRUPowerAdminStatusAdministratively desired FRU power state.fru
snmp.cefcFRUPowerOperStatusOperational FRU power state.fru
snmp.cefcFRUCurrentCurrent supplied by the FRU (positive values) or current required to operate the FRU (negative values).fru
snmp.cpmCPUTotalMonIntervalValueThe overall CPU busy percentage in the last cpmCPUMonInterval period.cpu
snmp.cpmCPUMemoryUsedThe overall CPU wide system memory currently in use.cpu
snmp.cpmCPUMemoryFreeThe overall CPU wide system memory currently free.cpu
snmp.cieIfLastInTimeThe elapsed time in milliseconds since the last protocol input packet was received.interface
snmp.cieIfLastOutTimeThe elapsed time in milliseconds since the last protocol output packet was transmitted.interface
snmp.cieIfInputQueueDropsThe number of input packets dropped.interface
snmp.cieIfOutputQueueDropsThe number of output packets dropped by the interface even though no error was detected to prevent them being transmitted.interface
snmp.cieIfResetCountThe number of times the interface was internally reset and brought up.interface
snmp.ifInErrorsThe number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.interface
snmp.ifOutErrorsThe number of outbound packets that could not be transmitted because of errors.interface
snmp.ifInDiscardsThe number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.interface
snmp.ifHCInOctetsThe total number of octets received on the interface including framing characters.interface
snmp.ifHCOutOctetsThe total number of octets transmitted out of the interface including framing characters.interface
snmp.ifOutDiscardsThe number of outbound packets chosen to be discarded even though no errors had been detected to prevent their being transmitted.interface
snmp.ifAdminStatusThe desired state of the interface.interface
snmp.ifOperStatusThe current operational state of the interface.interface
snmp.ifHCInOctetsThe total number of octets received on the interface including framing characters.interface
snmp.ifHCInUcastPktsThe number of packets delivered by this sub-layer to a higher (sub-)layer not addressed to a multicast or broadcast address at this sub-layer.interface
snmp.ifHCInBroadcastPktsThe number of packets delivered by this sub-layer to a higher (sub-)layer addressed to a broadcast address at this sub-layer.interface
snmp.ifHCOutOctetsThe total number of octets transmitted out of the interface including framing characters.interface
snmp.ifHCOutUcastPktsThe total number of packets that higher-level protocols requested be transmitted that were not addressed to a multicast or broadcast address at this sub-layer including those discarded or not sent.interface
snmp.ifHCOutMulticastPktsThe total number of packets that higher-level protocols requested be transmitted that were addressed to a multicast address at this sub-layer including those discarded or not sent.interface
snmp.ifHCOutBroadcastPktsThe total number of packets that higher-level protocols requested be transmitted addressed to a broadcast address at this sub-layer including those discarded or not sent.interface
Cisco Nexus Profile

The Cisco Nexus Profile collects the following metrics.

MetricDescriptionTags
snmp.entSensorValueThe most recent measurement seen by the sensor.sensor_type,sensor_id
snmp.cefcFRUPowerAdminStatusAdministratively desired FRU power state.fru
snmp.cefcFRUPowerOperStatusOperational FRU power state.fru
snmp.cefcFRUCurrentCurrent supplied by the FRU (positive values) or current required to operate the FRU (negative values).fru
snmp.cpmCPUTotalMonIntervalValueThe overall CPU busy percentage in the last cpmCPUMonInterval period.cpu
snmp.cpmCPUMemoryUsedThe overall CPU wide system memory which is currently under use.cpu
snmp.cpmCPUMemoryFreeThe overall CPU wide system memory which is currently free.cpu
snmp.cieIfResetCountThe number of times the interface was internally reset and brought up.interface
snmp.ifInErrorsThe number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.interface
snmp.ifOutErrorsThe number of outbound packets that could not be transmitted because of errors.interface
snmp.ifInDiscardsThe number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.interface
snmp.ifOutDiscardsThe number of outbound packets chosen to be discarded even though no errors had been detected to prevent their being transmitted.interface
snmp.ifAdminStatusThe desired state of the interface.interface
snmp.ifOperStatusThe current operational state of the interface.interface
snmp.ifHCInOctetsThe total number of octets received on the interface including framing characters.interface
snmp.ifHCInUcastPktsThe number of packets delivered by this sub-layer to a higher (sub-)layer not addressed to a multicast or broadcast address at this sub-layer.interface
snmp.ifHCInBroadcastPktsThe number of packets delivered by this sub-layer to a higher (sub-)layer addressed to a broadcast address at this sub-layer.interface
snmp.ifHCOutOctetsThe total number of octets transmitted out of the interface including framing characters.interface
snmp.ifHCOutUcastPktsThe total number of packets that higher-level protocols requested be transmitted that were not addressed to a multicast or broadcast address at this sub-layer including those discarded or not sent.interface
snmp.ifHCOutMulticastPktsThe total number of packets that higher-level protocols requested be transmitted that were addressed to a multicast address at this sub-layer including those discarded or not sent.interface
snmp.ifHCOutBroadcastPktsThe total number of packets that higher-level protocols requested be transmitted addressed to a broadcast address at this sub-layer including those discarded or not sent.interface
snmp.tcpActiveOpensThe number of times that TCP connections have made a direct transition to the SYN-SENT state from the CLOSED state.
snmp.tcpPassiveOpensThe number of times TCP connections have made a direct transition to the SYN-RCVD state from the LISTEN state.
snmp.tcpAttemptFailsThe number of times that TCP connections have made a direct transition to the CLOSED state from either the SYN-SENT state or the SYN-RCVD state, plus the number of times that TCP connections have made a direct transition to the LISTEN state from the SYN-RCVD state.
snmp.tcpEstabResetsThe number of times that TCP connections have made a direct transition to the CLOSED state from either the ESTABLISHED state or the CLOSE-WAIT state.
snmp.tcpCurrEstabThe number of TCP connections for which the current state is either ESTABLISHED or CLOSE-WAIT.
snmp.tcpHCInSegsThe total number of segments received, including those received in error.
snmp.tcpHCOutSegsThe total number of segments sent, including those on current connections but excluding those containing only retransmitted octets.
snmp.tcpRetransSegsThe total number of segments retransmitted; that is, the number of TCP segments transmitted containing one or more previously transmitted octets.
snmp.tcpInErrsThe total number of segments received in error (e.g., bad TCP checksums).
snmp.tcpOutRstsThe number of TCP segments sent containing the RST flag.
snmp.udpHCInDatagramsThe total number of UDP datagrams delivered to UDP users, for devices that can receive more than 1 million UDP datagrams per second.
snmp.udpNoPortsThe total number of received UDP datagrams for which there was no application at the destination port.
snmp.udpInErrorsThe number of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port.
snmp.udpHCOutDatagramsThe total number of UDP datagrams sent from this entity, for devices that can transmit more than 1 million UDP datagrams per second.
Cisco Meraki Profile

The Cisco Meraki device profile collects the following metrics.

MetricDescriptionTags
snmp.devStatusThe status of the device’s connection to the Meraki Cloud Controllerdevice, product, network
snmp.devClientCountThe number of clients currently associated with the device.device, product, network
snmp.devInterfaceSentPktsThe number of packets sent on this interface.interface
snmp.devInterfaceRecvPktsThe number of packets received on this interface.interface
snmp.devInterfaceSentBytesThe number of bytes sent on this interface.interface
snmp.devInterfaceRecvBytesThe number of bytes received on this interface.interface
Dell iDRAC Profile

The Dell iDRAC device profile collects the following metrics.

MetricDescriptionTags
snmp.systemStateChassisStatusThe status of this system chassis.chassis_index
snmp.systemStatePowerUnitStatusRedundancyThe combined redundancy status of all power units of this system.chassis_index
snmp.systemStatePowerSupplyStatusCombinedThe combined status of all power supplies of this system.chassis_index
snmp.systemStateAmperageStatusCombinedThe combined status of all amperage probes of this system.chassis_index
snmp.systemStatePowerSupplyStatusCombinedThe combined status of all power supplies of this system.chassis_index
snmp.systemStateCoolingUnitStatusRedundancyThe combined redundancy status of all cooling units of this system.chassis_index
snmp.systemStateCoolingDeviceStatusCombinedThe combined status of all cooling devices of this system.chassis_index
snmp.systemStateTemperatureStatusCombinedThe combined status of all temperature probes of this system.chassis_index
snmp.systemStateMemoryDeviceStatusCombinedThe combined status of all memory devices of this system.chassis_index
snmp.systemStateChassisIntrusionStatusCombinedThe combined status of all intrusion detection devices of this system chassis.chassis_index
snmp.systemStatePowerUnitStatusCombinedThe combined status of all power units of this chassis.chassis_index
snmp.systemStateCoolingUnitStatusCombinedThe combined status of all cooling units of this system.chassis_index
snmp.systemStateProcessorDeviceStatusCombinedThe combined status of all processor devices of this system.chassis_index
snmp.systemStateTemperatureStatisticsStatusCombinedThe combined status of all temperature statistics objects of this system.chassis_index
snmp.physicalDiskStateThe current state of this physical disk. Possible states: 1 - The current state could not be determined., 2 - The physical disk is available for use, but no RAID configuration has been assigned. 3- A RAID configuration has been assigned to the physical disk. 4- The physical disk has been moved from another controller and contains all or some portion of a virtual disk. 5 - The physical disk is not available to the RAID controller. 6 - The physical disk is currently blocked by controller. 7 - The physical disk is not operational. 8 - The physical disk is not a RAID capable disk. 9 - The physical disk has been removed. 10 - The physical disk media has been placed in read only mode.disk_name
snmp.physicalDiskCapacityInMBThe size of the physical disk in megabytes.snmp.disk_name
snmp.physicalDiskUsedSpaceInMBThe amount of used space in megabytes on the physical disk.disk_name
snmp.physicalDiskFreeSpaceInMBThe amount of free space in megabytes on the physical disk.disk_name
snmp.enclosurePowerSupplyStateThe current state of this power supply unit. Possible states: 1- The current state could not be determined. 2- The power supply unit is operating normally. 3- The power supply unit has encountered a hardware problem or is not responding. 4- The power supply unit is no longer connected to the enclosure or there exists a problem communicating to it. 5- The power supply unit is unstable.supply_name
snmp.adapterRxPacketsTotal packets received.adapter
snmp.adapterTxPacketsTotal packets transmitted.adapter
snmp.adapterRxBytesTotal number of bytes received.adapter
snmp.adapterTxBytesTotal number of bytes transmitted.adapter
snmp.adapterRxErrorsTotal number of packets received with errors (packets that failed to reach the protocol).adapter
snmp.adapterTxErrorsTotal number of packets that failed to transmit.adapter
snmp.adapterRxDroppedTotal number of receive packets dropped due to overrun.snmp.adapter
snmp.adapterTxDroppedTotal number of transmit packets dropped due to successive collisions.adapter
snmp.adapterRxMulticastTotal number of Multicast packets received.adapter
snmp.adapterCollisionsTotal number of single collisions.adapter

Validation

Run the Agent’s status subcommand and look for snmp under the Checks section.

Data Collected

Metrics

The SNMP check submits specified metrics under the snmp.* namespace.

Events

The SNMP check does not include any events.

Service Checks

snmp.can_check:
Returns CRITICAL if the Agent cannot collect SNMP metrics, otherwise returns OK.

Troubleshooting

Need help? Contact Datadog support.

Further Reading

Additional helpful documentation, links, and articles:


Mistake in the docs? Feel free to contribute!