Skip to content

protocols plugin

Plugin name protocols
Type read
Callbacks config, read
Status supported
Since 4.7
Copyright 2009–2010 Florian Forster
License MIT License
Configuration collectd.conf(5)

The Protocols plugin collects information about the network protocols supported by the system, for example Internet Protocol (IP) and Transmission Control Protocol (TCP). Currently the plugin is only available under Linux and reads its information from the following two files in the /proc file-system:

  • /proc/net/snmp
  • /proc/net/netstat

Because the available information is usually far too much to be useful, the interesting values can be selected using the configuration file.

Synopsis

 <Plugin "protocols">
   Value "Icmp:InDestUnreachs"
   Value "/^Icmp:.*Echo/"
   IgnoreSelected false
 </Plugin>

Example graphs

None yet. Add one now!

Dependencies

  • Linux
    • /proc-file system

Configuration

Configuration options · from collectd.conf(5)

See this section in the full configuration reference

Collects a lot of information about various network protocols, such as IP, TCP, UDP, etc.

Available configuration options:

Value Selector

Selects whether or not to select a specific value. The string being matched is of the form "Protocol:ValueName", where Protocol will be used as the plugin instance and ValueName will be used as type instance. An example of the string being used would be Tcp:RetransSegs.

You can use regular expressions to match a large number of values with just one configuration option. To select all "extended" TCP values, you could use the following statement:

Value "/^TcpExt:/"

Whether only matched values are selected or all matched values are ignored depends on the IgnoreSelected. By default, only matched values are selected. If no value is configured at all, all values will be selected.

See /"IGNORELISTS" for details.

IgnoreSelected true|false
If set to true, inverts the selection made by Value, i. e. all matching values will be ignored.