M U N I N  -  M Y S Q L
                      =========================


Munin plugin for showing graphs of MySQL resource usage.


INSTALLATION
------------

 1) Install dependencies
 
     - munin-node
     - Perl modules: DBI, DBD::mysql
 
 2) Edit Makefile
 
 3) Edit mysql.conf
 
 4) Run `make install'


FURTHER INFORMATION
-------------------

The plugin documentation is contained in the plugin file as POD. View
it with perldoc.

View the project home page at
<http://oierud.name/~kjellm/bliki/ImprovedMuninGraphsForMySQL.html>

Mailing list 

 - munin-mysql@googlegroups.com
 - http://groups.google.com/group/munin-mysql

Source code is hosted at github
<http://github.com/kjellm/munin-mysql/>


TROUBLESHOOTING
---------------

- If you get warnings saying "Output from SHOW ENGINE INNDOB STATUS
  was truncated" that means that a very large deadlock are causing the
  output to be truncated. The consequence is that data for many of the
  InnoDB related data sources will be missing. For solutions to this
  problem see
  http://www.xaprb.com/blog/2006/08/08/how-to-deliberately-cause-a-deadlock-in-mysql/

- You can find some tips for debugging munin plugin problems here:
  <http://munin.projects.linpro.no/wiki/Debugging_Munin_plugins>

- If you still have problems, try asking on the mailing list.

- Bugs should be reported to the issue tracker on github
  <http://github.com/kjellm/munin-mysql/issues>


AUTHOR
------

Kjell-Magne Øierud <kjellm AT acm DOT org>

Inspired by the cacti graphs made by Xaprb
http://code.google.com/p/mysql-cacti-templates/ as viewed on
http://www.xaprb.com/blog/2008/05/25/screenshots-of-improved-mysql-cacti-templates/.

Initial version sponsored by Telenor <http://telenor.com/>

Later versions sponsored by Redpill Linpro <http://redpill-linpro.com>