From 193bafb7bfd97ee55815d74e18b043042e746432 Mon Sep 17 00:00:00 2001
From: dipohl <contact@dipohl.de>
Date: Wed, 22 Feb 2017 16:54:59 +0100
Subject: [PATCH 1/2] Try to reduce hierarchy to level 1

---
 .../{ejabberd_resources_ => }/ejabberd_resources_   |   0
 .../{ejabberd_scanlog => }/ejabberd_scanlog         |   0
 .../ejabberd/{ejabberd_stats_ => }/ejabberd_stats_  |   0
 .../example-graphs/ejabberd_resources_-month.png    | Bin
 .../example-graphs/ejabberd_scanlog-day.png         | Bin
 .../example-graphs/ejabberd_stats_-day.png          | Bin
 6 files changed, 0 insertions(+), 0 deletions(-)
 rename plugins/ejabberd/{ejabberd_resources_ => }/ejabberd_resources_ (100%)
 rename plugins/ejabberd/{ejabberd_scanlog => }/ejabberd_scanlog (100%)
 rename plugins/ejabberd/{ejabberd_stats_ => }/ejabberd_stats_ (100%)
 rename plugins/ejabberd/{ejabberd_resources_ => }/example-graphs/ejabberd_resources_-month.png (100%)
 rename plugins/ejabberd/{ejabberd_scanlog => }/example-graphs/ejabberd_scanlog-day.png (100%)
 rename plugins/ejabberd/{ejabberd_stats_ => }/example-graphs/ejabberd_stats_-day.png (100%)

diff --git a/plugins/ejabberd/ejabberd_resources_/ejabberd_resources_ b/plugins/ejabberd/ejabberd_resources_
similarity index 100%
rename from plugins/ejabberd/ejabberd_resources_/ejabberd_resources_
rename to plugins/ejabberd/ejabberd_resources_
diff --git a/plugins/ejabberd/ejabberd_scanlog/ejabberd_scanlog b/plugins/ejabberd/ejabberd_scanlog
similarity index 100%
rename from plugins/ejabberd/ejabberd_scanlog/ejabberd_scanlog
rename to plugins/ejabberd/ejabberd_scanlog
diff --git a/plugins/ejabberd/ejabberd_stats_/ejabberd_stats_ b/plugins/ejabberd/ejabberd_stats_
similarity index 100%
rename from plugins/ejabberd/ejabberd_stats_/ejabberd_stats_
rename to plugins/ejabberd/ejabberd_stats_
diff --git a/plugins/ejabberd/ejabberd_resources_/example-graphs/ejabberd_resources_-month.png b/plugins/ejabberd/example-graphs/ejabberd_resources_-month.png
similarity index 100%
rename from plugins/ejabberd/ejabberd_resources_/example-graphs/ejabberd_resources_-month.png
rename to plugins/ejabberd/example-graphs/ejabberd_resources_-month.png
diff --git a/plugins/ejabberd/ejabberd_scanlog/example-graphs/ejabberd_scanlog-day.png b/plugins/ejabberd/example-graphs/ejabberd_scanlog-day.png
similarity index 100%
rename from plugins/ejabberd/ejabberd_scanlog/example-graphs/ejabberd_scanlog-day.png
rename to plugins/ejabberd/example-graphs/ejabberd_scanlog-day.png
diff --git a/plugins/ejabberd/ejabberd_stats_/example-graphs/ejabberd_stats_-day.png b/plugins/ejabberd/example-graphs/ejabberd_stats_-day.png
similarity index 100%
rename from plugins/ejabberd/ejabberd_stats_/example-graphs/ejabberd_stats_-day.png
rename to plugins/ejabberd/example-graphs/ejabberd_stats_-day.png

From db240286ab7959ff7fbc1fb77117664f2a5473fe Mon Sep 17 00:00:00 2001
From: dipohl <contact@dipohl.de>
Date: Wed, 22 Feb 2017 18:11:54 +0100
Subject: [PATCH 2/2] Category Tree: Reduce number of categories, add pod doc

---
 plugins/djabberd/djabberd_           |   2 +-
 plugins/ejabberd/ejabberd_resources_ |   2 +-
 plugins/ejabberd/ejabberd_scanlog    |   2 +-
 plugins/ejabberd/ejabberd_stats_     |   4 +-
 plugins/prosody/prosody_             | 106 +++++++++++++++++++++++++--
 5 files changed, 106 insertions(+), 10 deletions(-)

diff --git a/plugins/djabberd/djabberd_ b/plugins/djabberd/djabberd_
index 46e7227f..14dea8f2 100644
--- a/plugins/djabberd/djabberd_
+++ b/plugins/djabberd/djabberd_
@@ -206,7 +206,7 @@ elsif ( $ARGV[0] and $ARGV[0] eq "config" ) {
     print "graph_title " . $mode->{'title'} . "\n";
     print "graph_vlabel " . $mode->{'vlabel'} . "\n";
     print "graph_args -l 0\n";
-    print "graph_category jabber\n";
+    print "graph_category chat\n";
     foreach my $field_name ( keys %{ $mode->{'fields'} } ) {
         my $label = $mode->{'fields'}->{$field_name}->{'label'}       || $field_name;
         my $desc  = $mode->{'fields'}->{$field_name}->{'description'} || $mode->{'fields'}->{$field_name}->{'key'};
diff --git a/plugins/ejabberd/ejabberd_resources_ b/plugins/ejabberd/ejabberd_resources_
index e04b0090..d820b2de 100755
--- a/plugins/ejabberd/ejabberd_resources_
+++ b/plugins/ejabberd/ejabberd_resources_
@@ -306,7 +306,7 @@ SUGGESTIONS
 		cat <<CONFIG
 graph_title ejabberd resources - ${RESOURCE_TYPE//_/ }
 graph_args --base $RESOURCE_BASE --lower-limit 0
-graph_category jabber
+graph_category chat
 CONFIG
 		;;
 esac
diff --git a/plugins/ejabberd/ejabberd_scanlog b/plugins/ejabberd/ejabberd_scanlog
index 381d799a..10dd1a5e 100755
--- a/plugins/ejabberd/ejabberd_scanlog
+++ b/plugins/ejabberd/ejabberd_scanlog
@@ -144,7 +144,7 @@ if ARGV.first == 'config'
 	puts <<CONFIG
 graph_title Ejabberd Log
 graph_vlabel total
-graph_category jabber
+graph_category chat
 graph_args -l 0
 CONFIG
 end
diff --git a/plugins/ejabberd/ejabberd_stats_ b/plugins/ejabberd/ejabberd_stats_
index d2bfb584..dac2b196 100755
--- a/plugins/ejabberd/ejabberd_stats_
+++ b/plugins/ejabberd/ejabberd_stats_
@@ -33,7 +33,7 @@ graph_title ejabberd stats - connected users
 graph_args --base 1000 --lower-limit 0
 graph_vlabel users
 graph_info The number of currently connected users, as of ejabberd report
-graph_category jabber
+graph_category chat 
 graph_order active
 connected.label Connected users
 connected.draw AREA
@@ -52,7 +52,7 @@ function ejabberd_stats_s2s() {
 graph_title ejabberd stats - s2s connections
 graph_args --lower-limit 0
 graph_vlabel active connections
-graph_category jabber
+graph_category chat
 graph_order incoming outgoing
 incoming.label incoming s2s
 incoming.info ejabberdctl $ejabberdctl_cmd_in
diff --git a/plugins/prosody/prosody_ b/plugins/prosody/prosody_
index 17d3da29..f121e45b 100644
--- a/plugins/prosody/prosody_
+++ b/plugins/prosody/prosody_
@@ -46,7 +46,7 @@ def main():
         if mode == "config":
             print "graph_title Prosody C2S Connections"
             print "graph_vlabel users"
-            print "graph_category Prosody"
+            print "graph_category chat"
 
             print "all_client_connections.label client connections"
             print "secure_client_connections.label secure client connections"
@@ -81,7 +81,7 @@ def main():
         if mode == "config":
             print "graph_title Prosody S2S Connections"
             print "graph_vlabel servers"
-            print "graph_category Prosody"
+            print "graph_category chat"
 
             print "outgoing_connections.label outgoing connections"
             print "incoming_connections.label incoming connections"
@@ -101,7 +101,7 @@ def main():
         if mode == "config":
             print "graph_title Prosody Client Presence"
             print "graph_vlabel clients"
-            print "graph_category Prosody"
+            print "graph_category chat"
 
             print "available.label Avaible Clients"
             print "chat.label Ready for Chat Clients"
@@ -129,7 +129,7 @@ def main():
             print "graph_args --base 1000 -l 0"
             print "graph_scale no"
             print "graph_vlabel uptime in days"
-            print "graph_category Prosody"
+            print "graph_category chat"
             print "graph_order uptime"
             print "uptime.draw AREA"
             print "uptime.min U"
@@ -153,7 +153,7 @@ def main():
         if mode == "config":
             print "graph_title Prosody Registered Users"
             print "graph_vlabel users"
-            print "graph_category Prosody"
+            print "graph_category chat"
 
         base_dir = os.environ.get('internal_storage_path', "/var/lib/prosody")
         if os.path.isdir(base_dir):
@@ -181,3 +181,99 @@ def listfiles(folder):
 
 if __name__ == '__main__':
     main()
+
+
+### Here starts the prosody_ plugin documentation, intended to be used with munindoc and in plugin gallery
+"""
+=head1 NAME
+
+prosody_ - Munin wildcard-plugin to monitor a L<Prosody|http://prosody.im> xmpp server.
+
+This wildcard plugin provides at the moment only the suffixes C<c2s>, C<s2s>, C<presence>, C<uptime> and C<users> suffixes.
+
+=head1 INSTALLATION
+
+It is very simple to install the plugin.
+
+=over 2
+
+    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
+
+=back
+
+After the installation you need to restart your munin-node:
+
+=over 2
+
+    service munin-node restart
+
+=back
+
+=head1 CONFIGURATION
+
+When you want to change the default host (localhost) and port (5582) do it in a file named prosody 
+placed in the directory /etc/munin/plugin-conf.d/ with a config like this:
+
+=over 2
+
+    [prosody_*]
+    env.host example.com
+    env.port 5582
+
+=back
+
+If you want to get the number of registered users, add the following lines to /etc/munin/plugin-conf.d/prosody:
+
+=over 2
+
+    [prosody_users]
+    user prosody
+    group prosody
+
+=back
+
+=head1 VERSION
+
+Version 2.2
+
+=head1 BUGS
+
+None known
+
+=head1 AUTHOR
+
+(C) 2010 Christoph Heer <Christoph.Heer@googlemail.com>
+
+=head1 LICENSE
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the \"Software\"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+
+
+=cut
+
+
+"""