gmond plugin¶


Plugin name	`gmond`
Type	other
Callbacks	config, init, shutdown
Status	supported
Since	4.7
Copyright	2009 Florian Forster
License	MIT License
Configuration	collectd.conf(5)

The gmond plugin subscribes to a Multicast group to receive data from gmond, the client daemon of the Ganglia project. These values are mapped to types known to collectd and submitted to the system.

Built-in mappings¶

To map data collected by Ganglia to collectd's “types”, some additional information is necessary. You can specify this information in the configuration file, but for some common data the appropriate information is already built-in. The Ganglia metrics that are understood without configuration are:

System load load_one, load_five, load_fifteen
CPU usage cpu_user, cpu_system, cpu_idle, cpu_nice, cpu_wio
Memory usage mem_free, mem_shared, mem_buffers, mem_cached, mem_total
Network traffic (octets) bytes_in, bytes_out
Network traffic (packets) pkts_in, pkts_out

Synopsis¶

 <Plugin "gmond">
   MCReceiveFrom "239.2.11.71" "8649"
   <Metric "swap_total">
     Type "swap"
     TypeInstance "total"
     DataSource "value"
   </Metric>
   <Metric "swap_free">
     Type "swap"
     TypeInstance "free"
     DataSource "value"
   </Metric>
 </Plugin>

Example graphs¶

None yet. Add one now!

Dependencies¶

libganglia

Configuration¶

Configuration options · from collectd.conf(5)

See this section in the full configuration reference

The gmond plugin received the multicast traffic sent by gmond, the statistics collection daemon of Ganglia. Mappings for the standard "metrics" are built-in, custom mappings may be added via Metric blocks, see below.

Synopsis:

<Plugin "gmond">
  MCReceiveFrom "239.2.11.71" "8649"
  <Metric "swap_total">
    Type "swap"
    TypeInstance "total"
    DataSource "value"
  </Metric>
  <Metric "swap_free">
    Type "swap"
    TypeInstance "free"
    DataSource "value"
  </Metric>
</Plugin>

The following metrics are built-in:

load_one, load_five, load_fifteen
cpu_user, cpu_system, cpu_idle, cpu_nice, cpu_wio
mem_free, mem_shared, mem_buffers, mem_cached, mem_total
bytes_in, bytes_out
pkts_in, pkts_out

Available configuration options:

MCReceiveFrom MCGroup [Port]

Sets sets the multicast group and UDP port to which to subscribe.

Default: 239.2.11.71 / 8649

<Metric Name>

These blocks add a new metric conversion to the internal table. Name, the string argument to the Metric block, is the metric name as used by Ganglia.

Type Type: Type to map this metric to. Required.
TypeInstance Instance: Type-instance to use. Optional.
DataSource Name: Data source to map this metric to. If the configured type has exactly one data source, this is optional. Otherwise the option is required.