network

check_network

Checks the state and metrics of network interfaces.

Implementation

WindowsLinuxFreeBSDMacOSX

Examples

Default Check

check_network device=eth0
OK - eth0 >12 kB/s <28 kB/s |...

Example using NRPE and Naemon

Naemon Config

define command{
    command_name         check_nrpe
    command_line         $USER1$/check_nrpe -H $HOSTADDRESS$ -n -c $ARG1$ -a $ARG2$
}

define service {
    host_name            testhost
    service_description  check_network
    use                  generic-service
    check_command        check_nrpe!check_network!
}

Argument Defaults

ArgumentDefault Value
warningtotal > 80GB
criticaltotal > 90GB
empty-state3 (UNKNOWN)
empty-syntax%(status) - No devices found
top-syntax%(status) - %(list)
ok-syntax%(status) - %(list)
detail-syntax%(name) >%(sent) <%(received)

Check Specific Arguments

ArgumentDescription
devAlias for device
deviceThe device to check. Default is all
excludeExclude device by name
nameAlias for device

Attributes

Filter Keywords

these can be used in filters and thresholds (along with the default attributes):

AttributeDescription
MACThe MAC address
enabledTrue if the network interface is enabled (true/false)
nameName of the interface
net_connection_idsame as name
receivedBytes received per second (calculated over the last 30s)
total_receivedTotal bytes received
sentBytes sent per second (calculated over the last 30s)
total_sentTotal bytes sent
speedNetwork interface speed (in Mbits/sec)
flagsInterface flags
totalSum of sent and received bytes per second