SNMP
Datadog's Research Report: The State of Serverless Report: The State of Serverless

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

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 and SNMP version 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 and a complete list of Datadog supported profiles can be found in Github. By default, all profiles shipped by the agent and in the configuration directory are loaded. To customize the specific profiles for collection, they can be explicitly referenced by filename 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 in the config, or simply dropped in the configuration directory. 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 parameter 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:

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.

Validation

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

Data Collected

The SNMP check submits specified metrics under the snmp.* namespace. Metrics collected depends on the integration being configured with the corresponding profile.

Metrics

snmp.adapterCollisions
(count)
[Dell iDRAC] Total number of single collisions.
snmp.adapterRxBytes
(count)
[Dell iDRAC] Total number of bytes received.
Shown as byte
snmp.adapterRxDropped
(count)
[Dell iDRAC] Total number of receive packets dropped due to overrun.
Shown as packet
snmp.adapterRxErrors
(count)
[Dell iDRAC] Total number of packets received with errors (packets that failed to reach the protocol).
Shown as packet
snmp.adapterRxMulticast
(count)
[Dell iDRAC] Total number of Multicast packets received.
Shown as packet
snmp.adapterRxPackets
(count)
[Dell iDRAC] Total packets received.
Shown as packet
snmp.adapterTxBytes
(count)
[Dell iDRAC] Total number of bytes transmitted.
Shown as byte
snmp.adapterTxDropped
(count)
[Dell iDRAC] Total number of transmit packets dropped due to successive collisions.
Shown as packet
snmp.adapterTxErrors
(count)
[Dell iDRAC] Total number of packets that failed to transmit.
Shown as packet
snmp.adapterTxPackets
(count)
[Dell iDRAC] Total packets transmitted.
Shown as packet
snmp.cefcFRUCurrent
(gauge)
[Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] Current supplied by the FRU (positive values) or current required to operate the FRU (negative values).
snmp.cefcFRUPowerAdminStatus
(gauge)
[Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] Administratively desired FRU power state.
snmp.cefcFRUPowerOperStatus
(gauge)
[Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] Operational FRU power state.
snmp.cieIfInputQueueDrops
(gauge)
[Cisco c3850] The number of input packets dropped.
Shown as packet
snmp.cieIfLastInTime
(gauge)
[Cisco c3850] The elapsed time in milliseconds since the last protocol input packet was received.
Shown as millisecond
snmp.cieIfLastOutTime
(gauge)
[Cisco c3850] The elapsed time in milliseconds since the last protocol output packet was transmitted.
Shown as millisecond
snmp.cieIfOutputQueueDrops
(gauge)
[Cisco c3850] The number of output packets dropped by the interface even though no error was detected to prevent them being transmitted.
Shown as packet
snmp.cieIfResetCount
(count)
[Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The number of times the interface was internally reset and brought up.
snmp.cpmCPUMemoryFree
(gauge)
[Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The overall CPU wide system memory currently free.
snmp.cpmCPUMemoryUsed
(gauge)
[Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The overall CPU wide system memory currently in use.
snmp.cpmCPUTotalMonIntervalValue
(gauge)
[Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The overall CPU busy percentage in the last cpmCPUMonInterval period.
Shown as percent
snmp.devClientCount
(gauge)
[Cisco Meraki] The number of clients currently associated with the device.
snmp.devInterfaceRecvBytes
(gauge)
[Cisco Meraki] The number of bytes received on this interface.
Shown as byte
snmp.devInterfaceRecvPkts
(gauge)
[Cisco Meraki] The number of packets received on this interface.
Shown as packet
snmp.devInterfaceSentBytes
(gauge)
[Cisco Meraki] The number of bytes sent on this interface.
Shown as byte
snmp.devInterfaceSentPkts
(gauge)
[Cisco Meraki] The number of packets sent on this interface.
Shown as packet
snmp.devStatus
(gauge)
[Cisco Meraki] The status of the device’s connection to the Meraki Cloud Controller
snmp.discovered_devices_count
(gauge)
The total number of devices discovered.
Shown as device
snmp.enclosurePowerSupplyState
(gauge)
[Dell iDRAC] The 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.
snmp.entSensorValue
(gauge)
[Cisco c3850] [Cisco Nexus] The most recent measurement seen by the sensor.
snmp.ifAdminStatus
(gauge)
[Generic router] [F5 BIG-IP] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The desired state of the interface.
snmp.ifHCInBroadcastPkts
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The number of packets delivered by this sub-layer to a higher (sub-)layer that were addressed to a broadcast address at this sub-layer.
Shown as packet
snmp.ifHCInOctets
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The total number of octets received on the interface including framing characters.
snmp.ifHCInUcastPkts
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The 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.
Shown as packet
snmp.ifHCOutBroadcastPkts
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The 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.
Shown as packet
snmp.ifHCOutMulticastPkts
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The 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.
Shown as packet
snmp.ifHCOutOctets
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The total number of octets transmitted out of the interface including framing characters.
snmp.ifHCOutUcastPkts
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The 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.
Shown as packet
snmp.ifInDiscards
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The 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.
Shown as packet
snmp.ifInErrors
(count)
[Generic router] [Cisco c3850] [Cisco Nexus][Cisco ASA 5525] [F5 BIG-IP] The number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.
Shown as packet
snmp.ifOperStatus
(gauge)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The current operational state of the interface.
snmp.ifOutDiscards
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The number of outbound packets chosen to be discarded even though no errors had been detected to prevent them being transmitted.
Shown as packet
snmp.ifOutErrors
(count)
[Generic router] [F5 BIG-IP] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The number of outbound packets that could not be transmitted because of errors.
Shown as packet
snmp.ipIfStatsHCInBcastPkts
(count)
[Generic router] The number of IP broadcast datagrams received.
Shown as datagram
snmp.ipIfStatsHCInDelivers
(count)
[Generic router] The total number of datagrams successfully delivered to IP user-protocols (including ICMP).
Shown as datagram
snmp.ipIfStatsHCInForwDatagrams
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipIfStatsHCInMcastOctets
(count)
[Generic router] The total number of octets received in IP multicast datagrams.
Shown as datagram
snmp.ipIfStatsHCInMcastPkts
(count)
[Generic router] The number of IP multicast datagrams received.
Shown as datagram
snmp.ipIfStatsHCInOctets
(count)
[Generic router] The total number of octets received in input IP datagrams including those received in error.
Shown as datagram
snmp.ipIfStatsHCOutBcastPkts
(count)
[Generic router] The number of IP broadcast datagrams transmitted.
Shown as datagram
snmp.ipIfStatsHCOutForwDatagrams
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipIfStatsHCOutMcastOctets
(count)
[Generic router] The total number of octets transmitted in IP multicast datagrams.
Shown as datagram
snmp.ipIfStatsHCOutMcastPkts
(count)
[Generic router] The number of IP multicast datagrams received.
Shown as datagram
snmp.ipIfStatsHCOutOctets
(count)
[Generic router] The total number of octets in IP datagrams delivered to the lower layers for transmission.
Shown as datagram
snmp.ipIfStatsHCOutRequests
(count)
[Generic router] The total number of IP datagrams that local IP user-protocols (including ICMP) supplied to IP in requests for transmission.
Shown as datagram
snmp.ipIfStatsHCOutTransmits
(count)
[Generic router] The total number of IP datagrams that this entity supplied to the lower layers for transmission.
Shown as datagram
snmp.ipIfStatsInAddrErrors
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipIfStatsInDiscards
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipIfStatsInHdrErrors
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipIfStatsInNoRoutes
(count)
[Generic router] The number of input IP datagrams discarded because no route could be found to transmit them to their destination.
Shown as datagram
snmp.ipIfStatsInTruncatedPkts
(count)
[Generic router] The number of input IP datagrams discarded because the datagram frame didn’t carry enough data.
Shown as datagram
snmp.ipIfStatsInUnknownProtos
(count)
[Generic router] The number of locally-addressed IP datagrams received successfully but discarded because of an unknown or unsupported protocol.
Shown as datagram
snmp.ipIfStatsOutDiscards
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipIfStatsOutFragCreates
(count)
[Generic router] The number of output datagram fragments generated as a result of IP fragmentation.
Shown as datagram
snmp.ipIfStatsOutFragFails
(count)
[Generic router] The number of IP datagrams discarded because they needed to be fragmented but could not be.
Shown as datagram
snmp.ipIfStatsOutFragOKs
(count)
[Generic router] The number of IP datagrams successfully fragmented.
Shown as datagram
snmp.ipIfStatsOutFragReqds
(count)
[Generic router] The number of IP datagrams requiring fragmentation to be transmitted.
Shown as datagram
snmp.ipIfStatsReasmFails
(count)
[Generic router] The number of failures detected by the IP reassembly algorithm (for whatever reason: timed out, errors, etc.).
snmp.ipIfStatsReasmOKs
(count)
[Generic router] The number of IP datagrams successfully reassembled.
Shown as datagram
snmp.ipIfStatsReasmReqds
(count)
[Generic router] The number of IP fragments received that needed to be reassembled at this interface.
snmp.ipSystemStatsHCInBcastPkts
(count)
[Generic router] The number of IP broadcast datagrams received.
Shown as datagram
snmp.ipSystemStatsHCInDelivers
(count)
[Generic router] The total number of datagrams successfully delivered to IP user-protocols (including ICMP).
Shown as datagram
snmp.ipSystemStatsHCInForwDatagrams
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipSystemStatsHCInMcastOctets
(count)
[Generic router] The total number of octets received in IP multicast datagrams.
Shown as datagram
snmp.ipSystemStatsHCInMcastPkts
(count)
[Generic router] The number of IP multicast datagrams received.
Shown as datagram
snmp.ipSystemStatsHCInOctets
(count)
[Generic router] The total number of octets received in input IP datagrams including those received in error.
snmp.ipSystemStatsHCInReceives
(count)
[Generic router] The total number of input IP datagrams received including those received in error.
Shown as datagram
snmp.ipSystemStatsHCOutBcastPkts
(count)
[Generic router] The number of IP broadcast datagrams transmitted.
Shown as datagram
snmp.ipSystemStatsHCOutForwDatagrams
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipSystemStatsHCOutMcastOctets
(count)
[Generic router] The total number of octets transmitted in IP multicast datagrams.
Shown as datagram
snmp.ipSystemStatsHCOutMcastPkts
(count)
[Generic router] The number of IP multicast datagrams transmitted.
Shown as datagram
snmp.ipSystemStatsHCOutOctets
(count)
[Generic router] The total number of octets in IP datagrams delivered to the lower layers for transmission.
Shown as datagram
snmp.ipSystemStatsHCOutRequests
(count)
[Generic router] The total number of IP datagrams that local IP user-protocols (including ICMP) supplied to IP in requests for transmission.
Shown as datagram
snmp.ipSystemStatsHCOutTransmits
(count)
[Generic router] The total number of IP datagrams that this entity supplied to the lower layers for transmission.
Shown as datagram
snmp.ipSystemStatsInAddrErrors
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipSystemStatsInDiscards
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipSystemStatsInHdrErrors
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipSystemStatsInNoRoutes
(count)
[Generic router] The number of input IP datagrams discarded because no route could be found to transmit them to their destination.
Shown as datagram
snmp.ipSystemStatsInTruncatedPkts
(count)
[Generic router] The number of input IP datagrams discarded because the datagram frame didn’t carry enough data.
Shown as datagram
snmp.ipSystemStatsInUnknownProtos
(count)
[Generic router] The number of locally-addressed IP datagrams received successfully but discarded because of an unknown or unsupported protocol.
Shown as datagram
snmp.ipSystemStatsOutDiscards
(count)
[Generic router] The 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.
Shown as datagram
snmp.ipSystemStatsOutFragCreates
(count)
[Generic router] The number of output datagram fragments generated as a result of IP fragmentation.
Shown as datagram
snmp.ipSystemStatsOutFragFails
(count)
[Generic router] The number of IP datagrams discarded because they needed to be fragmented but could not be.
Shown as datagram
snmp.ipSystemStatsOutFragOKs
(count)
[Generic router] The number of IP datagrams successfully fragmented.
Shown as datagram
snmp.ipSystemStatsOutFragReqds
(count)
[Generic router] The number of IP datagrams that would require fragmentation to be transmitted.
Shown as datagram
snmp.ipSystemStatsOutNoRoutes
(count)
[Generic router] The number of locally generated IP datagrams discarded because no route could be found to transmit them to their destination.
Shown as datagram
snmp.ipSystemStatsReasmFails
(count)
[Generic router] The number of failures detected by the IP reassembly algorithm (for whatever reason: timed out, errors, etc.).
snmp.ipSystemStatsReasmOKs
(count)
[Generic router] The number of IP datagrams successfully reassembled.
Shown as datagram
snmp.ipSystemStatsReasmReqds
(count)
[Generic router] The number of IP fragments received that needed to be reassembled at this interface.
snmp.physicalDiskCapacityInMB
(gauge)
[Dell iDRAC] The size of the physical disk in megabytes.
Shown as mebibyte
snmp.physicalDiskFreeSpaceInMB
(gauge)
[Dell iDRAC] The amount of free space in megabytes on the physical disk.
Shown as mebibyte
snmp.physicalDiskState
(gauge)
[Dell iDRAC] The current state of this physical disk. See Dell documentation to learn more: https://dtdg.co/snmp-physical-disk-state
snmp.physicalDiskUsedSpaceInMB
(gauge)
[Dell iDRAC] The amount of used space in megabytes on the physical disk.
Shown as mebibyte
snmp.sysClientsslStatCurConns
(gauge)
[F5 BIG-IP] The current number of concurrent connections with established SSL sessions being maintained by the filter.
snmp.sysClientsslStatDecryptedBytesIn
(count)
[F5 BIG-IP] The total decrypted bytes received.
Shown as byte
snmp.sysClientsslStatDecryptedBytesOut
(count)
[F5 BIG-IP] The total decrypted bytes sent.
Shown as byte
snmp.sysClientsslStatEncryptedBytesIn
(count)
[F5 BIG-IP] The total encrypted bytes received.
Shown as byte
snmp.sysClientsslStatEncryptedBytesOut
(count)
[F5 BIG-IP] The total encrypted bytes sent.
Shown as byte
snmp.sysClientsslStatHandshakeFailures
(count)
[F5 BIG-IP] The total number of handshake failures.
snmp.sysGlobalHostOtherMemoryTotal
(gauge)
[F5 BIG-IP] The total other non-TMM memory in bytes for the system.
Shown as byte
snmp.sysGlobalHostOtherMemoryUsed
(gauge)
[F5 BIG-IP] The other non-TMM memory in bytes currently in use for the system.
Shown as byte
snmp.sysGlobalHostSwapTotal
(gauge)
[F5 BIG-IP] The total swap in bytes for the system.
Shown as byte
snmp.sysGlobalHostSwapUsed
(gauge)
[F5 BIG-IP] The swap in bytes currently in use for the system.
Shown as byte
snmp.sysGlobalTmmStatMemoryTotal
(gauge)
[F5 BIG-IP] The total memory available in bytes for TMM (Traffic Management Module).
Shown as byte
snmp.sysGlobalTmmStatMemoryUsed
(gauge)
[F5 BIG-IP] The memory in use in bytes for TMM (Traffic Management Module).
Shown as byte
snmp.sysMultiHostCpuIdle
(gauge)
[F5 BIG-IP] The time spent by the specified processor doing nothing for the associated host.
snmp.sysMultiHostCpuIowait
(gauge)
[F5 BIG-IP] The time spent by the specified processor waiting for external I/O to complete for the associated host.
snmp.sysMultiHostCpuIrq
(gauge)
[F5 BIG-IP] The time spent by the specified processor servicing hardware interrupts for the associated host.
snmp.sysMultiHostCpuNice
(gauge)
[F5 BIG-IP] The time spent by the specified processor running niced processes for the associated host.
snmp.sysMultiHostCpuSoftirq
(gauge)
[F5 BIG-IP] The time spent by the specified processor servicing soft interrupts for the associated host.
snmp.sysMultiHostCpuSystem
(gauge)
[F5 BIG-IP] The time spent by the specified processor servicing system calls for the associated host.
snmp.sysMultiHostCpuUser
(gauge)
[F5 BIG-IP] The time spent by the specified processor in user context for the associated host.
snmp.sysStatMemoryTotal
(gauge)
[F5 BIG-IP] The total memory available in bytes for TMM (Traffic Management Module).
Shown as byte
snmp.sysStatMemoryUsed
(gauge)
[F5 BIG-IP] The memory in use in bytes for TMM (Traffic Management Module).
Shown as byte
snmp.sysTcpStatAcceptfails
(count)
[F5 BIG-IP] The number of connections not accepted.
snmp.sysTcpStatAccepts
(count)
[F5 BIG-IP] The number of connections accepted.
snmp.sysTcpStatCloseWait
(gauge)
[F5 BIG-IP] The number of current connections in CLOSE-WAIT/LAST-ACK.
snmp.sysTcpStatConnects
(count)
[F5 BIG-IP] The number of connections established.
snmp.sysTcpStatConnfails
(count)
[F5 BIG-IP] The number of connection failures.
snmp.sysTcpStatFinWait
(gauge)
[F5 BIG-IP] The number of current connections in FIN-WAIT/CLOSING.
snmp.sysTcpStatOpen
(gauge)
[F5 BIG-IP] The number of current open connections.
snmp.sysTcpStatTimeWait
(gauge)
[F5 BIG-IP] The number of current connections in TIME-WAIT.
snmp.systemStateAmperageStatusCombined
(gauge)
[Dell iDRAC] The combined status of all amperage probes of this system.
snmp.systemStateChassisIntrusionStatusCombined
(gauge)
[Dell iDRAC] The combined status of all intrusion detection devices of this system chassis.
snmp.systemStateChassisStatus
(gauge)
[Dell iDRAC] The status of this system chassis.
snmp.systemStateCoolingDeviceStatusCombined
(gauge)
[Dell iDRAC] The combined status of all cooling devices of this system.
snmp.systemStateCoolingUnitStatusCombined
(gauge)
[Dell iDRAC] The combined status of all cooling units of this system.
snmp.systemStateCoolingUnitStatusRedundancy
(gauge)
[Dell iDRAC] The combined redundancy status of all cooling units of this system.
snmp.systemStateMemoryDeviceStatusCombined
(gauge)
[Dell iDRAC] The combined status of all memory devices of this system.
snmp.systemStatePowerSupplyStatusCombined
(gauge)
[Dell iDRAC] The combined status of all power supplies of this system.
snmp.systemStatePowerUnitStatusCombined
(gauge)
[Dell iDRAC] The combined status of all power units of this chassis.
snmp.systemStatePowerUnitStatusRedundancy
(gauge)
[Dell iDRAC] The combined redundancy status of all power units of this system.
snmp.systemStateProcessorDeviceStatusCombined
(gauge)
[Dell iDRAC] The combined status of all processor devices of this system.
snmp.systemStateTemperatureStatisticsStatusCombined
(gauge)
[Dell iDRAC] The combined status of all temperature statistics objects of this system.
snmp.systemStateTemperatureStatusCombined
(gauge)
[Dell iDRAC] The combined status of all temperature probes of this system.
snmp.sysUdpStatAcceptfails
(count)
[F5 BIG-IP] The number of connections not accepted.
snmp.sysUdpStatAccepts
(count)
[F5 BIG-IP] The number of connections accepted.
snmp.sysUdpStatConnects
(count)
[F5 BIG-IP] The number of connections established.
snmp.sysUdpStatConnfails
(count)
[F5 BIG-IP] The number of connection failures.
snmp.sysUdpStatOpen
(gauge)
[F5 BIG-IP] The number of current open connections.
snmp.tcpActiveOpens
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The number of times that TCP connections have made a direct transition to the SYN-SENT state from the CLOSED state.
snmp.tcpAttemptFails
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The 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.tcpCurrEstab
(gauge)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The number of TCP connections for which the current state is either ESTABLISHED or CLOSE-WAIT.
snmp.tcpEstabResets
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The 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.tcpHCInSegs
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The total number of segments received, including those received in error.
Shown as segment
snmp.tcpHCOutSegs
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The total number of segments sent, including those on current connections but excluding those containing only retransmitted octets.
Shown as segment
snmp.tcpInErrs
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The total number of segments received in error (e.g., bad TCP checksums).
Shown as segment
snmp.tcpOutRsts
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The number of TCP segments sent containing the RST flag.
Shown as segment
snmp.tcpPassiveOpens
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The number of times TCP connections have made a direct transition to the SYN-RCVD state from the LISTEN state.
Shown as connection
snmp.tcpRetransSegs
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The total number of segments retransmitted; that is, the number of TCP segments transmitted containing one or more previously transmitted octets.
Shown as segment
snmp.udpHCInDatagrams
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The total number of UDP datagrams delivered to UDP users, for devices that can receive more than 1 million UDP datagrams per second.
Shown as datagram
snmp.udpHCOutDatagrams
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The total number of UDP datagrams sent from this entity, for devices that can transmit more than 1 million UDP datagrams per second.
Shown as datagram
snmp.udpInErrors
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The number of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port.
Shown as datagram
snmp.udpNoPorts
(count)
[Generic router] [Cisco c3850] [Cisco Nexus] [Cisco ASA 5525] The total number of received UDP datagrams for which there was no application at the destination port.
Shown as datagram
snmp.entPhySensorValue
(gauge)
[Cisco ASA 5525]The most recent measurement obtained by the agent for this sensor.
snmp.multiProcUserTime
(gauge)
[Checkpoint Firewall] Percentage of CPU utilization for user mode processes.
Shown as percent
snmp.multiProcSystemTime
(gauge)
[Checkpoint Firewall] Percentage of CPU utilization for kernel mode processes.
Shown as percent
snmp.multiProcIdleTime
(gauge)
[Checkpoint Firewall] Percentage of CPU idle time.
Shown as percent
snmp.multiProcUsage
(gauge)
[Checkpoint Firewall] Percentage of CPU utilization.
Shown as percent
snmp.procNum
(gauge)
[Checkpoint Firewall] Number of machine cores.
Shown as core
snmp.memTotalReal64
(gauge)
[Checkpoint Firewall] Total real memory in bytes. Memory used by applications.
Shown as byte
snmp.memActiveReal64
(gauge)
[Checkpoint Firewall] Active real memory (memory used by applications that is not cached to the disk) in bytes.
Shown as byte
snmp.memFreeReal64
(gauge)
[Checkpoint Firewall] Free memory available for applications in bytes.
Shown as byte
snmp.memTotalVirtual64
(gauge)
[Checkpoint Firewall] The size in bytes of the virtual-memory working segment pages.
Shown as byte
snmp.memActiveVirtual64
(gauge)
[Checkpoint Firewall] The size in bytes of the virtual-memory working segment pages that have actually been touched.
Shown as byte
snmp.multiDiskSize
(gauge)
[Checkpoint Firewall] Total partition size in bytes.
Shown as byte
snmp.multiDiskUsed
(gauge)
[Checkpoint Firewall] Disk used in partition in bytes.
Shown as byte
snmp.multiDiskFreeTotalBytes
(gauge)
[Checkpoint Firewall] Total free disk in partition in bytes.
Shown as byte
snmp.multiDiskFreeAvailableBytes
(gauge)
[Checkpoint Firewall] Available free disk in partition (not reserved by the OS) in bytes.
Shown as byte
snmp.multiDiskFreeTotalPercent
(gauge)
[Checkpoint Firewall] Percentage of total free disk in partition.
Shown as percent
snmp.multiDiskFreeAvailablePercent
(gauge)
[Checkpoint Firewall] Percentage of available free disk in partition.
Shown as percent
snmp.fanSpeedSensorValue
(gauge)
[Checkpoint Firewall] Fan rotations per minute.
Shown as hertz
snmp.fanSpeedSensorStatus
(gauge)
[Checkpoint Firewall] 0 = OK Otherwise = problem
snmp.tempertureSensorValue
(gauge)
[Checkpoint Firewall] Temperature in Celsius.
Shown as degree celsius
snmp.tempertureSensorStatus
(gauge)
[Checkpoint Firewall] 0 = OK Otherwise = Problem
snmp.fwAccepted
(gauge)
[Checkpoint Firewall] Number of accepted packets.
Shown as packet
snmp.fwDropped
(gauge)
[Checkpoint Firewall] Number of dropped packets.
Shown as packet
snmp.fwRejected
(gauge)
[Checkpoint Firewall] Number of rejected packets.
Shown as packet
snmp.fwNumConn
(gauge)
[Checkpoint Firewall] Number of concurrent IPv6 and IPv4 connections.
Shown as connection
snmp.fwPeakNumConn
(gauge)
[Checkpoint Firewall] Peak number of concurrent connections since last reboot.
Shown as connection

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: