Monitor latency for directories/files/devices (ioping.plugin)
The ioping plugin supports monitoring latency for any number of directories/files/devices,
by pinging them with ioping
.
A recent version of ioping
is required (one that supports option -N
).
The supplied plugin can install it, by running:
/usr/libexec/netdata/plugins.d/ioping.plugin install
The -e
option can be supplied to indicate where the Netdata environment file is installed. The default path is /etc/netdata/.environment
.
The above will download, build and install the right version as /usr/libexec/netdata/plugins.d/ioping
.
Then you need to edit /etc/netdata/ioping.conf
(to edit it on your system run
/etc/netdata/edit-config ioping.conf
) like this:
ioping="/usr/libexec/netdata/plugins.d/ioping"
destination="destination"
update_every="1s"
request_size="4k"
ioping_opts="-T 1000000 -R"
alarms
Netdata will automatically attach a few alarms for each host. Check the latest versions of the ioping alarms
Multiple ioping Plugins With Different Settings
You may need to run multiple ioping plugins with different settings or different end points. For example, you may need to ping one destination once per 10 seconds, and another once per second.
Netdata allows you to add as many ioping
plugins as you like.
Follow this procedure:
1. Create New ioping Configuration File
cd /etc/netdata
cp ioping.conf ioping2.conf
Edit ioping2.conf
and set the settings and the destination you need for the seconds instance.
2. Soft Link Original ioping Plugin to New Plugin File
sudo su
cd /usr/libexec/netdata/plugins.d
ln -s ioping.plugin ioping2.plugin
That's it. Netdata will detect the new plugin and start it.
You can name the new plugin any name you like. Just make sure the plugin and the configuration file have the same name.
Was this page helpful?
Contribute
- Join our community forum
- Learn how to contribute to Netdata's open-source project
- Submit a feature request