• View
• Edit
• History
• Print

mod_netif

Description

The extensions (maximum of 4 metric per single device) for individual Ethernet devices are contained in a separate DSO module (written in C) called mod_netif. If installed, this DSO module is loaded during runtime/startup of gmond.

This DSO can be used to monitor individual Ethernet devices.

Platform availability: Linux only, minimum SLES 9 and higher or RHEL 4 and higher required

Config file: /etc/ganglia/conf.d/netif.conf

Available metrics

The following 4 additional metrics per device eth<X> (X=0,1,2,3,..., but also any device listed in /proc/net/dev can be specified, e.g., bond<X>) are available:

1. eth<X>_bytes_received
   • Number of bytes received per second via interface eth<X>
2. eth<X>_bytes_sent
   • Number of bytes sent per second via interface eth<X>
3. eth<X>_pkts_received
   • Number of packets received per second via interface eth<X>
4. eth<X>_pkts_sent
   • Number of packets sent per second via interface eth<X>

Config file example

modules {
  module {
    name = "netif_module"
    path = "modnetif.so"
  }
}

collection_group {
  collect_every = 15
  time_threshold = 60
  metric {
    name = "eth0_bytes_received"
    title = "eth0 Bytes Received"
    value_threshold = 1.0
  }
  metric {
    name = "eth0_bytes_sent"
    title = "eth0 Bytes Sent"
    value_threshold = 1.0
  }
  metric {
    name = "eth0_pkts_received"
    title = "eth0 Packets Received"
    value_threshold = 0.1
  }
  metric {
    name = "eth0_pkts_sent"
    title = "eth0 packets Sent"
    value_threshold = 0.1
  }

/*
  metric {
    name = "eth1_bytes_received"
    title = "eth1 Bytes Received"
    value_threshold = 1.0
  }
  metric {
    name = "eth1_bytes_sent"
    title = "eth1 Bytes Sent"
    value_threshold = 1.0
  }
  metric {
    name = "eth1_pkts_received"
    title = "eth1 Packets Received"
    value_threshold = 0.1
  }
  metric {
    name = "eth1_pkts_sent"
    title = "eth1 packets Sent"
    value_threshold = 0.1
  }
*/

}

Change History

• Version 1.0: Jun 27, 2011
  • initial version