79 lines
No EOL
2.7 KiB
Groff
79 lines
No EOL
2.7 KiB
Groff
.TH ANSIBLE.NAGIOS 5 "2012-10-03" "0.8" "ANSIBLE MODULES"
|
|
." generated from library/nagios
|
|
.SH NAME
|
|
nagios \- Perform common tasks in Nagios related to downtime and notifications.
|
|
." ------ DESCRIPTION
|
|
.SH DESCRIPTION
|
|
.PP
|
|
The \fInagios\fR module has two basic functions: scheduling downtime and toggling alerts for services or hosts.
|
|
.PP
|
|
All actions require the \fChost\fR parameter to be given explicitly. In playbooks you can use the \fC$inventory_hostname\fR variable to refer to the host the playbook is currently running on.
|
|
.PP
|
|
You can specify multiple services at once by separating them with commas, .e.g., \fCservices=httpd,nfs,puppet\fR.
|
|
.PP
|
|
When specifying what service to handle there is a special service value, \fIhost\fR, which will handle alerts/downtime for the \fIhost itself\fR, e.g., \fCservice=host\fR. This keyword may not be given with other services at the same time. \fISetting alerts/downtime for a host does not affect alerts/downtime for any of the services running on it.\fR
|
|
.PP
|
|
When using the \fInagios\fR module you will need to specify your nagios server using the \fCdelegate_to\fR parameter.
|
|
." ------ OPTIONS
|
|
."
|
|
."
|
|
.SH OPTIONS
|
|
|
|
.IP action
|
|
Action to take.
|
|
.IR Choices :
|
|
downtime,enable_alerts,disable_alerts,silence,unsilence.(required)
|
|
.IP host
|
|
Host to operate on in Nagios.(required)
|
|
.IP author
|
|
Author to leave downtime comments as. - Only useable with the \fCdowntime\fR action. (default: Ansible)
|
|
.IP services
|
|
What to manage downtime/alerts for. Separate multiple services with commas.\fCservice\fR is an alias for \fCservices\fR.\fBRequired\fR option when using the \fCdowntime\fR, \fCenable_alerts\fR, and \fCdisable_alerts\fR actions.(required)
|
|
.IP minutes
|
|
Minutes to schedule downtime for.Only useable with the \fCdowntime\fR action. (default: 30)
|
|
.IP cmdfile
|
|
Path to the nagios \fIcommand file\fR (FIFO pipe).Only required if auto-detection fails. (default: auto-detected)."
|
|
."
|
|
." ------ NOTES
|
|
."
|
|
."
|
|
." ------ EXAMPLES
|
|
.SH EXAMPLES
|
|
.PP
|
|
.nf
|
|
nagios action=downtime minutes=30 service=httpd host=$inventory_hostname
|
|
.fi
|
|
.PP
|
|
.nf
|
|
nagios action=downtime minutes=60 service=host host=$inventory_hostname
|
|
.fi
|
|
.PP
|
|
.nf
|
|
nagios action=downtime services=frob,foobar,qeuz host=$inventory_hostname
|
|
.fi
|
|
.PP
|
|
.nf
|
|
nagios action=enable_alerts service=smart host=$inventory_hostname
|
|
.fi
|
|
.PP
|
|
.nf
|
|
nagios action=disable_alerts service=httpd,nfs host=$inventory_hostname
|
|
.fi
|
|
.PP
|
|
.nf
|
|
nagios action=disable_alerts service=host host=$inventory_hostname
|
|
.fi
|
|
.PP
|
|
.nf
|
|
nagios action=silence host=$inventory_hostname
|
|
.fi
|
|
.PP
|
|
.nf
|
|
nagios action=unsilence host=$inventory_hostname
|
|
.fi
|
|
." ------- AUTHOR
|
|
.SH AUTHOR
|
|
Tim Bielawa
|
|
.SH SEE ALSO
|
|
.IR ansible (1),
|
|
.I http://ansible.github.com/modules.html#nagios |