Skip to content

collectd plugin for detailed disk I/O stats via /proc/diskstats

Notifications You must be signed in to change notification settings

PierreF/collectd-diskstats

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

collectd-diskstats is a collectd plugin (written in Python) that reads the
Linux 2.6 /proc/diskstats "file" and records detailed device statistics.

It is a superset of the "disk" plugin that ships with collectd. The main
difference is it records additional fields present in /proc/diskstats.

This plugin requires Collectd's Python plugin, which was introduced in
collectd 4.9. To configure, drop the diskstats.py file into a directory
where collectd is configured to find Python modules (ModulePath param).

The plugin must be explicitly told which disks to monitor. This is done
by defining "Disk" parameters inside the <Module> block for diskstats.
One "Disk" parameter per device. To see which devices are available, just
`cat /proc/diskstats`.

Here is an example configuration:

  <Plugin python>
      ModulePath "/path/to/modules"
      Import "diskstats"

      <Module diskstats>
          DeltaPerSecond no
          Disk sda
          Disk sda1
      </Module>
  </Plugin>

The plugin produces data for the "diskstats" plugin. The plugin instance
will be the device name. The plugin will write data for 10 types. The
type instance corresponds to the fields in /proc/iostats.

DeltaPerSecond option allow to send either data as delta per seconds or as
delta per measurement interval (collectd use 10 second by default). This change
is backward incompatible: mixing per-seconds and per-interval would be
meaningless.
DeltaPerSecond could be either "yes" or "no", and defaults to "no".

The Documentation/iostats.txt file in the Linux kernel source tree
(http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob_plain;f=Documentation/iostats.txt;hb=refs/tags/v2.6.36)
describes the fields in /proc/diskstats and can help you make sense of the
data.

About

collectd plugin for detailed disk I/O stats via /proc/diskstats

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%