From 96db9de96853d674456a395f490225b2dbe89333 Mon Sep 17 00:00:00 2001 From: Florian Forster Date: Thu, 30 Aug 2007 15:41:40 +0200 Subject: [PATCH] collectd.conf(5): Added informatioin about the netlink plugin. src/collectd.conf.in has been updated, too. --- src/collectd.conf.in | 9 +++++ src/collectd.conf.pod | 77 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 86 insertions(+) diff --git a/src/collectd.conf.in b/src/collectd.conf.in index d7b4ff46..292110ab 100644 --- a/src/collectd.conf.in +++ b/src/collectd.conf.in @@ -35,6 +35,7 @@ @BUILD_PLUGIN_MEMORY_TRUE@LoadPlugin memory @BUILD_PLUGIN_MULTIMETER_TRUE@LoadPlugin multimeter @BUILD_PLUGIN_MYSQL_TRUE@LoadPlugin mysql +@BUILD_PLUGIN_NETLINK_TRUE@LoadPlugin netlink @BUILD_PLUGIN_NETWORK_TRUE@LoadPlugin network @BUILD_PLUGIN_NFS_TRUE@LoadPlugin nfs @BUILD_PLUGIN_NTPD_TRUE@LoadPlugin ntpd @@ -131,6 +132,14 @@ # Database "db_name" # +# +# Interface "All" +# VerboseInterface "All" +# QDisc "eth0" "pfifo_fast-1:0" +# Class "ppp0" "htb-1:10" +# Filter "ppp0" "u32-1:0" +# + # # Server "ff18::efc0:4a42" "25826" # Server "239.192.74.66" "25826" diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod index 6413ff11..bd777bf3 100644 --- a/src/collectd.conf.pod +++ b/src/collectd.conf.pod @@ -420,6 +420,83 @@ option for what this plugin does. =back +=head2 Plugin C + +The C plugin uses a netlink socket to query the Linux kernel about +statistics of various interface and routing aspects. + +=over 4 + +=item B I + +=item B I + +Instruct the plugin to collect interface statistics. This is basically the same +as the statistics provided by the C plugin (see above) but +potentially much more detailed. + +When configuring with B only the basic statistics will be collected, +namely octets, packets, and errors. These statistics are collected by +the C plugin, too, so using both at the same time is no benefit. + +When configured with B all counters B the basic ones, +so that no data needs to be collected twice if you use the C plugin. +This includes dropped packets, received multicast packets, collisions and a +whole zoo of differentiated RX and TX errors. You can try the following command +to get an idea of what awaits you: + + ip -s -s link list + +If I is B, all interfaces will be selected. + +=item B I [I] + +=item B I [I] + +=item B I [I] + +Collect the octets and packets that pass a certain qdisc, class or filter. + +QDiscs and classes are identified by their type and handle (or classid). +Filters don't necessarily have a handle, therefore the parent's handle is used. +The notation used in collectd differs from that used in tc(1) in that it +doesn't skip the major or minor number if it's zero and doesn't print special +ids by their name. So, for example, a qdisc may be identified by +C even though the minor number of B qdiscs is zero and +thus not displayed by tc(1). + +If B, B, or B is given without the second argument, +i.E.e. without an identifier, all qdiscs, classes, or filters that are +associated with that interface will be collected. + +Since a filter itself doesn't necessarily have a handle, the parent's handle is +used. This may lead to problems when more than one filter is attached to a +qdisc or class. This isn't nice, but we don't know how this could be done any +better. If you have a idea, please don't hesitate to tell us. + +As with the B option you can specify B as the interface, +meaning all interfaces. + +Here are some examples to help you understand the above text more easily: + + + VerboseInterface "All" + QDisc "eth0" "pfifo_fast-1:0" + QDisc "ppp0" + Class "ppp0" "htb-1:10" + Filter "ppp0" "u32-1:0" + + +=item B + +The behaviour is the same as with all other similar plugins: If nothing is +selected at all, everything is collected. If some things are selected using the +options described above, only these statistics are collected. If you set +B to B, this behavior is inversed, i.Ee. the +specified statistics will not be collected. + +=back + =head2 Plugin C =over 4 -- 2.30.2