ansible-nagios

Ansible Playbook for setting up the Nagios monitoring system and clients on CentOS/RHEL.

What does it do?

Automated deployment of Nagios on CentOS or RHEL
- Generates service checks, and monitored hosts from Ansible inventory
- Generates comprehensive checks for the Nagios server
- Generates comprehensive checks for all hosts/services via NRPE
- Generates most of the other configs based on jinja2 templates
- Wraps Nagios in SSL via Apache
- Sets up proper firewall rules (firewalld or iptables-services)

Requirements

RHEL7 or CentOS7+ for Nagios server.

Notes

Sets the nagiosadmin password to changeme, you'll want to change this.
Creates a read-only user, set nagios_create_guest_user: false to disable this in install/group_vars/all.yml
Implementation is very simple, with only the following server types generated right now:
- out-of-band interfaces (ping, ssh, http)
- generic servers (ping, ssh, load, users, procs, uptime, disk space)
- ELK servers (same as servers plus elasticsearch and Kibana)
- elasticsearch (same as servers plus TCP/9200 for elasticsearch)
- webservers (http, ping, ssh, load, users, procs, uptime, disk space)
- network switches (ping, ssh)
contacts.cfg notification settings are in install/group_vars/all.yml and templated for easy modification.
Adding new hosts to inventory file will just regenerate the Nagios configs

Nagios Server Instructions

Clone repo and setup your Ansible inventory (hosts) file

git clone https://github.com/sadsfae/ansible-nagios
cd ansible-nagios
sed -i 's/host-01/yournagioshost/' hosts

Add any hosts for checks in the hosts inventory
Note that you need to add ansible_host entries for IP addresses for switches, out-of-band interfaces and anything that typically doesn't support Python and Ansible fact discovery.

[webservers]
webserver01

[switches]
switch01 ansible_host=192.168.0.100
switch02 ansible_host=192.168.0.102

[oobservers]
webserver01-idrac ansible_host=192.168.0.105

[servers]
server01

Run the playbook

ansible-playbook -i hosts install/nagios.yml

Navigate to the server at https://yourhost/nagios
Default login is nagiosadmin / changeme unless you changed it in install/group_vars/all.yml

Demonstration

You can view a video of the Ansible deployment here:

Files

├── hosts
└── install
    ├── group_vars
    │   └── all.yml
    ├── nagios.retry
    ├── nagios.yml
    └── roles
        ├── nagios
        │   ├── files
        │   │   ├── localhost.cfg
        │   │   ├── nagios.cfg
        │   │   ├── nagios.conf
        │   │   └── services.cfg
        │   ├── tasks
        │   │   └── main.yml
        │   └── templates
        │       ├── cgi.cfg.j2
        │       ├── commands.cfg.j2
        │       ├── contacts.cfg.j2
        │       ├── oobservers.cfg.j2
        │       ├── servers.cfg.j2
        │       ├── switches.cfg.j2
        │       └── webservers.cfg.j2
        └── nagios-client
            ├── tasks
            │   └── main.yml
            └── templates
                └── nrpe.cfg.j2

10 directories, 18 files

atosorigin/ansible-nagios

ansible-nagios