Forge Home

monit

Install and configure monit

9,904 downloads

9,730 latest version

1.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.1.1 (latest)
  • 0.1.0
released Aug 24th 2014

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'tompurl-monit', '0.1.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add tompurl-monit
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install tompurl-monit --version 0.1.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

tompurl/monit — version 0.1.1 Aug 24th 2014

Monit Puppet Module

Very simple module for installing and configuring monit.

Quick Start

Download the module and put it in your "modules" folder:

$ git clone tom@git@github.com:tompurl/puppet-monit.git

Add this to your manifest:

class { 'monit': 
  alert_address  => "foo@baz.com",
  smtp_host      => "smtp.mandrillapp.com",
  smtp_port      => 587,
  smtp_user_name => "foo@baz.com",
  smtp_password  => "thisIsReallyClever",
}

Visit the page with a console-based web browser (like elinks) from the local server console:

$ elinks http://localhost:2812
# username => admin, pass => monit    

You can change the username and password by setting the following parameters:

  • web_username
  • web_password

Overview

This is a very simple module that simply installs monit with a lightweight config file. Any additional configuration information should be placed in files that are stored in one of the following directories:

  • /etc/monit/conf.d
  • /etc/monit/monitrc.d #Seems to be preferred on Debian

Why Do I Need An Email Address?

The main way that monit communicates with you is by email. I recommend mandrill as a good, simple SMTP service.

Tested Platforms

Debian 7 on x64 and Raspbian. No effort has yet been made to make it work with anything else.

monit class parameters

Parameter Type Default Description
alert_address string none The address to which monit will send notifications
smtp_host string none The host names for your SMTP server
smtp_port int none Duh :)
smtp_user_name string none The username for your SMTP account
smtp_password string none The password associated with the $smtp_user_name value
web_username string admin The username that you want to use to log into monitweb
web_password string monit The password that you want to use with monitweb