{"id":21400284,"url":"https://github.com/oefenweb/ansible-nagios-server","last_synced_at":"2025-07-13T21:31:17.420Z","repository":{"id":2846935,"uuid":"47616638","full_name":"Oefenweb/ansible-nagios-server","owner":"Oefenweb","description":"Ansible role to set up nagios in Debian-like systems (server side)","archived":false,"fork":false,"pushed_at":"2023-11-02T11:05:17.000Z","size":200,"stargazers_count":6,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-11-02T11:37:19.327Z","etag":null,"topics":["ansible","ansible-role","debian","monitoring","nagios","nagios-server","nagios3","ubuntu"],"latest_commit_sha":null,"homepage":"","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Oefenweb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-12-08T10:58:02.000Z","updated_at":"2023-01-15T06:45:33.000Z","dependencies_parsed_at":"2023-01-11T16:12:49.321Z","dependency_job_id":"f8bca31c-9c59-4b31-a7e3-804499cb8252","html_url":"https://github.com/Oefenweb/ansible-nagios-server","commit_stats":null,"previous_names":[],"tags_count":59,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oefenweb%2Fansible-nagios-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oefenweb%2Fansible-nagios-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oefenweb%2Fansible-nagios-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oefenweb%2Fansible-nagios-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Oefenweb","download_url":"https://codeload.github.com/Oefenweb/ansible-nagios-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225917771,"owners_count":17544947,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-role","debian","monitoring","nagios","nagios-server","nagios3","ubuntu"],"created_at":"2024-11-22T15:20:35.988Z","updated_at":"2024-11-22T15:20:36.544Z","avatar_url":"https://github.com/Oefenweb.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"## nagios-server\n\n[![CI](https://github.com/Oefenweb/ansible-nagios-server/workflows/CI/badge.svg)](https://github.com/Oefenweb/ansible-nagios-server/actions?query=workflow%3ACI)\n[![Ansible Galaxy](http://img.shields.io/badge/ansible--galaxy-nagios--server-blue.svg)](https://galaxy.ansible.com/Oefenweb/nagios_server)\n\nSet up nagios in Debian-like systems (server side).\n\n#### Requirements\n\nNone\n\n#### Variables\n\n* `nagios_server_private_keys`: [default: `[]`]: Private key declarations\n* `nagios_server_private_keys.{n}.owner`: [optional, default `nagios`]: The name of the user that should own the file\n* `nagios_server_private_keys.{n}.group`: [optional, default `owner`, `nagios`]: The name of the group that should own the file\n* `nagios_server_private_keys.{n}.mode`: [optional, default `0600`]: The UNIX permission mode bits of the file\n* `nagios_server_private_keys.{n}.src`: [required]: The local path of the key\n* `nagios_server_private_keys.{n}.dest`: [optional, default: default `src | basename`]: The remote path of the key (relative to `home/.ssh/`)\n* `nagios_server_private_keys.{n}.state`: [optional, default: `present`]: State\n\n* `nagios_server_htpasswd_users`: [default: `[]`]: User declarations\n* `nagios_server_htpasswd_users.{n}.name`: [required]: Username\n* `nagios_server_htpasswd_users.{n}.password`: [required]: Password\n\n* `nagios_server_htdigest_realm`: [optional, default `Nagios4`]: Apache2 digest authentication realm (Nagios 4 only)\n\n* `nagios_server_cgi`: [default: `{}`]: CGI declarations\n* `nagios_server_cgi.refresh_rate`: [optional, default: `90`]: Refresh rate\n* `nagios_server_cgi.result_limit`: [optional, default: `100`]: Default page limit\n\n* `nagios_server_user_macros`: [default: `{}`]: User macro declarations\n* `nagios_server_user_macros.key`: [required]: Identifier of the macro (1 through 32). Nagios supports up to 32 $USERx$ macros ($USER1$ through $USER32$)\n* `nagios_server_user_macros.key.value`: [default: `{}`]: Macro value\n\n* `nagios_server_contacts`: [default: `[]`]: Contact declarations\n* `nagios_server_contacts.{n}.name`: [required]: Contact name\n* `nagios_server_contacts.{n}.alias`: [required]: Contact alias\n* `nagios_server_contacts.{n}.service_notification_command`: [required]: Service notification command\n* `nagios_server_contacts.{n}.host_notification_command`: [required]: Host notification command\n* `nagios_server_contacts.{n}.email`: [optional]: Contact name\n\n* `nagios_server_contactgroups`: [default: `[]`]: Contactgroup declarations\n* `nagios_server_contactgroups.{n}.name`: [required]: Contactgroup name\n* `nagios_server_contactgroups.{n}.alias`: [required]: Contactgroup alias\n* `nagios_server_contactgroups.{n}.members`: [required]: List of contactgroup members\n\n* `nagios_server_host_templates`: [default: `[]`]: Host definition template\n* `nagios_server_host_templates.{n}.name`: [required]: The name of this host template\n* `nagios_server_host_templates.{n}.notifications_enabled`: [optional, default: `1`]: Host notifications are enabled\n* `nagios_server_host_templates.{n}.event_handler_enabled`: [optional, default: `1`]: Host event handler is enabled\n* `nagios_server_host_templates.{n}.flap_detection_enabled`: [optional, default: `1`]: Flap detection is enabled\n* `nagios_server_host_templates.{n}.failure_prediction_enabled`: [optional, default: `1`]: Failure prediction is enabled\n* `nagios_server_host_templates.{n}.process_perf_data`: [optional, default: `1`]: Process performance data\n* `nagios_server_host_templates.{n}.retain_status_information`: [optional, default: `1`]: Retain status information across program restarts\n* `nagios_server_host_templates.{n}.retain_nonstatus_information`: [optional, default: `1`]: Retain non-status information across program restarts\n* `nagios_server_host_templates.{n}.check_command`: [optional, default: `check-host-alive`]: Default check command\n* `nagios_server_host_templates.{n}.max_check_attempts`: [optional, default: `10`]: Maxium check attempts\n* `nagios_server_host_templates.{n}.notification_interval`: [optional, default: `0`]: Notification interval\n* `nagios_server_host_templates.{n}.notification_period`: [optional, default: `24x7`]: Notification period\n* `nagios_server_host_templates.{n}.notification_options`: [optional, default: `d,u,r`]: Notification options\n* `nagios_server_host_templates.{n}.contact_groups`: [optional, default: `admins`]: Default contact groups\n* `nagios_server_host_templates.{n}.register`: [optional, default: `0`]: Register host\n* `nagios_server_host_templates.{n}.variables`: [optional, default: `[]`]: List of optional host variables\n* `nagios_server_host_templates.{n}.variables.{n}.name`: [required]: The name of variable\n* `nagios_server_host_templates.{n}.variables.{n}.value`: [required]: The value of variable\n\n* `nagios_server_hostextinfo`: [default: `[]`]: Hostextinfo declarations (deprecated for nagios version 4 and up)\n* `nagios_server_hostextinfo.{n}.hostgroup`: [required]: Hostgroup name\n* `nagios_server_hostextinfo.{n}.notes`: [required]: Notes\n* `nagios_server_hostextinfo.{n}.icon_image`: [required]: Icon image\n* `nagios_server_hostextinfo.{n}.icon_image_alt`: [required]: Alternative text for icon image\n* `nagios_server_hostextinfo.{n}.vrml_image`: [required]: Vrml image\n* `nagios_server_hostextinfo.{n}.statusmap_image`: [required]: Statusmap image\n\n* `nagios_server_hostgroups`: [default: `[]`]: Hostgroup declarations\n* `nagios_server_hostgroups.{n}.name`: [required]: Hostgroup name\n* `nagios_server_hostgroups.{n}.alias`: [required]: Hostgroup alias\n* `nagios_server_hostgroups.{n}.members`: [required]: List of hostgroup members\n\n* `nagios_server_hosts`: [default: `[]`]: Host declarations\n* `nagios_server_hosts.{n}.host_template`: [optional, default: `generic-host`]: Host definition template\n* `nagios_server_hosts.{n}.name`: [required]: Hostname\n* `nagios_server_hosts.{n}.alias`: [required]: Host alias\n* `nagios_server_hosts.{n}.address`: [required]: Host address\n\n* `nagios_server_commands_custom`: [default: `[]`]: Custom command declarations\n* `nagios_server_commands_custom.{n}.name`: [required]: Name of command\n* `nagios_server_commands_custom.{n}.line`: [required]: Command line\n\n* `nagios_server_commands_notification`: [default: `[]`]: Notification command declarations\n* `nagios_server_commands_notification.{n}.name`: [required]: Name of command\n* `nagios_server_commands_notification.{n}.line`: [required]: Command line\n\n* `nagios_server_commands_performance_data`: [default: `[]`]: Performance data command declarations\n* `nagios_server_commands_performance_data.{n}.name`: [required]: Name of command\n* `nagios_server_commands_performance_data.{n}.line`: [required]: Command line\n\n* `nagios_server_generic_service`: [default: `{}`]: Generic service declarations\n* `nagios_server_generic_service.name`: [optional, default: `generic-service`]: The 'name' of this service template\n* `nagios_server_generic_service.active_checks_enabled`: [optional, default: `1`]: Active service checks are enabled\n* `nagios_server_generic_service.passive_checks_enabled`: [optional, default: `1`]: Passive service checks are enabled/accepted\n* `nagios_server_generic_service.parallelize_check`: [optional, default: `1`]: Active service checks should be parallelized (disabling this can lead to major performance problems)\n* `nagios_server_generic_service.obsess_over_service`: [optional, default: `1`]: We should obsess over this service (if necessary)\n* `nagios_server_generic_service.check_freshness`: [optional, default: `0`]: Default is to NOT check service 'freshness'\n* `nagios_server_generic_service.notifications_enabled`: [optional, default: `1`]: Service notifications are enabled\n* `nagios_server_generic_service.event_handler_enabled`: [optional, default: `1`]: Service event handler is enabled\n* `nagios_server_generic_service.flap_detection_enabled`: [optional, default: `1`]: Flap detection is enabled\n* `nagios_server_generic_service.failure_prediction_enabled`: [optional, default: `1`]: Failure prediction is enabled\n* `nagios_server_generic_service.process_perf_data`: [optional, default: `1`]: Process performance data\n* `nagios_server_generic_service.retain_status_information`: [optional, default: `1`]: Retain status information across program restarts\n* `nagios_server_generic_service.retain_nonstatus_information`: [optional, default: `1`]: Retain non-status information across program restarts\n* `nagios_server_generic_service.notification_interval`: [optional, default: `0`]: Only send notifications on status change by default.\n* `nagios_server_generic_service.is_volatile`: [optional, default: `0`]: This directive is used to denote whether the service is \"volatile\"\n* `nagios_server_generic_service.check_period`: [optional, default: `24x7`]: This directive is used to specify the short name of the time period during which active checks of this service can be made.\n* `nagios_server_generic_service.normal_check_interval`: [optional, default: `5`]:  The interval at which the service is checked under \"normal\" circumstances.\n* `nagios_server_generic_service.retry_check_interval`: [optional, default: `1`]:  The interval at which the service is checked during retries.\n* `nagios_server_generic_service.max_check_attempts`: [optional, default: `4`]: This directive is used to define the number of times that Nagios will retry the host check command if it returns any state other than an OK state.\n* `nagios_server_generic_service.notification_period`: [optional, default: `24x7`]: This directive is used to specify the short name of the time period during which notifications of events for this host can be sent out to contacts.\n* `nagios_server_generic_service.notification_options`: [optional, default: `w,u,c,r`]: This directive is used to determine when notifications for the host should be sent out.\n* `nagios_server_generic_service.contact_groups`: [optional, default: `admins`]: This is a list of the short names of the contact groups that should be notified whenever there are problems (or recoveries) with this service.\n* `nagios_server_generic_service.action_url`: [optional, default: undefined]: \tThis directive is used to define an optional URL that can be used to provide more actions to be performed on the service. (eg Displaying the nagiosgraph page).\n* `nagios_server_generic_service.register`: [optional, default: `0`]: DONT REGISTER THIS DEFINITION - ITS NOT A REAL SERVICE, JUST A TEMPLATE!\n\n* `nagios_server_services`: [default: `[]`]: Service declarations\n* `nagios_server_services.{n}.hostgroup`: [required]: Name of command\n* `nagios_server_services.{n}.description`: [required]: Command line\n* `nagios_server_services.{n}.check_command`: [required]: Command line\n\n* `nagios_server_timeperiods`: [default: `[]`]: Time period declarations\n* `nagios_server_timeperiods.{n}.name`: [required]: Name of time period\n* `nagios_server_timeperiods.{n}.alias`: [required]: Time period alias\n* `nagios_server_timeperiods.{n}.periods`: [default: `[]`]: Period intervals\n* `nagios_server_timeperiods.{n}.periods.key`: [required]: Day of the week (eg. monday)\n* `nagios_server_timeperiods.{n}.periods.key.value`: [required]: Time interval (eg. 08:00-23:00)\n\n* `nagios_server_check_external_commands`: [default: `false`]: If you want to be able to use the CGI command interface you will have to enable this\n* `nagios_server_use_regexp_matching`: [default: `false`]: This option determines whether or not various directives in your object definitions will be processed as regular expressions\n\n* `nagios_server_absent_paths`: [default: `[]`]: Paths to remove (e.g. `['/etc/nagios3/conf.d/web-01.example.com_nagios2.cfg']`)\n\n## Dependencies\n\nNone\n\n## Recommended\n\n* `nagios-client` ([see](https://github.com/Oefenweb/ansible-nagios-client))\n\n#### Example\n\n```yaml\n---\n- hosts: all\n  roles:\n    - oefenweb.nagios-server\n```\n\n#### License\n\nMIT\n\n#### Author Information\n\n* Mark van Driel\n* Mischa ter Smitten\n\n#### Feedback, bug-reports, requests, ...\n\nAre [welcome](https://github.com/Oefenweb/ansible-nagios-server/issues)!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foefenweb%2Fansible-nagios-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foefenweb%2Fansible-nagios-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foefenweb%2Fansible-nagios-server/lists"}