2
0
mirror of https://github.com/munin-monitoring/contrib.git synced 2018-11-08 00:59:34 +01:00
contrib-munin/plugins/prosody/README.rst

61 lines
1.8 KiB
ReStructuredText
Raw Normal View History

munin-prosody
=============
Is a plugin for the monitoring software `munin <http://http://munin-monitoring.org/>`_ to monitor a `Prosody <http://prosody.im>`_ xmpp server.
This wildcard plugin provided at the moment only the **c2s**, **s2s**, **presence**, **uptime** and **users** suffixes.
.. image:: http://twattle.net/wp-content/uploads/munin/prosody_c2s-week.png
.. image:: http://twattle.net/wp-content/uploads/munin/prosody_s2s-week.png
.. image:: http://twattle.net/wp-content/uploads/munin/prosody_presence-week.png
.. image:: http://twattle.net/wp-content/uploads/munin/prosody_uptime-week.png
.. image:: http://twattle.net/wp-content/uploads/munin/prosody_users-week.png
Install
-------
It is very simple to install the plugin.
::
cd /usr/share/munin/plugins (or your munin plugins directory)
wget https://github.com/jarus/munin-prosody/raw/master/prosody_
chmod 755 prosody_
ln -s /usr/share/munin/plugins/prosody_ /etc/munin/plugins/prosody_c2s
ln -s /usr/share/munin/plugins/prosody_ /etc/munin/plugins/prosody_s2s
ln -s /usr/share/munin/plugins/prosody_ /etc/munin/plugins/prosody_presence
ln -s /usr/share/munin/plugins/prosody_ /etc/munin/plugins/prosody_uptime
ln -s /usr/share/munin/plugins/prosody_ /etc/munin/plugins/prosody_users
After the installation you need to restart your munin-node:
::
/etc/init.d/munin-node restart
Configuration
-------------
When you want to change the default host (localhost) and port (5582) than you can change this in the **/etc/munin/plugin-conf.d/munin-node** config file like this:
::
[prosody_*]
env.host example.com
env.port 5582
If you want to get the number of registered users, add the following lines to **/etc/munin/plugin-conf.d/munin-node**:
::
[prosody_users]
user prosody
group prosody