@@ -141,23 +145,48 @@ directories (filesystem permissions, selinux )
* manage cgi.cfg through
parameters
* manage nagios.cfg through parameters
-* manage nagios users
+* manage Nagios users
through external Puppet rules via define
-* configure NRPE on clients
-(optional)
+* manage Nagios commands through
+Puppet exports
+* manage Nagios template definitions through external Puppet
+rules via define
+* manage Nagios main contacts through Puppet exports.
+Additional contacts can be created through external Puppet rules via
+define, to avoid having to alter the module code.
+* manage Nagios main
+contactgroups through Puppet exports. Additional contact groups can be
+created through external Puppet rules via define, to avoid having to alter
+the module code.
+* manage Nagios main hostgroups through Puppet exports.
+Additional host groups can be created through external Puppet rules via
+define, to avoid having to alter the module code.
+* manage Nagios main
+servicegroups through Puppet exports. Additional service groups can be
+created through external Puppet rules via define, to avoid having to alter
+the module code.
+* manage Nagios main timeperiods through Puppet exports.
+Additional timeperiods can be created through external Puppet rules via
+define, to avoid having to alter the module code.
+* configure NRPE on
+clients (optional)
* configure firewall (optional)
-* configure selinux policies
-(optional)
-* configure forwarding http to https including accesing the
-/nagios url directly (optional)
-* manage TLS certificates through certbot
-(optional)
+* configure selinux
+policies (optional)
+* configure forwarding http to https including accesing
+the /nagios url directly (optional)
+* manage TLS certificates through
+certbot (optional)
Service
* manage Nagios service on server
* manage NRPE service on clients
(optional)
+
Monitoring
+* monitor Nagios host
+* monitor Nagios service
+
Repo Structure
Repostructure has moved to REPOSTRUCTURE.md in repo.
@@ -183,6 +212,14 @@ for selinux policy adjustments
cd_certbot
to auto-manage TLS certificates (optional)
@@ -278,6 +315,8 @@ on a regular web server with various other web instances (not recommended
through for performance reasons), we will not want to manage ssl.conf
directly, hence the module creates a vhost for the ssl host.
+
@@ -141,23 +145,48 @@ directories (filesystem permissions, selinux )
* manage cgi.cfg through
parameters
* manage nagios.cfg through parameters
-* manage nagios users
+* manage Nagios users
through external Puppet rules via define
-* configure NRPE on clients
-(optional)
+* manage Nagios commands through
+Puppet exports
+* manage Nagios template definitions through external Puppet
+rules via define
+* manage Nagios main contacts through Puppet exports.
+Additional contacts can be created through external Puppet rules via
+define, to avoid having to alter the module code.
+* manage Nagios main
+contactgroups through Puppet exports. Additional contact groups can be
+created through external Puppet rules via define, to avoid having to alter
+the module code.
+* manage Nagios main hostgroups through Puppet exports.
+Additional host groups can be created through external Puppet rules via
+define, to avoid having to alter the module code.
+* manage Nagios main
+servicegroups through Puppet exports. Additional service groups can be
+created through external Puppet rules via define, to avoid having to alter
+the module code.
+* manage Nagios main timeperiods through Puppet exports.
+Additional timeperiods can be created through external Puppet rules via
+define, to avoid having to alter the module code.
+* configure NRPE on
+clients (optional)
* configure firewall (optional)
-* configure selinux policies
-(optional)
-* configure forwarding http to https including accesing the
-/nagios url directly (optional)
-* manage TLS certificates through certbot
-(optional)
+* configure selinux
+policies (optional)
+* configure forwarding http to https including accesing
+the /nagios url directly (optional)
+* manage TLS certificates through
+certbot (optional)
Service
* manage Nagios service on server
* manage NRPE service on clients
(optional)
+
Monitoring
+* monitor Nagios host
+* monitor Nagios service
+
Repo Structure
Repostructure has moved to REPOSTRUCTURE.md in repo.
@@ -183,6 +212,14 @@ for selinux policy adjustments
cd_certbot
to auto-manage TLS certificates (optional)
@@ -278,6 +315,8 @@ on a regular web server with various other web instances (not recommended
through for performance reasons), we will not want to manage ssl.conf
directly, hence the module creates a vhost for the ssl host.
+
+ Class manages /etc/nagios/conf.d/nagios_add_contact.cfg through
+concat.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::add_contact_rules.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
+cd_nagios::nagios::objects::add_contact
+{ 'example_user':
+ ng_contact_name => 'example_user',
+
+ng_contact_alias => 'Example User',
+ ng_contact_groups =>
+'admins',
+ ng_contact_email => 'example@example.net',
+ }
+ Class manages /etc/nagios/conf.d/nagios_add_contactgroups.cfg file
+and populates through define and external puppet rules
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::add_contactgroups_rules.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
+ Class manages /etc/nagios_conf.d/nagios_hostgroups_add.cfg and
+additional hostgroups through external Puppet rules via define.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::add_hostgroup_rules.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
+ Class manages /etc/nagios_conf.d/nagios_servicegroups_add.cfg and
+additional servicegroups through external Puppet rules via define.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::add_servicegroup_rules.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
cd_nagios::nagios::objects::add_timeperiod_rules.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
+ Class manages all commands known to NAGIOS through Puppet exports,
+and populates /etc/nagios/conf.d/nagios_commands.cfg.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::commands.pp
+Module name: cd_nagios
+Author: Arne
+Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
+ Class manages the nagios objects definitions.
+
+
Overview
+
+
+
+
cd_nagios::server::nagios::objects::config.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/
+ Class manages basic contacts known to NAGIOS through Puppet exports,
+and populates /etc/nagios/conf.d/nagios_base_contacts.cfg.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::contacts.pp
+Module name: cd_nagios
+Author: Arne
+Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
+ Class manages /etc/nagios/conf.d/nagios_templates.cfg through
+concat.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::template_rules.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
Defined Type: cd_nagios::nagios::objects::add_contactgroups
+
+
+
Defined in:
+
+ manifests/nagios/objects/add_contactgroups.pp
+
+
+
+
+
Summary
+ Define populates /etc/nagios/conf.d/nagios_add_contactgroups through
+external puppet rules.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::add_contactgroups.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/
Defined Type: cd_nagios::nagios::objects::add_hostgroups
+
+
+
Defined in:
+
+ manifests/nagios/objects/add_hostgroups.pp
+
+
+
+
+
Summary
+ define populates /etc/nagios/conf.d/nagios_hostgroups_add through
+extermal Puppet rules.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::add_hostgroups.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/
Defined Type: cd_nagios::nagios::objects::add_servicegroups
+
+
+
Defined in:
+
+ manifests/nagios/objects/add_servicegroups.pp
+
+
+
+
+
Summary
+ define populates /etc/nagios/conf.d/nagios_servicegroups_add through
+extermal Puppet rules.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::add_servicegroups.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/
Defined Type: cd_nagios::nagios::objects::add_timeperiods
+
+
+
Defined in:
+
+ manifests/nagios/objects/add_timeperiods.pp
+
+
+
+
+
Summary
+ define populates /etc/nagios/conf.d/nagios_timeperiods_add through
+extermal Puppet rules.
+
+
Overview
+
+
+
+
cd_nagios::nagios::objects::add_timeperiods.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)
+
+
License:
+
+
This file is part of cd_nagios.
+
+
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/
cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.
+
+
This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.
+
+
You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see www.gnu.org/licenses/.
+notifications.
+for the defined service or host.
What service events to send
+out notifications for:
+w = notify on WARNING
+service states,
+u = notify on UNKNOWN service states,
+c = notify on
+CRITICAL service states,
+r = notify on service recoveries (OK states),
+f =
+notify when the service starts and stops flapping.
+n = none (the contact
+will not receive any type of service notifications).
What host events to send
+out notifications for:
+d = notify on DOWN host
+states,
+u = notify on UNREACHABLE host states,
+r = notify on host
+recoveries (UP states),
+f = notify when the host starts and stops
+flapping,
+s = notify when host or service scheduled downtime starts and
+ends.
+n = none (the contact will not receive any type of host
+notifications).