Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/colinhoglund/puppet-nagios
Install/configure Nagios
https://github.com/colinhoglund/puppet-nagios
Last synced: 15 days ago
JSON representation
Install/configure Nagios
- Host: GitHub
- URL: https://github.com/colinhoglund/puppet-nagios
- Owner: colinhoglund
- Created: 2015-05-30T16:13:16.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2015-11-18T21:11:36.000Z (about 9 years ago)
- Last Synced: 2024-10-03T12:44:19.268Z (3 months ago)
- Language: Puppet
- Homepage:
- Size: 58.6 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# puppet-nagios
#### Table of Contents
1. [Overview](#overview)
2. [Module Description - What the module does and why it is useful](#module-description)
3. [Setup - The basics of getting started with nagios](#setup)
* [What nagios affects](#what-nagios-affects)
* [Setup requirements](#setup-requirements)
4. [Usage - Configuration options and additional functionality](#usage)
5. [Reference - An under-the-hood peek at what the module is doing and how](#reference)
5. [Limitations - OS compatibility, etc.](#limitations)
6. [Development - Guide for contributing to the module](#development)
## Overview
Installs and configures Nagios
## Module Description
This module automates the installation and configuration of the
core Nagios program. It is intended to be used in conjunction with modules
that manage a web server (Apache/nginx) and remote plugin execution (NRPE).
## Setup
### What nagios affects
* package/service/configuration files related to Nagios
* Nagios object definitions
### Setup Requirements
Although Nagios can run standalone, it is much more useful with a
web server (Apache/nginx/etc...) configured to serve Nagios' web frontend.
## Usage
Install Nagios with default object definitions:
```puppet
include nagios
```
Install Nagios without default configuration and define custom objects:
```puppet
class { 'nagios':
default_objects => false,
}
nagios::object::command { 'check_ssh':
command_line => '$USER1$/check_ssh $ARG1$ $HOSTADDRESS$',
}
#etc...
```
Note: The Nagios service will fail to start when installing with
'default_objects => false' until all object resources have been defined.
## Reference
###Classes
* nagios
###Defined Types
* nagios::object::command
* nagios::object::contact
* nagios::object::contactgroup
* nagios::object::host
* nagios::object::hostdependency
* nagios::object::hostescalation
* nagios::object::hostgroup
* nagios::object::service
* nagios::object::servicedependency
* nagios::object::serviceescalation
* nagios::object::servicegroup
* nagios::object::timeperiod
## Limitations
###Nagios Version Compatibility
* This has been tested with Nagios Core 3.5.1
###OS Compatibility
* CentOS
* Debian
* ...more to come
## Development
### Release Notes/Contributors/Etc
~~This module is in its early stages and will likely go though many revisions.~~
I have a new job and we don't use Puppet...sorry.
### Planned Updates
* ...
### Contributing
The idea behind this module is to simply install/configure the Nagios service. It was
a conscious decision to leave out "addons" such as NRPE. Any functionality
that doesn't directly affect the running state of the Nagios daemon belongs
in its own module.