nagios: update docs

This commit is contained in:
Alexei Znamensky 2025-07-28 20:45:00 +12:00
commit 3b755fead3

View file

@ -83,12 +83,14 @@ options:
description: description:
- What to manage downtime/alerts for. Separate multiple services with commas. - What to manage downtime/alerts for. Separate multiple services with commas.
- 'B(Required) option when O(action) is one of: V(downtime), V(acknowledge), V(forced_check), V(enable_alerts), V(disable_alerts).' - 'B(Required) option when O(action) is one of: V(downtime), V(acknowledge), V(forced_check), V(enable_alerts), V(disable_alerts).'
- You can specify multiple services at once by separating them with commas, for example O(services=httpd,nfs,puppet).
- When specifying what O(services) to handle there is a special service value, V(host), which handles alerts/downtime/acknowledge - When specifying what O(services) to handle there is a special service value, V(host), which handles alerts/downtime/acknowledge
for the I(host itself), for example O(services=host). This keyword may not be given with other services at the same for the I(host itself), for example O(services=host). This keyword may not be given with other services at the same
time. B(Setting alerts/downtime/acknowledge for a host does not affect alerts/downtime/acknowledge for any of the time. B(Setting alerts/downtime/acknowledge for a host does not affect alerts/downtime/acknowledge for any of the
services running on it.) To schedule downtime for all O(services) on particular host use keyword V(all), for example services running on it.) To schedule downtime for all O(services) on particular host use keyword V(all), for example
O(services=all). O(services=all).
- Before community.general 11.2.0, one could specify multiple services at once by separating them with commas, for example
O(services=httpd,nfs,puppet). Since community.general 11.2.0, there can be spaces around the commas, and an actual
list can be provided.
aliases: ["service"] aliases: ["service"]
type: list type: list
elements: str elements: str
@ -224,7 +226,9 @@ EXAMPLES = r"""
- name: Disable httpd and nfs alerts - name: Disable httpd and nfs alerts
community.general.nagios: community.general.nagios:
action: disable_alerts action: disable_alerts
service: httpd,nfs service:
- httpd
- nfs
host: '{{ inventory_hostname }}' host: '{{ inventory_hostname }}'
- name: Disable HOST alerts - name: Disable HOST alerts