Skip to main content
Version: nightly

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