ANSIBLE.NAGIOS(3)               ANSIBLE MODULES              ANSIBLE.NAGIOS(3)



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.

       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 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
       Tim Bielawa

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#nagios



0.9                               2012-11-30                 ANSIBLE.NAGIOS(3)
