telegraf/plugins/inputs/ping
Cameron Sparr 2eee1b84fb
break telegraf registry into separate package
this is for supporting external plugins.

external plugins will depend on a few telegraf interface types, as well
as a common telegraf registry.

this will allow external and internal plugins to both share this package
and make it easier to vendor/version the whole thing semantically, which
will make it easier to keep plugins supported across build and telegraf
versions.

see #1717
2017-02-06 11:16:29 +00:00
..
README.md ping: fix typo in README (#2163) 2016-12-14 19:47:48 +00:00
ping.go break telegraf registry into separate package 2017-02-06 11:16:29 +00:00
ping_test.go Standard deviation (jitter) for Input plugin Ping (#2078) 2016-12-16 13:58:27 +00:00
ping_windows.go break telegraf registry into separate package 2017-02-06 11:16:29 +00:00
ping_windows_test.go Fix problem with metrics when ping return Destination net unreachable ( windows ) (#1561) 2016-08-09 08:27:30 +01:00

README.md

Ping input plugin

This input plugin will measures the round-trip

Windows:

Configuration:

	## urls to ping
	urls = ["www.google.com"] # required
	
	## number of pings to send per collection (ping -n <COUNT>)
	count = 4 # required
	
	## Ping timeout, in seconds. 0 means default timeout (ping -w <TIMEOUT>)
	Timeout = 0

Measurements & Fields:

  • packets_transmitted ( from ping output )
  • reply_received ( increasing only on valid metric from echo replay, eg. 'Destination net unreachable' reply will increment packets_received but not reply_received )
  • packets_received ( from ping output )
  • percent_reply_loss ( compute from packets_transmitted and reply_received )
  • percent_packets_loss ( compute from packets_transmitted and packets_received )
  • errors ( when host can not be found or wrong prameters is passed to application )
  • response time
    • average_response_ms ( compute from minimum_response_ms and maximum_response_ms )
    • minimum_response_ms ( from ping output )
    • maximum_response_ms ( from ping output )

Tags:

  • server

Example Output:

* Plugin: ping, Collection 1
ping,host=WIN-PBAPLP511R7,url=www.google.com average_response_ms=7i,maximum_response_ms=9i,minimum_response_ms=7i,packets_received=4i,packets_transmitted=4i,percent_packet_loss=0,percent_reply_loss=0,reply_received=4i 1469879119000000000