Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/phlipper/chef-monit

Chef cookbook for monit package
https://github.com/phlipper/chef-monit
Last synced: 3 months ago
JSON representation
Chef cookbook for monit package
Host: GitHub
URL: https://github.com/phlipper/chef-monit
Owner: phlipper
License: mit
Archived: true
Created: 2011-06-09T10:21:16.000Z (over 13 years ago)
Default Branch: master
Last Pushed: 2017-06-27T15:19:02.000Z (over 7 years ago)
Last Synced: 2024-07-01T15:20:00.127Z (4 months ago)
Language: Ruby
Homepage: http://phlippers.net/chef-monit
Size: 846 KB
Stars: 67
Watchers: 6
Forks: 69
Open Issues: 12
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project

awesome-chef - monit - [Monit](https://mmonit.com/monit/) (Cookbooks / Logging/Monitoring)
README

        # chef-monit  [![Build Status](http://img.shields.io/travis-ci/phlipper/chef-monit.png)](http://travis-ci.org/phlipper/chef-monit)

## Description

Installs the `monit` package from (http://mmonit.com/monit/).

## Requirements

### Supported Platforms

The following platforms are supported by this cookbook, meaning that the recipes run on these platforms without error:

* Ubuntu 12.04, 14.04

* Debian 7.8, 8.0

* RedHat

* CentOS 6.6, 7.1

* Scientific

* Fedora 21

* SUSE

* Amazon

## Recipes

* `monit` - The default recipe. Sets up the service definition and default checks.

## Resources

### `monit_monitrc`

The following will create a monitrc configuration:

```ruby

monit_monitrc "ssh" do

  variables({ category: "system" })

end

```

The `name` parameter must match a file located in your templates directory. In the example above, this would be `ssh.monitrc.erb`.

The `variables` option within the block is optional, and can contain a list of key-value pairs to assign within your template.

## Usage

This cookbook installs the monit components if not present, and pulls updates if they are installed on the system.

## Attributes

```ruby

# Delay the start of polling when the service is started

default["monit"]["start_delay"] = 0

# How frequently the monit daemon polls for changes.

default["monit"]["polling_frequency"] = 20

# Where Monit stores the pid file

default["monit"]["pidfile"] = "/var/run/monit.pid"

# Use syslog for logging instead of a logfile.

default["monit"]["use_syslog"] = true

# If not using syslog, the log file that monit will use.

default["monit"]["logfile"] = "/var/log/monit.log"

# Where Monit stores unique Monit instance id

default["monit"]["idfile"] = "/var/.monit.id"

# Where Monit stores Monit state file

default["monit"]["statefile"] = "/var/lib/monit/state"

# Enable emails for internal monit alerts

default["monit"]["mail_alerts"] = true

# Possible events include: action, checksum, connection, content, data, exec, fsflags, gid, icmp, instance, invalid, nonexist, permission, pid, ppid, resource, size, status, timeout, timestamp, uid, uptime.

# Only alert on specific events

default["monit"]["alert_onlyif_events"] = []

# Ignore alerts for specific events

default["monit"]["alert_ignore_events"] = []

# Email address that will be notified of events.

default["monit"]["alert_email"] = "root@localhost"

# Enable the web interface and define credentials.

default["monit"]["web_interface"] = {

  enable:  true,

  port:    2812,

  address: "localhost",

  allow:   ["localhost", "admin:b1gbr0th3r"]

}

# Email settings that will be used for notification of events.

default["monit"]["mail"] = {

  hostname: "localhost",

  port:     25,

  username: nil,

  password: nil,

  encrypted_credentials: nil,

  encrypted_credentials_data_bag: "credentials",

  from:     "monit@$HOST",

  subject:  "$SERVICE $EVENT at $DATE",

  message:  "Monit $ACTION $SERVICE at $DATE on $HOST,\n\n$DESCRIPTION\n\nDutifully,\nMonit",

  security: nil,  # 'SSLV2'|'SSLV3'|'TLSV1'

  timeout:  30,

  using_hostname: nil

}

case node["platform_family"]

when "rhel", "fedora", "suse"

  default["monit"]["main_config_path"] = "/etc/monit.conf"

  default["monit"]["includes_dir"] = "/etc/monit.d"

else

  default["monit"]["main_config_path"] = "/etc/monit/monitrc"

  default["monit"]["includes_dir"] = "/etc/monit/conf.d"

end

# The monit::default recipe will load these monit_monitrc resources automatically

# NOTE setting this attribute at the default level will append values to the array

default["monit"]["default_monitrc_configs"] = %w[load ssh]

# Whether the monit service should be reloaded when a configuration changes

default["monit"]["reload_on_change"] = true

# `MONIT_OPTS` for /etc/default/monit

default["monit"]["init_opts"] = ""

# specify a particular version of the monit package you want installed,

# otherwise it will install the default. this value is ignored when performing a

# source install.

default["monit"]["version"] = nil

# source install specifics

default["monit"]["source_install"] = false

default["monit"]["source_uninstall"] = false

default["monit"]["source"]["version"] = "5.12.2"

default["monit"]["source"]["prefix"] = "/usr/local"

default["monit"]["source"]["url"] = "https://mmonit.com/monit/dist/monit-#{node["monit"]["source"]["version"]}.tar.gz"

default["monit"]["source"]["checksum"] = "8ab0296d1aa2351b1573481592d7b5e06de1edd49dff1b5552839605a450914c"

default["monit"]["source"]["pam_support"] = true

default["monit"]["source"]["ssl_support"] = true

default["monit"]["source"]["large_file_support"] = true

default["monit"]["source"]["compiler_optimized"] = true

# binary install specifics

default["monit"]["binary_install"] = false

default["monit"]["binary_uninstall"] = false

default["monit"]["binary"]["version"] = "5.12.2"

default["monit"]["binary"]["prefix"] = "/usr"

default["monit"]["binary"]["url"] = "http://mmonit.com/monit/dist/binary/#{node["monit"]["binary"]["version"]}/monit-#{node["monit"]["binary"]["version"]}-linux-x64.tar.gz"

default["monit"]["binary"]["checksum"] = "4908143752d0ee5081a50389a9206b7c905f9f8922a062a208fecf6e729a3c77"

```

## Contributors

Many thanks go to the following [contributors](https://github.com/phlipper/chef-monit/graphs/contributors) who have helped to make this cookbook even better:

* **[@werdan](https://github.com/werdan)**

    * add support for redhat-flavored systems

* **[@auser](https://github.com/auser)**

    * add missing metadata

* **[@arrowcircle](https://github.com/arrowcircle)**

    * update syntax to be Ruby 1.8-compatible

* **[@dwradcliffe](https://github.com/dwradcliffe)**

    * typo fix for README

    * fix logging logic

    * whyrun support for monitrc provider

    * support for reloading monit without restart

    * don't render 'use address' if no address is provided

    * fix attribute comments

* **[@tjwallace](https://github.com/tjwallace)**

    * load default monitrc configs from an attribute

* **[@tomdz](https://github.com/tomdz)**

    * Ruby 1.8.x compatibility fix

    * add support for templates in different cookbooks

* **[@alexism](https://github.com/alexism)**

    * support other security protocols

* **[@fixlr](https://github.com/fixlr)**

    * add `mail_alerts` attribute

* **[@darron](https://github.com/darron)**

    * add descriptions to email notifications

* **[@claco](https://github.com/claco)**

    * add startup delay option to monit daemon config

    * restart on default monitrc configs change

    * restart monit service if the monit config changes

    * fix platform family logic

* **[@maciejgalkiewicz](https://github.com/maciejgalkiewicz)**

    * fix logging logic

* **[@pauloricardomg](https://github.com/pauloricardomg)**

    * add `alert_ignore_events` attribute

    * add `reload_on_change` attribute

* **[@drywheat](https://github.com/drywheat)**

    * support encrypted data bag for smtp credentials

    * add support for installation from source vs. package

* **[@esigler](https://github.com/esigler)**

    * allow either style of monit startup flag to work

* **[@evan2645](https://github.com/evan2645)**

    * fix bug in which monit is not started during bootstrap

* **[@mvdkleijn](https://github.com/mvdkleijn)**

    * add settings for idfile and statefile

* **[@mbanton](https://github.com/mbanton)**

    * fix `statefile` attribute in `monitrc` template

* **[@foxycoder](https://github.com/foxycoder)**

    * add support for binary install

* **[@ijin](https://github.com/ijin)**

    * add `using_hostname` attribute

    * better ssh support for Amazon Linux

* **[@rickhull](https://github.com/rickhull)**

    * update to use latest monit versions

    * add proper rhel-family support with init script template

* **[@dougbarth](https://github.com/dougbarth)**

    * fix lwrp `updated_by_last_action`

* **[@fulloflilies](https://github.com/fulloflilies)**

    * fix converge error caused by overwriting running binary file

## Contributing

1. Fork it

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Commit your changes (`git commit -am 'Added some feature'`)

4. Push to the branch (`git push origin my-new-feature`)

5. Create new Pull Request

## License

**chef-monit**

* Freely distributable and licensed under the [MIT license](http://phlipper.mit-license.org/2011-2015/license.html).

* Copyright (c) 2011-2015 Phil Cohen ([email protected]) [![endorse](http://api.coderwall.com/phlipper/endorsecount.png)](http://coderwall.com/phlipper)  [![Gittip](http://img.shields.io/gittip/phlipper.png)](https://www.gittip.com/phlipper/)

* http://phlippers.net/