|
|
@ -58,21 +58,20 @@ the host the playbook is currently running on.
|
|
|
|
You can specify multiple services at once by separating them with
|
|
|
|
You can specify multiple services at once by separating them with
|
|
|
|
commas, .e.g., ``services=httpd,nfs,puppet``.
|
|
|
|
commas, .e.g., ``services=httpd,nfs,puppet``.
|
|
|
|
|
|
|
|
|
|
|
|
When specifying what service to handle there is a special keyword,
|
|
|
|
When specifying what service to handle there is a special service value,
|
|
|
|
**host**, which will handle alerts/downtime for the **host itself**,
|
|
|
|
**host**, which will handle alerts/downtime for the **host itself**,
|
|
|
|
e.g., ``service=host``. This keyword may *not* be given with other
|
|
|
|
e.g., ``service=host``. This keyword may *not* be given with other
|
|
|
|
services at the same time. *Handling alerts/downtime for a host does
|
|
|
|
services at the same time. *Handling alerts/downtime for a host does
|
|
|
|
not affect alerts/downtime for any of the services running on it.*
|
|
|
|
not affect alerts/downtime for any of the services running on it.*
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Examples from :doc:`playbooks`::
|
|
|
|
Examples of Scheduling Downtime in :doc:`playbooks`::
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
---
|
|
|
|
- hosts: webservers
|
|
|
|
- hosts: webservers
|
|
|
|
user: root
|
|
|
|
user: root
|
|
|
|
tasks:
|
|
|
|
tasks:
|
|
|
|
- name: set 30 minutes of apache downtime
|
|
|
|
- name: set 30 minutes of apache downtime
|
|
|
|
action: nagios action=downtime minutes=15 service=httpd host=$inventory_hostname
|
|
|
|
action: nagios action=downtime minutes=30 service=httpd host=$inventory_hostname
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
|
|
|
|
|
|
|
|
- name: schedule an hour of HOST downtime
|
|
|
|
- name: schedule an hour of HOST downtime
|
|
|
@ -85,48 +84,20 @@ Examples of Scheduling Downtime in :doc:`playbooks`::
|
|
|
|
action: nagios action=downtime services=frob,foobar,qeuz host=$inventory_hostname
|
|
|
|
action: nagios action=downtime services=frob,foobar,qeuz host=$inventory_hostname
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
|
|
|
|
|
|
|
|
And from the command line:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
$ ansible nagios.example.com -m nagios -a "action=downtime minutes=15 service=httpd host=server01.example.com"
|
|
|
|
|
|
|
|
$ ansible nagios.example.com -m nagios -a "action=downtime minutes=60 service=host host=server01.example.com"
|
|
|
|
|
|
|
|
$ ansible nagios.example.com -m nagios -a "action=downtime services=frob,foobar,qeuz host=server01.example.com"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Examples of handling specific host/service alerts in :doc:`playbooks`::
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
- hosts: webservers
|
|
|
|
|
|
|
|
user: root
|
|
|
|
|
|
|
|
tasks:
|
|
|
|
|
|
|
|
- name: enable SMART disk alerts
|
|
|
|
- name: enable SMART disk alerts
|
|
|
|
action: nagios action=enable_alerts service=smart host=$inventory_hostname
|
|
|
|
action: nagios action=enable_alerts service=smart host=$inventory_hostname
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
|
|
|
|
|
|
|
|
# Note that you can disable multiple at once
|
|
|
|
# you can disable multiple at once
|
|
|
|
- name: disable httpd alerts
|
|
|
|
- name: disable httpd alerts
|
|
|
|
action: nagios action=disable_alerts service=httpd,nfs host=$inventory_hostname
|
|
|
|
action: nagios action=disable_alerts service=httpd,nfs host=$inventory_hostname
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
|
|
|
|
|
|
|
|
# And disabling HOST alerts
|
|
|
|
# host alerts must be disabled as a seperate action
|
|
|
|
- name: disable HOST alerts
|
|
|
|
- name: disable HOST alerts
|
|
|
|
action: nagios action=disable_alerts service=host host=$inventory_hostname
|
|
|
|
action: nagios action=disable_alerts service=host host=$inventory_hostname
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
|
|
|
|
|
|
|
|
And from the command line:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
$ ansible nagios.example.com -m nagios -a "action=enable_alerts service=smart host=server01.example.com"
|
|
|
|
|
|
|
|
$ ansible nagios.example.com -m nagios -a "action=disable_alerts service=httpd,nfs host=server01.example.com"
|
|
|
|
|
|
|
|
$ ansible nagios.example.com -m nagios -a "action=disable_alerts service=host host=server01.example.com"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Examples of Silencing all host/service alerts in :doc:`playbooks`::
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
- hosts: webservers
|
|
|
|
|
|
|
|
user: root
|
|
|
|
|
|
|
|
tasks:
|
|
|
|
|
|
|
|
- name: silence ALL alerts
|
|
|
|
- name: silence ALL alerts
|
|
|
|
action: nagios action=silence host=$inventory_hostname
|
|
|
|
action: nagios action=silence host=$inventory_hostname
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
delegate_to: nagios.example.com
|
|
|
@ -135,14 +106,6 @@ Examples of Silencing all host/service alerts in :doc:`playbooks`::
|
|
|
|
action: nagios action=unsilence host=$inventory_hostname
|
|
|
|
action: nagios action=unsilence host=$inventory_hostname
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
delegate_to: nagios.example.com
|
|
|
|
|
|
|
|
|
|
|
|
And from the command line:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
$ ansible nagios.example.com -m nagios -a "action=silence host=server01.example.com"
|
|
|
|
|
|
|
|
$ ansible nagios.example.com -m nagios -a "action=unsilence host=server01.example.com"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**Optional Configuration**
|
|
|
|
**Optional Configuration**
|
|
|
|
|
|
|
|
|
|
|
|
If your nagios **cmdfile** is not ``/var/spool/nagios/cmd/nagios.cmd``
|
|
|
|
If your nagios **cmdfile** is not ``/var/spool/nagios/cmd/nagios.cmd``
|
|
|
|