Category Tree: Reduce number of categories

plugins/apt/deb_packages/deb_packages.py

@@ -500,7 +500,7 @@ class PackageStat(defaultdict):
                "multigraph {graphName}_{type}\n"\
                "graph_title {type} Debian packages sorted by {option}\n"\
                "graph_info {type} Debian packages sorted by {option} of its repository\n"\
-               "graph_category debian\n"\
+               "graph_category security\n"\
                "graph_vlabel packages".format(**d)
 
     def printConfig(self):
@@ -855,3 +855,111 @@ if __name__=='__main__':
     muninPlugin = Munin()
     muninPlugin.execute()
     # import IPython; IPython.embed()
+
+
+### The following is the smart_ plugin documentation, intended to be used with munindoc
+
+"""
+=head1 NAME
+
+deb_packages - plugin to monitor update resources and pending packages on Debian
+
+=head1 APPLICABLE SYSTEMS
+
+This plugin has checked on Debian - Wheezy and squeeze. If you want to use it
+on older installations, tell me whether it works or which errors you had. It
+shoud run past python-apt 0.7 and python 2.5.
+
+=head1 DESCRIPTION
+
+With this plugin munin can give you a nice graph and some details where your
+packages come from, how old or new your installation is. Furtermore it tells
+you how many updates you should have been installed, how many packages are
+outdated and where they come from.
+
+You can sort installed or upgradable Packages by 'archive', 'origin', 'site',
+'label' and 'component' and even some of them at once.
+
+The script uses caching cause it is quite expensive. It saves the output to a
+cachefile and checks on each run, if dpkg-status or downloaded Packagefile have
+changed. If one of them has changed, it runs, if not it gives you the cached
+version
+
+=head1 INSTALLATION
+
+check out this git repository from
+
+=over 2
+
+    aptitude install python-apt
+    git clone git://github.com/munin-monitoring/contrib.git
+    cd contrib/plugins/apt/deb_packages
+    sudo cp deb_packages.py /etc/munin/plugins/deb_packages
+    sudo cp deb_packages.munin-conf /etc/munin/plugin-conf.d/deb_packages
+
+=back
+
+Verify the installation by
+
+=over 2
+
+    sudo munin-run deb_packages
+
+=back
+
+
+=head1 CONFIGURATION
+
+If you copied deb_packages.munin-conf to plugin-conf.d you have a starting point.
+
+A typical configuration looks like this
+
+=over 2
+
+    [deb_packages]
+    # plugin is quite expensive and has to write statistics to cache output
+    # so it has to write to plugins.cache
+    user munin
+
+    # Packagelists to this size are printed as extra information to munin.extinfo
+    env.MAX_LIST_SIZE_EXT_INFO 50
+
+    # Age in seconds an $CACHE_FILE can be. If it is older, the script updates
+    # default if not set is 3540 (one hour)
+    # at the moment this is not used, the plugin always runs (if munin calls it)
+    #
+    env.CACHE_FILE_MAX_AGE 3540
+
+    # All these numbers are only for sorting, so you can use env.graph01_sort_by_0
+    # and env.graph01_sort_by_2 without using env.graph01_sort_by_1.
+    # sort_by values ...
+    # possible values are 'label', 'archive', 'origin', 'site', 'component'
+    env.graph00_type installed
+    env.graph00_sort_by_0 label
+    env.graph00_sort_by_1 archive
+    env.graph00_show_ext_0 origin
+    env.graph00_show_ext_1 site
+
+    env.graph01_type upgradable
+    env.graph01_sort_by_0 label
+    env.graph01_sort_by_1 archive
+    env.graph01_show_ext_0 origin
+    env.graph01_show_ext_1 site
+
+=back
+
+You can sort_by one or some of these possible Values
+
+
+=head1 AUTHOR
+
+unknown
+
+=head1 LICENSE
+
+Default for Munin contributions is GPLv2 (http://www.gnu.org/licenses/gpl-2.0.txt)
+
+=cut
+
+
+"""