munin-formula/README.rst

91 lines
3.3 KiB
ReStructuredText
Raw Normal View History

munin
=====
2014-11-28 10:30:32 -05:00
``munin`` is a monitoring application with a master/node architecture. The master periodically connects to each node and collects information from it. The nodes each run a ``munin-node`` service that listens for these connections.
2014-01-05 00:15:31 -05:00
2014-01-07 05:20:36 -05:00
.. note::
See the full `Salt Formulas installation and usage instructions
2014-07-28 19:59:51 -04:00
<http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_.
2014-01-07 05:20:36 -05:00
Available states
================
.. contents::
:local:
``munin.master``
2014-01-07 05:20:36 -05:00
----------------
Installs the munin master package.
The master runs as a cronjob, not a service. The distro packages normally automatically create those.
``munin.master.config``
-----------------------
Includes ``munin.master``.
Generates a config file for the munin master based on pillar data.
2015-11-28 23:50:33 -05:00
``munin.master.munin-cron``
-----------------------
Includes ``munin.master``.
Archlinux only. Enable munin-cron via a systemd timer.
``munin.node``
2014-01-07 05:20:36 -05:00
--------------
Installs the munin node package and enables the node service.
``munin.node.config``
---------------------
Includes ``munin.node``.
Generates a config file for the munin node based on pillar data.
2015-10-02 00:38:55 -04:00
``munin.node.plugins``
----------------------
Includes ``munin.node``.
Symlinks the desired plugins on the munin node based on pillar data.
``munin.tls``
2014-01-07 05:20:36 -05:00
-------------
Installs the Perl package Net::SSLEay so munin can use TLS.
2014-01-06 20:56:55 -05:00
2014-01-07 05:20:36 -05:00
Also, if the private key, certificate, or CA certificate are specified (as in ``pillar.example``), then the appropriate files are created. Note that it is up to the user to correctly specify the location of these files in their master and node config files.
Configuration
=============
2014-01-07 05:20:36 -05:00
The ``pillar.example`` has example pillar data for both the master and node, though ``munin.master.config`` only uses data from ``munin_master`` and ``munin.node.config`` only uses data from ``munin_node``.
Master Config
-------------
Consult http://munin-monitoring.org/wiki/munin.conf and ``man munin.conf`` for the full list of directives.
Node Config
-----------
Consult http://munin-monitoring.org/wiki/munin-node.conf and ``man munin-node.conf`` for the full list of directives.
For node configuration directives that allow repetition (ie: ``ignore_files``), make ``pillar['munin_node']['ignore_files']`` a list of values (see ``pillar.example`` for an example of this).
2014-01-06 20:56:55 -05:00
TLS
---
Consult http://munin-monitoring.org/wiki/MuninConfigurationNetworkTLS.
Instructions for the non-paraonid TLS setup:
1. Generate a private key. For this example, we create a 1024-bit key: ``openssl genrsa -out private.pem 1024``
#. Create a Certificate Signing Reqest: ``openssl req -new -key private.pem -out request.csr``
#. Generate a self-signed certificate: ``openssl x509 -req -in request.csr -signkey private.pem -out certificate.crt``
#. Inline the contents of ``private.pem`` into ``pillar['munin_tls']['private_key']``.
#. Inline the contents of ``certificate.crt`` into ``pillar['munin_tls']['certificate_pem']``.
#. Optional: delete the ``private.pem``, ``request.csr``, and ``certificate.crt`` files you generated. They aren't really needed now that you've inlined the important stuff into pillar.
#. Update your munin config to enable TLS and also to point to the salt-managed PEM files. The default paths where this salt formula puts the PEM files are specified in ``munin/map.jinja``