munin-plugins/prosody/loggrep_prosodyrcerts/README.md

Prosody Remote Certificates

Is a plugin for the monitoring software Munin to monitor a Prosody XMPP server.

The plugins monitors the status of the certificates a remote server uses to connect to the local server.

Here's an example how how this plugin works: Prosody Remote Certificates statistics for jabber.hot-chilli.net

Installation and configuration

It is very simple to install this plugin.

Create symlink:

ln -s /usr/share/munin/plugins/loggrep /etc/munin/plugins/loggrep_prosodyrcerts

Create a file /etc/munin/plugin-conf.d/loggrep_prosodyrcerts (we don't want change the standard file /etc/munin/plugin-conf.d/munin-node as future updates might want to undo the changes) and put the following into it:

[loggrep_prosodyrcerts]
user root
env.regex_trustedvalid has a trusted valid certificate with
env.label_trustedvalid trusted valid
env.regex_trustedinvalid has a trusted invalid certificate with
env.label_trustedinvalid trusted invalid
env.regex_untrustedinvalid has a untrusted invalid certificate with
env.label_untrustedinvalid untrusted invalid
env.logfile /var/log/prosody/prosody.log
env.title Prosody remote certificates

Edit /etc/munin/munin.conf - in our case we have a Munin host named tethys.hot-chilli.net, please add it under the specifications for your own host:

[tethys.hot-chilli.net]
    address 127.0.0.1
    ...
    loggrep_prosodyrcerts.graph_category prosody
    loggrep_prosodyrcerts.graph_period minute

Now you need to restart munin-node:

/etc/init.d/munin-node restart

That's it. Enjoy!