https://github.com/indygreg/collectd-diskstats

collectd plugin for detailed disk I/O stats via /proc/diskstats
https://github.com/indygreg/collectd-diskstats

Last synced: about 1 year ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/indygreg/collectd-diskstats
• Owner: indygreg
• Created: 2010-12-30T05:47:21.000Z (over 15 years ago)
• Default Branch: master
• Last Pushed: 2015-08-31T09:13:28.000Z (almost 11 years ago)
• Last Synced: 2025-03-25T04:28:30.541Z (about 1 year ago)
• Language: Python
• Homepage:
• Size: 148 KB
• Stars: 16
• Watchers: 4
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README

Awesome Lists containing this project

README

          
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  block for diskstats.

One "Disk" parameter per device. To see which devices are available, just

`cat /proc/diskstats`.

Here is an example configuration:

  

      ModulePath "/path/to/modules"

      Import "diskstats"

      

          Disk sda

          Disk sda1

      

  

The plugin produces data for the "diskstats" plugin. The plugin instance

will be the device name. The plugin will write gauge data for 10 types. The

type instance corresponds to the fields in /proc/iostats.

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.