ansible.nagios(3) - Linux man page

Name

nagios - Perform common tasks in Nagios related to downtime and notifications.

Description

The nagios module has two basic functions: scheduling downtime and toggling alerts for services or hosts.

All actions require the host parameter to be given explicitly. In playbooks you can use the $inventory_hostname variable to refer to the host the playbook is currently running on.

You can specify multiple services at once by separating them with commas, .e.g., services=httpd,nfs,puppet.

When specifying what service to handle there is a special service value, host, which will handle alerts/downtime for the host itself, e.g., service=host. This keyword may not be given with other services at the same time. Setting alerts/downtime for a host does not affect alerts/downtime for any of the services running on it. To schedule downtime for all services on particular host use keyword "all", e.g., service=all.

When using the nagios module you will need to specify your Nagios server using the delegate_to parameter.

Options

action
Action to take. Choices:
downtime,enable_alerts,disable_alerts,silence,unsilence.(required)
author Author to leave downtime comments as. - Only usable with the downtime action. (default: Ansible)
cmdfile: Path to the nagios command file (FIFO pipe).Only required if auto-detection fails. (default: auto-detected)
host Host to operate on in Nagios.(required)
minutes: Minutes to schedule downtime for.Only usable with the downtime action. (default: 30)
services: What to manage downtime/alerts for. Separate multiple services with commas.service is an alias for services.Required option when using the downtime, enable_alerts, and disable_alerts actions.(required)."

Examples

set 30 minutes of apache downtime

nagios: action=downtime minutes=30 service=httpd host=$inventory_hostname

schedule an hour of HOST downtime

nagios: action=downtime minutes=60 service=host host=$inventory_hostname

schedule downtime for ALL services on HOST

nagios: action=downtime minutes=45 service=all host=$inventory_hostname

schedule downtime for a few services

nagios: action=downtime services=frob,foobar,qeuz host=$inventory_hostname

enable SMART disk alerts

nagios: action=enable_alerts service=smart host=$inventory_hostname

two services at once: disable httpd and nfs alerts

nagios: action=disable_alerts service=httpd,nfs host=$inventory_hostname

disable HOST alerts

nagios: action=disable_alerts service=host host=$inventory_hostname

silence ALL alerts

nagios: action=silence host=$inventory_hostname

unsilence all alerts

nagios: action=unsilence host=$inventory_hostname

Author