• View
• Edit
• History
• Print

mod_ibmnet

Description

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

This DSO can be used to monitor individual Ethernet devices as AIX libperfstat library (which could also be used) only sees Ethernet devices with a configured IP address. This is not the case for Shared Ethernet Adapters (SEA) on the Virtual I/O Server for instance.

The DSO works by calling the external /usr/bin/entstat command in periodic intervals to obtain the necessary performance data.

Platform availability: AIX only, minimum AIX5L V5.1 ML04 level or higher required

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

Available metrics

The following 4 additional metrics per device ent<X> (X=0,1,2,3,...) are available:

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

Config file example

modules {
  module {
    name = "ibmnet_module"
    path = "modibmnet.so"
  }
}

collection_group {
  collect_every = 15
  time_threshold = 60
  metric {
    name = "ent0_bytes_received"
    title = "ent0 Bytes Received"
    value_threshold = 1.0
  }
  metric {
    name = "ent0_bytes_sent"
    title = "ent0 Bytes Sent"
    value_threshold = 1.0
  }
  metric {
    name = "ent0_pkts_received"
    title = "ent0 Packets Received"
    value_threshold = 0.1
  }
  metric {
    name = "ent0_pkts_sent"
    title = "ent0 packets Sent"
    value_threshold = 0.1
  }

/*
  metric {
    name = "ent1_bytes_received"
    title = "ent1 Bytes Received"
    value_threshold = 1.0
  }
  metric {
    name = "ent1_bytes_sent"
    title = "ent1 Bytes Sent"
    value_threshold = 1.0
  }
  metric {
    name = "ent1_pkts_received"
    title = "ent1 Packets Received"
    value_threshold = 0.1
  }
  metric {
    name = "ent1_pkts_sent"
    title = "ent1 packets Sent"
    value_threshold = 0.1
  }
*/

}

Change History

• Version 1.1: May 06, 2011
  • changed method to detect all Ethernet adapters which are in state 'Available'
• Version 1.0: Jul 29, 2010
  • initial version