PingCollector

Collect icmp round trip times Only valid for ipv4 hosts currently

Dependencies

  • ping

Configuration

Configuration is done by:

Create a file named: PingCollector.conf in the collectors_config_path

  • enabled = true
  • interval = 60
  • target_1 = example.org
  • target_fw = 192.168.0.1
  • target_localhost = localhost

Test your configuration using the following command:

diamond-setup --print -C PingCollector

You should get a response back that indicates 'enabled': True and see entries for your targets in pairs like:

'target_1': 'example.org'

The graphite nodes pushed are derived from the pinged hostnames by replacing all dots with underscores, i.e. 'www.example.org' becomes 'www_example_org'.

Options

Setting Default Description Type
bin /bin/ping The path to the ping binary str
byte_unit byte Default numeric output(s) str
enabled False Enable collecting these metrics bool
measure_collector_time False Collect the collector run time in ms bool
metrics_blacklist None Regex to match metrics to block. Mutually exclusive with metrics_whitelist NoneType
metrics_whitelist None Regex to match metrics to transmit. Mutually exclusive with metrics_blacklist NoneType
sudo_cmd /usr/bin/sudo Path to sudo str
use_sudo False Use sudo? bool

Example Output

servers.hostname.ping.192_168_0_1 16
servers.hostname.ping.localhost 11
servers.hostname.ping.www_example_org 23