monit

Install and configure monit

Tom Purl

tompurl

8,739 downloads

8,628 latest version

1.6 quality score

Version information

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

Start using this module

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