Difference between revisions of "Plugin:Ping"

From collectd Wiki
Jump to: navigation, search
(+Category:Plugins requiring privileges)
(Relicensed to MIT license.)
 
Line 5: Line 5:
 
   | Status={{supported}}
 
   | Status={{supported}}
 
   | FirstVersion={{Version|1.0}}
 
   | FirstVersion={{Version|1.0}}
   | Copyright=''2005–2009'' Florian octo Forster
+
   | Copyright=''2005–2012'' [[User:Octo|Florian Forster]]
   | License={{GPLv2}}
+
   | License={{MIT License}}
 
   | Manpage={{Manpage|collectd.conf|5|plugin_ping}}
 
   | Manpage={{Manpage|collectd.conf|5|plugin_ping}}
 
}}
 
}}

Latest revision as of 09:42, 21 May 2015

Ping plugin
Type: read
Callbacks: config, init, read, shutdown
Status: supported
First version: 1.0
Copyright: 2005–2012 Florian Forster
License: MIT license
Manpage: collectd.conf(5)
List of Plugins

Description

The Ping plugin measures network latency using ICMP “echo requests”, usually known as “ping”. Network latency is measured as a round-trip time. An ICMP “echo request” is sent to a host and the time needed for its echo-reply to arrive is measured. If a reply is not received within one second, the plugin will no longer expect a reply and return. This may happen in several circumstances, e. g. the packet is lost, the host is down, a router has dismissed the packet, …

This plugin is a generic plugin, i.e. it cannot work without configuration, because there is no reasonable default behavior. Please read the Plugin ping section of the collectd.conf(5) manual page for an in-depth description of the plugin's configuration.

Synopsis

<Plugin "ping">
  Host "example.com"
</Plugin>

Example graph

Plugin-ping.png

Dependencies