https://github.com/laetho/collectd-python-iostat

Python plugin for collectd that handle iostat output
https://github.com/laetho/collectd-python-iostat

Last synced: about 1 year ago
JSON representation

Python plugin for collectd that handle iostat output

• Host: GitHub
• URL: https://github.com/laetho/collectd-python-iostat
• Owner: laetho
• License: mit
• Created: 2014-12-17T16:02:02.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2014-12-19T08:13:06.000Z (over 11 years ago)
• Last Synced: 2025-01-20T08:49:45.549Z (over 1 year ago)
• Language: Python
• Size: 156 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
collectd-python-iostat

======================

collectd-python-iostat is a Python plugin for collectd that parse Linux iostat output and enable graphing in graphite or other output formats.

The plugin is based on information gleaned from [deniszh's collectd-iostat-python](https://github.com/deniszh/collectd-iostat-python) but his project contains no actual code. This readme also contain information adapted from deniszh's project.

Status

------

The state of the plugin can be considered proof-of-concept. The code works for me, but needs some more work to become more mature and generic. As an example the config options are not really used for anything yet.

Setup

-----

Deploy the collectd python plugin into a suitable plugin directory for your collectd instance.

Configure collectd's python plugin to execute the iostat plugin using a stanza similar to the following:

    

        Globals true

    

    

        ModulePath "/usr/lib/collectd/plugins/python"

        Import "collectd_iostat_python"

        

            Path "/usr/bin/iostat"

            Interval 10

            Verbose False

        

    

Once functioning, the iostat data should then be visible via your various output plugins.

In the case of Graphite, collectd should be writing data to graphite in the *hostname_domain_tld.iostat.DEVICE.gauge.column-name* style.

Technical notes

---------------

For parsing iostat output I'm using [jakamkon's](https://bitbucket.org/jakamkon) [python-iostat](https://bitbucket.org/jakamkon/python-iostat) python module, but as internal part of script instead of separate module because of couple of fixes.

Contact

-------

[Email - Lars Erik Thorsplass](mailto:thorsplass@gmail.com)