munin-plugins/prosody/loggrep_prosodyrcerts/README.md

# Prosody Remote Certificates
Is a plugin for the monitoring software [Munin](http://munin-monitoring.org) to monitor a [Prosody](http://prosody.im) 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](https://www.hot-chilli.net/munin/hot-chilli.net/tethys.hot-chilli.net/loggrep_prosodyrcerts.html)

## 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/munin-node/loggrep_prosodyrcerts* 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
```

Now you need to restart munin-node:

`/etc/init.d/munin-node restart`

That's it. Enjoy!