connectivity plugin¶

connectivity - Documentation of collectd's connectivity plugin


Plugin name	`connectivity`
Configuration	collectd.conf(5)

Configuration examples¶

This page contains some example configurations for the connectivity plugin. This page is meant as a cookbook, so if you have a configuration for an aspect not handled here or a daemon not present, please feel free to add anything that's useful for you.

Monitoring all interfaces¶

This example shows the connectivity plugin monitoring all interfaces.

  LoadPlugin connectivity
  <Plugin connectivity>
  </Plugin>

Monitoring specific interfaces¶

This example shows connectivity plugin monitoring 2 interfaces, "eth0" and "eth1".

 LoadPlugin connectivity
 <Plugin connectivity>
   Interface eth0
   Interface eth1
 </Plugin>

Excluding interfaces¶

This example shows the connectivity plugin monitoring all interfaces except "eth1".

 LoadPlugin connectivity
 <Plugin connectivity>
   Interface eth1
   IgnoreSelected true
 </Plugin>

Configuration¶

Configuration options · from collectd.conf(5)

See this section in the full configuration reference

connectivity - Documentation of collectd's connectivity plugin

LoadPlugin connectivity
# ...
<Plugin connectivity>
  Interface eth0
</Plugin>

The connectivity plugin queries interface status using netlink (man 7 netlink) which provides information about network interfaces via the NETLINK_ROUTE family (man 7 rtnetlink). The plugin translates the value it receives to collectd's internal format and, depending on the write plugins you have loaded, it may be written to disk or submitted to another instance. The plugin listens to interfaces enumerated within the plugin configuration (see below). If no interfaces are listed, then the default is for all interfaces to be monitored.

This example shows connectivity plugin monitoring all interfaces. LoadPlugin connectivity <Plugin connectivity> </Plugin>

This example shows connectivity plugin monitoring 2 interfaces, "eth0" and "eth1". LoadPlugin connectivity <Plugin connectivity> Interface eth0 Interface eth1 </Plugin>

This example shows connectivity plugin monitoring all interfaces except "eth1". LoadPlugin connectivity <Plugin connectivity> Interface eth1 IgnoreSelected true </Plugin>

Interface interface_name: interface(s) to monitor connect to.