Difference between revisions of "Plugin:Interface"

From collectd Wiki
Jump to: navigation, search
(Created initial page.)
 
 
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
= Description =
+
{{Infobox Plugin
 +
  | Name=Interface
 +
  | Type=read
 +
  | Callbacks={{Callback|config}}, {{Callback|init}}, {{Callback|read}}
 +
  | Status={{supported}}
 +
  | FirstVersion={{Version|1.0}}
 +
  | Copyright=''2005–2008'' Florian octo Forster<br />''2009'' Manuel Sanmartin
 +
  | License={{GPLv2}}
 +
  | Manpage={{Manpage|collectd.conf|5|plugin_interface}}
 +
}}
 +
== Description ==
  
The <em>Interface</em> plugin collects information about the traffic (octets), packets and errors of interfaces. If you're not interested in all interfaces but want to exclude some, or only collect information of some selected interfaces, you can select the "interesting" interfaces using the plugin's configuration.
+
The <em>Interface</em> plugin collects information about the traffic (octets per second), packets per second and errors of interfaces (of course number of errors during one second). If you're not interested in all interfaces but want to exclude some, or only collect information of some selected interfaces, you can select the “interesting” interfaces using the plugin's configuration.
  
= Synopsis =
+
== Synopsis ==
  
 
  <Plugin "interface">
 
  <Plugin "interface">
Line 11: Line 21:
 
  </Plugin>
 
  </Plugin>
  
= Example graphs =
+
== Example graphs ==
  
 
[[Image:Plugin-traffic.png]]
 
[[Image:Plugin-traffic.png]]
Line 17: Line 27:
 
[[Image:Plugin-traffic-if errors.png]]
 
[[Image:Plugin-traffic-if errors.png]]
  
= Dependencies =
+
== Dependencies ==
  
 
* Linux
 
* Linux
Line 25: Line 35:
 
* Mac OS X / Dawin, possibly others
 
* Mac OS X / Dawin, possibly others
 
** <code>getifaddrs</code>
 
** <code>getifaddrs</code>
 +
* AIX
 +
** ''libperfstat(3)''
 +
* FreeBSD
 +
** none
 
* Other
 
* Other
 
** [http://www.i-scream.org/libstatgrab/ libstatgrab]
 
** [http://www.i-scream.org/libstatgrab/ libstatgrab]
 +
 +
== See also ==
 +
 +
* [https://ssc-serv.com/interface.shtml Interface plugin] of [[SSC Serv]].
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 +
[[Category:Version 4.9]]
 +
{{DEFAULTSORT:Interface}}

Latest revision as of 17:02, 11 March 2016

Interface plugin
Type: read
Callbacks: config, init, read
Status: supported
First version: 1.0
Copyright: 2005–2008 Florian octo Forster
2009 Manuel Sanmartin
License: GPLv2
Manpage: collectd.conf(5)
List of Plugins

Description

The Interface plugin collects information about the traffic (octets per second), packets per second and errors of interfaces (of course number of errors during one second). If you're not interested in all interfaces but want to exclude some, or only collect information of some selected interfaces, you can select the “interesting” interfaces using the plugin's configuration.

Synopsis

<Plugin "interface">
  Interface "lo"
  Interface "sit0"
  IgnoreSelected true
</Plugin>

Example graphs

Plugin-traffic.png Plugin-traffic-if packets.png Plugin-traffic-if errors.png

Dependencies

  • Linux
    • /proc-file system
  • Solaris
    • kstat_read(3KSTAT)
  • Mac OS X / Dawin, possibly others
    • getifaddrs
  • AIX
    • libperfstat(3)
  • FreeBSD
    • none
  • Other

See also